Crear una tarjeta
Emite una tarjeta (virtual o física) que gasta Just-In-Time del saldo central de la cuenta en el asset de gasto de la tarjeta (spending_asset: USDT/USDC 1:1 con el USD, o BTC/GOLD/SILVER/PLATINUM convertidos al precio del momento de cada evento; USD por defecto) — sin prefondeo: cada compra se autoriza en tiempo real contra el saldo disponible y los límites propios de la tarjeta. Las cuentas persona pueden tener 1 tarjeta viva total y 1 solicitud abierta; la emisión física nueva está temporalmente no disponible; las físicas existentes siguen operativas. Empresa: tarjetas ilimitadas; las cuentas empresa crean tarjetas ilimitadas, para la empresa o para personas designadas (ej. empleados, pasando sus documentos de identidad). La emisión cobra el fee card_creation_virtual / card_creation_physical cuando está configurado (0 = gratis); el cargo se reembolsa automáticamente si la emisión falla. Las tarjetas físicas nacen pending_activation hasta que el titular confirma la recepción.
Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Cuerpo
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.
Saldo desde el que gasta la tarjeta. Si se omite, se usa el asset de liquidación de la cuenta (USD es el saldo principal). USD/USDT/USDC van a la par del USD (1:1 exacto, sin comisión de conversión). BTC/GOLD/SILVER/PLATINUM 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).
USD, USDT, USDC, BTC, GOLD, SILVER, PLATINUM Límites de gasto opcionales en USD (se aplican al autorizar; 0 u omitido = sin límite).
Show child attributes
Show child attributes
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). first_name y last_name son opcionales y permiten sobrescribir el nombre impreso; juntos no pueden superar 22 bytes UTF-8. 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).
Show child attributes
Show child attributes
Respuesta
Tarjeta creada.
account, person pending_activation, active, frozen, cancelled Saldo desde el que gastan las compras de la tarjeta. USDT/USDC 1:1 con el USD; BTC/GOLD/SILVER/PLATINUM convertidos al precio del momento de cada evento. USD por defecto. Cambiarlo solo afecta compras futuras.
USD, USDT, USDC, BTC, GOLD, SILVER, PLATINUM Límites de gasto, siempre medidos en USD, independientes del asset de gasto.
Show child attributes
Show child attributes