Ejemplo de integración
Un recorrido realista para construir una billetera sobre Core.
Esta página recorre la construcción de una billetera de consumo sobre Core de extremo a extremo: un producto donde los usuarios finales mantienen un saldo, lo recargan, envían dinero a otros usuarios y lo gastan con una tarjeta virtual. Es el ejemplo canónico para entender cómo los servicios de Core se componen en un producto real.
Una billetera es el caso de uso más común de Core. Si estás construyendo otra cosa — un programa de tarjetas corporativas, un saldo de vendedor de marketplace, un sistema de tesorería — los patrones aquí se transfieren directamente; solo cambian los nombres de las entidades.
Esta página es un esqueleto de ejemplo de integración. La versión completa incluirá una narrativa completa, snippets de código por paso y un diagrama de arquitectura de referencia.
Qué vas a construir
Una billetera que soporta:
- Onboarding — un usuario se registra y obtiene una cuenta de ledger.
- Recarga — el usuario agrega fondos vía PSE (Banking lo maneja; Core registra el crédito).
- Emisión de tarjeta — el usuario solicita una tarjeta virtual que gasta contra su cuenta de ledger.
- Gasto — la tarjeta se autoriza en tiempo real contra el saldo del usuario y sus límites.
- Transferencia W2W — el usuario envía dinero a otro usuario de la billetera.
- Dispersión — el usuario retira a una cuenta bancaria colombiana (Banking maneja el riel; Core debita el ledger).
Arquitectura
La billetera se apoya en tres servicios de Core y uno de Banking:
| Capa | Servicio | Rol |
|---|---|---|
| Dinero entra | Banking — Recaudo PSE | Recarga iniciada por el pagador |
| Saldo | Core — Ledger | Cuenta por usuario, cada peso registrado |
| Gasto | Core — Tarjetas + Controles de gasto | Emisión de tarjeta + autorización en tiempo real |
| Dinero sale | Core — Dispersiones → Banking | Retiro a banco externo |
Recorrido
El recorrido completo — código de onboarding, manejo de recargas, emisión de tarjeta, autorización en tiempo real, transferencia W2W y dispersión — se agregará aquí.
Siguientes pasos
- Ledger — el modelo de datos que ancla la billetera.
- Tarjetas — emisión y ciclo de vida.
- Buenas prácticas — consideraciones de producción.