Card Issuing API

Card issuing runs through a dedicated card-program layer with routed issuing partners, card balances, authorization events, disputes, and operational controls.

Current Program Surface

  • Program discovery and provider-backed card creation
  • Wallet-to-card funding and card-to-wallet withdrawal
  • Freeze, unfreeze, terminate, authorize, settle, reverse, and dispute flows

Endpoints

Endpoint Method Auth Headers Notes
List active card programs
/cards/api/v1/programs/
Return routed card programs that are enabled in the market.
GET User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits
Create managed card
/cards/api/v1/managed-cards/
Issue a provider-backed managed card.
POST User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Status lifecycle: pending, active, frozen, blocked, expired, terminated, failed, under_review
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits
Fund managed card
/cards/api/v1/managed-cards/{reference}/fund/
Debit the linked wallet and increase card balance.
POST User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Webhooks: wallet.debited, card.funded
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits
Authorize card transaction
/cards/api/v1/managed-cards/{reference}/authorize/
Create an authorization event and hold card balance.
POST User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Webhooks: card.authorization.created
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits
Create card dispute
/cards/api/v1/disputes/
Open a card dispute case linked to an authorization.
POST User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits