Skip to main content
POST
Create a card

Headers

X-SUB-PARTNER-ID
string

Optional sub-partner UUID; issues the card under that sub-partner

Idempotency-Key
string
required

A unique creation key; a retry with the same key returns the same card.

X-API-Version
string

Selects the API version for this request, as an ISO date (YYYY-MM-DD). Omit to use the default version (2025-03-13). Supported versions: 2025-03-13, 2026-07-01, 2026-08-01, 2026-10-01, 2026-10-15.

Body

application/json; charset=utf-8
currencies
enum<string>
required

The currency combination a card settles in.

Available options:
USD,
USD_ARS
customer_id
string<uuid>
required

The customer the card is issued to

form_factor
enum<string>
required
Available options:
virtual,
physical
tier
enum<string>
required
Available options:
standard,
premium
wallet_id
string<uuid>
required

The wallet the card spends from

Response

201 - application/json; charset=utf-8

The card was issued

created_at
string<date-time>
required
currencies
enum<string>
required

The currency combination a card settles in.

Available options:
USD,
USD_ARS
customer_id
string<uuid>
required

The customer the card belongs to

customer_type
enum<string>
required
Available options:
consumer,
business
exp_month
string
required
exp_year
string
required
form_factor
enum<string>
required
Available options:
virtual,
physical
id
string<uuid>
required
last_four
string
required
status
enum<string>
required
Available options:
active,
frozen,
revoked,
pending_fulfillment,
pending_activation
tier
enum<string>
required
Available options:
standard,
premium
updated_at
string<date-time>
required
wallet_id
string<uuid>
required

The wallet that funds the card