Skip to main content
POST

Authorizations

Authorization
string
header
required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Body

application/json
idempotency_key
string
required

Required (also accepted as the Idempotency-Key header). A retry with the same key returns the original card and never double-charges the issuance fee.

physical
boolean
default:false
spending_asset
enum<string>
default:USDT

Balance the card spends from. USDT/USDC are at par with the USD (exact 1:1, no conversion fee). BTC/GOLD convert at the effective price of the moment of each event, with a reserve cushion at authorization (fail-closed pricing, per-operation and 24h volatile limits shared with payouts).

Available options:
USDT,
USDC,
BTC,
GOLD
limits
object

Optional spending limits in USD (enforced at authorization time; 0 or omitted = no limit).

cardholder
object

Cardholder data. On the account's FIRST issuance the holder is created at the issuer: identity data and documents AUTO-FILL from the account's approved identity verification (explicit fields win); you only add the issuer-specific fields (occupation catalog code, salary_usd). Omit it on subsequent cards: the verified holder is reused. Company accounts can also set kind "person" plus the verification_id of THAT person's APPROVED KYC to issue for a designated person (their identity and documents come from the verification).

Response

Card created.

card_id
string
account_id
string
physical
boolean
cardholder_kind
enum<string>
Available options:
account,
person
cardholder_name
string
status
enum<string>
Available options:
pending_activation,
active,
frozen,
cancelled
spending_asset
enum<string>

Balance the card's purchases spend from. USDT/USDC 1:1 with the USD; BTC/GOLD converted at the price of the moment of each event. USDT by default. Changing it only affects future purchases.

Available options:
USDT,
USDC,
BTC,
GOLD
limits
object

Spending limits, always measured in USD regardless of the spending asset.

creation_fee
string
cancellation_fee
string
created_at
string<date-time>
updated_at
string<date-time>
Last modified on July 18, 2026