Skip to main content

​
Integration Models: Permissionless vs Partnerships

Gnosis Pay 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. Permissionless API Flow - Start building and testing with Gnosis Pay APIs
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.
Who it’s for: Developers or small teams who want to explore the APIs, prototype, or run very lightweight programs.

What You Can Do

  • ✅ 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)

What You Can't Do

  • ❌ 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

🚀 When to Move On

Once you want to connect card activity to your app/business or expose sensitive card details, you’ll need to switch into Partnership mode.

​
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 Gnosis Pay partner. Partnership API Flow - Start building and testing with Gnosis Pay APIs Who it’s for: Any partner ready to move beyond experimentation and operate a live program.

Key Credentials

  • Partner ID → Required for webhooks, attribution, and tracking
  • App ID → Required for Partner Secure Element (PSE) access

Advanced Features

  • Branded cards and custom experiences
  • Multi-market support
  • BIN sponsorship
  • Compliance oversight

Dedicated Support

Direct access to Gnosis Pay team for technical guidance and business support.

Full Observability

Complete integration into your systems with webhooks and analytics.
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 Gnosis Pay 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 Gnosis Pay.
To get your PartnerID and APP_ID, please follow these steps:
  1. Submit your partnership application through the provided link.
  2. Wait for approval from Gnosis Pay 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.