Saltar al contenido principal
POST

Autorizaciones

Authorization
string
header
requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Cuerpo

application/json
idempotency_key
string
requerido

Obligatoria (también como header Idempotency-Key). Un retry con la misma clave devuelve la tarjeta original y nunca cobra dos veces el fee de emisión.

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

Saldo desde el que gasta la tarjeta. USDT/USDC van a la par del USD (1:1 exacto, sin comisión de conversión). BTC/GOLD se convierten al precio efectivo del momento de cada evento, con colchón de reserva en la autorización (pricing fail-closed y límites de assets volátiles compartidos con payouts).

Opciones disponibles:
USDT,
USDC,
BTC,
GOLD
limits
object

Límites de gasto opcionales en USD (se aplican al autorizar; 0 u omitido = sin límite).

cardholder
object

Datos del titular. En la PRIMERA emisión de la cuenta el titular se crea en el emisor: la identidad y los documentos se COMPLETAN SOLOS desde la verificación de identidad aprobada de la cuenta (los campos explícitos ganan); solo agregas los campos propios del emisor (código de ocupación del catálogo, salary_usd). Omítelo en las tarjetas siguientes: se reutiliza el titular ya verificado. Las cuentas empresa también pueden usar kind "person" más el verification_id del KYC APROBADO de ESA persona para emitir a una persona designada (su identidad y documentos salen de la verificación).

Respuesta

Tarjeta creada.

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

Saldo desde el que gastan las compras de la tarjeta. USDT/USDC 1:1 con el USD; BTC/GOLD convertidos al precio del momento de cada evento. USDT por defecto. Cambiarlo solo afecta compras futuras.

Opciones disponibles:
USDT,
USDC,
BTC,
GOLD
limits
object

Límites de gasto, siempre medidos en USD, independientes del asset de gasto.

creation_fee
string
cancellation_fee
string
created_at
string<date-time>
updated_at
string<date-time>
Última modificación el 18 de julio de 2026