¿Qué es CashOut?
El caso de uso CashOut permite a tu plataforma realizar envíos de dinero desde una tarjeta (como una billetera o saldo disponible del usuario) hacia una tarjeta de débito o crédito. Es una operación de salida controlada, en la que tú decides cuándo y cuánto transferir.
Este flujo está diseñado para ofrecer una experiencia de retiro rápida, sencilla y completamente automatizada.
Aplicaciones comunes
CashOut es ideal para cualquier negocio que necesite entregar dinero al usuario final a través de una tarjeta. Algunos ejemplos incluyen:
- Plataformas de préstamos que desembolsan fondos aprobados directamente a la tarjeta del solicitante.
- Wallets y apps financieras que permiten a los usuarios retirar su saldo disponible.
- Sistemas de fidelización o cashback que entregan recompensas monetarias a los usuarios.
Cómo funciona a nivel técnico
La operación se interpreta como un envío de fondos de una tarjeta del tercero a otra(s) tarjeta(s) mediante un procesador.
- Identificador del tercero que envía (Sender)
- Datos de la tarjeta de origen (Card Sender)
- Identificador del usuario o cliente final o beneficiario (nombre y número de documento).
- Detalles de la tarjeta destino (número PAN).
- Monto a transferir.
- Identificador único de la transacción para trazabilidad.
Casos de Uso
Cada caso de uso requiere una configuración específica y, en consecuencia, parámetros de entrada particulares.
Una vez procesada, la operación retorna el resultado de la transacción y de forma adicional está información es enviada vía webhook, que les permitirá manejar estas notificaciones de forma automatizada.
Para los casos de uso a continuación como primera medida se de contar con la creación del tercero:
{
"name": "Luis H",
"lastName": "hernandez",
"document": "31532123",
"typeDocumentId": 1,
"emailNotification": "[email protected]",
"indicativeContact": "+57",
"phoneContact": "3000000025",
"categoryId": 3
}
Enlace a la documentación Link
1. Tarjeta nueva (sender) y (recipient):
- Se registra la tarjeta que enviará el dinero:
Se debe levantar el SDK Web: Enlace a la documentación Link, para que tengas conocimiento de como se configura previamente el mismo(SDK) Enlace a la documentación Link
Seguido se abre una ventana para diligenciar los datos de la tarjeta del tercero, la acción sería vincular un medio de pago: Enlace a la documentación Link
- Se registra la tarjeta que recibirá el dinero (Beneficiario):
Se debe levantar el SDK Web: Enlace a la documentación Link, para que tengas conocimiento de como se configura previamente el mismo(SDK) Enlace a la documentación Link
Seguido se abre una ventana para diligenciar los datos de la tarjeta del sender: PAN de la tarjeta, Adicional Nombre y numero de documento de este beneficiario.
- Luego de tener la tarjeta que recibe y la tarjeta que envía, en la siguiente ventana, se escribe el monto a enviar y se finaliza la transacción: Enlace a la documentación Link
2. Tarjeta existente(sender - tokenizada) y Tarjeta nueva(recipient)
- Como ya existe la tarjeta (Está tokenizada) que enviara el dinero, solo debe inyectar:
{
"thirdBankUUID": "dfb56715-ed55-4839-b0"
}
- Se registra la tarjeta que recibirá el dinero (beneficiario):
Se debe levantar el SDK Web: Enlace a la documentación Link, para que tengas conocimiento de como se configura previamente el mismo(SDK) Enlace a la documentación Link
Seguido se abre una ventana para diligenciar los datos de la tarjeta del sender: PAN de la tarjeta, Adicional Nombre y numero de documento de este beneficiario.
- Luego de tener la tarjeta que recibe y la tarjeta que envía, en la siguiente ventana, se escribe el monto a recargar y se finaliza la transacción: Enlace a la documentación Link
3. Tarjeta existente (sender) y (recipient)
- Como ya existe la tarjeta que enviará el dinero(está tokenizada), solo es inyectar el ThirdBankUUID:
{
"thirdBankUUID": "dfb56715-ed55-0046-a3"
}
- Como ya existe la tarjeta (Está tokenizada) que recibirá el dinero, solo debe inyectarse (beneficiario):
{
"thirdBankUUID": "dfb56715-ed55-2546-b7"
}
- Luego de tener la tarjeta que recibe y la tarjeta que envía, en la siguiente ventana, se escribe el monto a recargar y se finaliza la transacción: Enlace a la documentación Link
4. Tarjeta nueva (sender) y Tarjeta Existente (recipient)
- Se registra la tarjeta que enviará el dinero:
Se debe levantar el SDK Web: Enlace a la documentación Link, para que tengas conocimiento de como se configura previamente el mismo(SDK) Enlace a la documentación Link
Seguido se abre una ventana para diligenciar los datos de la tarjeta del tercero, la acción sería vincular un medio de pago: Enlace a la documentación Link
- Como ya existe la tarjeta que recibirá el dinero(está tokenizada), solo es inyectarla:
{
"thirdBankUUID": "dfb56715-ed55-1546-d9"
}
- Luego de tener la tarjeta que recibe y la tarjeta que envía, en la siguiente ventana, se escribe el monto a recargar y se finaliza la transacción: Enlace a la documentación Link
Todos los json anteriores deben ir encriptados