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 convertidos al precio del momento de cada evento; USDT 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 virtual + 1 física; 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. 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).
USDT, USDC, BTC, GOLD Límites de gasto opcionales en USD (se aplican al autorizar; 0 u omitido = sin límite).
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.
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 convertidos al precio del momento de cada evento. USDT por defecto. Cambiarlo solo afecta compras futuras.
USDT, USDC, BTC, GOLD Límites de gasto, siempre medidos en USD, independientes del asset de gasto.