Emisión de tarjetas
Crear, activar, congelar y aprovisionar tarjetas a billeteras digitales.
La emisión es el proceso de crear una tarjeta que gasta contra una cuenta de ledger de Core, ponerla en manos del usuario y gestionar su ciclo de vida. Una tarjeta puede ser virtual (un número de 16 dígitos instantáneo para uso en línea o en la app) o física (una tarjeta plástica que se envía al tarjetahabiente), y puede aprovisionarse a una billetera digital como Apple Pay o Google Wallet para habilitar pagos contactless.
Usa este flujo cuando tu producto necesite entregar una tarjeta a tus usuarios finales — billeteras de consumo, programas corporativos de gastos, dispersiones a vendedores de marketplace sobre una tarjeta, o cualquier caso donde quieras que el dinero sea gastable directamente desde un saldo de ledger.
Esta página es un esqueleto de flujo. La versión completa incluirá código por paso, el diagrama de estados del ciclo de vida, el handshake de aprovisionamiento a billetera digital y el flujo de autorización.
Antes de empezar
Vas a necesitar:
- Una API key de Core con el scope
cards. - Una cuenta de ledger contra la cual la tarjeta va a gastar.
- Una configuración de control de gasto apropiada para el tarjetahabiente.
- Un endpoint de webhook suscrito a eventos de tarjeta y de transacción de tarjeta.
Resumen de la secuencia
- Crear la tarjeta — llama al endpoint de creación de tarjeta con la cuenta de ledger vinculada, los datos del tarjetahabiente y una referencia al control de gasto.
- Activar la tarjeta — las tarjetas virtuales son usables de inmediato; las físicas requieren activación por parte del tarjetahabiente luego de la entrega.
- Aprovisionar a una billetera digital (opcional) — genera un token de aprovisionamiento para que el tarjetahabiente pueda agregar la tarjeta a Apple Pay o Google Wallet.
- Autorizar transacciones — Core decide cada autorización en tiempo real usando el saldo del tarjetahabiente y los controles de gasto activos. Los webhooks se disparan en cada autorización, settlement y reverso.
- Gestionar el ciclo de vida — congelar, descongelar, reponer o terminar la tarjeta según se necesite.
Pasos
El paso a paso completo está pendiente. Hasta que se publique, ver:
- Página de concepto de Tarjetas — modelo de datos y ciclo de vida.
- Página de concepto de Controles de gasto — cómo configurar reglas.
- Referencia de API de tarjetas de Core.
Siguientes pasos
- Contabilidad de ledger — cómo las autorizaciones se convierten en entradas de ledger.
- Buenas prácticas