> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gnosispay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration models : Permissionless vs Partnerships

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

## Integration Models: Permissionless vs Partnerships

Gnosis Pay offers two ways to get started:

1. Permissionless Integration
2. Partnership Integration

***

## 1. Permissionless Integration

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/gnosispay/k3hrGlhZGi4lgCAa/static/img/API%20Flows_permissionless.png?fit=max&auto=format&n=k3hrGlhZGi4lgCAa&q=85&s=876895c601d3df19fa556163a3cba90e" alt="Permissionless API Flow - Start building and testing with Gnosis Pay 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 Gnosis-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

If your company is interested in deeper collaboration—such as branded cards, custom user experiences, fee rebates, or co-marketing opportunities — you can sign up through our [Partners Dashboard](https://partners.gnosispay.com/).

<Warning>
  **Domain Whitelisting Required**: During partner signup, you must provide all production and staging domains where your application will be hosted. These domains are whitelisted for SIWE (Sign-In with Ethereum) authentication and CORS.

  * **localhost**: Automatically allowed for local development (e.g., `localhost:3000`)
  * **Production/Staging**: All non-localhost domains must be registered during signup
  * Applications running on non-whitelisted domains will face authentication failures
</Warning>

<img src="https://mintcdn.com/gnosispay/k3hrGlhZGi4lgCAa/static/img/API%20Flows_partnership.png?fit=max&auto=format&n=k3hrGlhZGi4lgCAa&q=85&s=0d05e37a2ef85f50f5483d07311bb48a" alt="Partnership API Flow - Start building and testing with Gnosis Pay 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 Gnosis Pay 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>

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

Through our self-service [Partners Dashboard](https://partners.gnosispay.com/), partners can:

* **PartnerID**: A unique identifier for partner organization within the Gnosis Pay ecosystem, enabling us to track user acquisition and attribute activity to 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 Gnosis Pay.
  <img src="https://mintcdn.com/gnosispay/ILUQ19qTwu_HvmvS/static/img/partner_dashboard.png?fit=max&auto=format&n=ILUQ19qTwu_HvmvS&q=85&s=e1e6303cfdb7c6861500a70fb3e41b57" alt="Partners Dashboard - Self-service partner registration and management" className="rounded-lg shadow-lg" width="3020" height="908" data-path="static/img/partner_dashboard.png" />

<Info>
  To get your PartnerID and APP\_ID through the Partners Dashboard:

  1. Sign up at [partners.gnosispay.com](https://partners.gnosispay.com/)
  2. Include your company details and app domains (required for CORS whitelisting)
  3. Get your PartnerID and APP\_ID instantly upon registration
  4. Handle PSE integration setup, CSR signature, and webhook configuration directly through the dashboard

  **Critical**: You must include all your production and staging domains during signup. While localhost is automatically allowed for development, all other domains must be whitelisted for both CORS and SIWE authentication. Missing domains will cause authentication failures and API access issues.
</Info>