{
  "card_id": "card_12345",
  "message": "Card created successfully",
  "status": "success"
}

Wallet

Add New Card

Add a new card to the user’s wallet.\n\nAuthentication Required: Public Key or API Key\n- Requires X-Public-Key: <public_key> header OR X-API-Key: <api_key> header\n- Public key identifies the merchant but provides limited access\n- API key provides full access\n\nAdditional Requirements:\n- X-User-Id header required\n- X-Request-Id header required for tracking\n- Request body with card details\n\nUse Case: Add payment method to user’s wallet with automatic tokenization

POST

api

wallet

cards

{
  "card_id": "card_12345",
  "message": "Card created successfully",
  "status": "success"
}

Authorizations

X-Auth0-Key

string

header

required

Internal use only

Headers

x-request-id

string | null

Unique request identifier for tracing and debugging. Auto-generated if not provided.

x-user-id

string

required

End-user identifier within a customer organization. Required for user-scoped operations.

Body

application/json

Request model for collecting new card information.

Response

201

application/json

Card added successfully

Response model for card operations (create/update/delete).

Get All Cards Get Default Card

Mandates

API Keys