> ## Documentation Index
> Fetch the complete documentation index at: https://79cdaa32-9b19-4e9d-ab9d-a89800ef0f46.valox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration models : Permissionless vs Partnerships

> Valox offers two ways of integrating Valox APIs. Whether you’re building as a developer or looking to launch a whitelisted branded solution, Valox is designed to be flexible and accessible for all developers and businesses.

## Integration Models: Permissionless vs Partnerships

Valox offers two ways to get started:

1. Permissionless Integration
2. Partnership Integration

***

## 1. Permissionless Integration (Free Plan Only)

Developers can start building with our APIs right away—no need to contact us or go through an approval process. This lets you quickly enable crypto payments, card issuance, and account features for your users.

<img src="https://mintcdn.com/valox/AgcB3RGA51tPCf1o/static/img/API%20Flows_permissionless.png?fit=max&auto=format&n=AgcB3RGA51tPCf1o&q=85&s=f641c0bedd7505b310bcd6b661a9ddce" alt="Permissionless API Flow - Start building and testing with Valox APIs" className="rounded-lg shadow-lg" width="2892" height="1323" data-path="static/img/API Flows_permissionless.png" />

<Info>
  This integration requires no special credentials. Simply authenticate with our APIs using SIWE (Sign-In with Ethereum) to receive a JWT token and start building.
</Info>

**Who it's for:** Developers or small teams who want to explore the APIs, prototype, or run very lightweight programs.

<CardGroup cols={2}>
  <Card title="What You Can Do" icon="check" color="#16a34a">
    * ✅ Make API calls immediately — no API keys, approvals, or contracts
    * ✅ Issue and manage Valox-branded cards for testing and early users
    * ✅ Experiment with basic functionality (card issuance, transactions, balance queries)
  </Card>

  <Card title="What You Can't Do" icon="x" color="#dc2626">
    * ❌ Attribute card activity back to your business (no webhooks, no tracking)
    * ❌ Display sensitive card details (requires Partner Secure Element)
    * ❌ Launch a branded card program at scale
  </Card>
</CardGroup>

<Card title="🚀 When to Move On" icon="arrow-right" color="#2563eb">
  Once you want to connect card activity to your app/business or expose sensitive card details, you'll need to switch into Partnership mode.
</Card>

***

## 2. Partnership Integration (Free, Startup, and Enterprise)

If your company is interested in deeper collaboration—such as branded cards, custom user experiences, fee rebates, or co-marketing opportunities — [you can apply to become a Valox partner](https://form.typeform.com/to/naN3irHW?typeform-source=valox.co).

<img src="https://mintcdn.com/valox/AgcB3RGA51tPCf1o/static/img/API%20Flows_partnership.png?fit=max&auto=format&n=AgcB3RGA51tPCf1o&q=85&s=b349073e708f07437979ea0a9b072a62" alt="Partnership API Flow - Start building and testing with Valox APIs" className="rounded-lg shadow-lg" width="4631" height="1644" data-path="static/img/API Flows_partnership.png" />

**Who it's for:** Any partner ready to move beyond experimentation and operate a live program.

<CardGroup cols={2}>
  <Card title="Key Credentials" icon="key" color="#7c3aed" href="/integration-model#getting-your-partnerid-and-app-id">
    * **Partner ID** → Required for webhooks, attribution, and tracking

    * **App ID** → Required for Partner Secure Element (PSE) access
  </Card>

  <Card title="Advanced Features" icon="star" color="#ea580c">
    * Branded cards and custom experiences
    * Multi-market support
    * BIN sponsorship
    * Compliance oversight
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Dedicated Support" icon="headset" color="#059669">
    Direct access to Valox team for technical guidance and business support.
  </Card>

  <Card title="Full Observability" icon="chart-bar" color="#2563eb">
    Complete integration into your systems with webhooks and analytics.
  </Card>
</CardGroup>

**Mandatory for:** Startup and Enterprise plans, but also available to Free Plan partners who want to extend beyond pure experimentation.

## **Getting Your PartnerID and APP\_ID**

Once your partnership application is approved, our team will provide you with:

* **PartnerID**: A unique identifier for your partner organization within the Valox ecosystem, enabling us to track user acquisition and attribute activity to your integration.

* **APP\_ID**: An application-specific identifier that allows partners to authenticate with the PSE (Partner Secure Elements) and establish secure mTLS connection authentication between partner and Valox.

<Info>
  To get your PartnerID and APP\_ID, please follow these steps:

  1. Submit your partnership application through the [provided link](https://form.typeform.com/to/naN3irHW?typeform-source=valox.co).
  2. Wait for approval from Valox team.
  3. Once approved, you will receive an invite to join slack where we will communicate your PartnerID and APP\_ID and provide technical support.
</Info>