¿Qué es CashIn?
El caso de uso CashIn permite que tus clientes reciban dinero desde una tarjeta, como parte de una operación de entrada de fondos.
Aplicaciones comunes
Este caso de uso aplica en escenarios donde el comercio tiene la autorización para cargar fondos directamente desde la tarjeta del cliente, sin requerir que el usuario dispare activamente el pago. Algunos ejemplos:
- Recargas de billeteras: Permite recargar una tarjeta utilizando otra tarjeta como medio de pago. El saldo se acredita de forma automática y queda disponible de inmediato para ser utilizado en la tarjeta recargada
- Solicitud de Dinero:
- Open Link: El usuario solicita a un tercero que le realice una transferencia. Para ello, genera un enlace único que puede compartirse por WhatsApp, SMS u otros canales. La persona que recibe el enlace, al abrirlo, se registra en la plataforma, selecciona su medio de pago y completa el envío del dinero a la tarjeta que el usuario solicitante definió desde el inicio. Es importante resaltar que toda la información del remitente (quien envía el dinero) es tratada siguiendo las políticas de seguridad y protección de datos vigentes.
- Request To Pay: El usuario solicita a un tercero que le realice una transferencia por un monto determinado. Para ello, genera un enlace único que puede compartirse por WhatsApp, SMS u otros canales. La persona que recibe el enlace, al abrirlo, se registra en la plataforma, selecciona su medio de pago y completa el envío del dinero a la cuenta que el usuario solicitante definió desde el inicio. Es importante resaltar que toda la información del remitente (quien envía el dinero) es tratada siguiendo las políticas de seguridad y protección de datos vigentes.
- Modelos de pago post-servicio, donde se cobra automáticamente a la tarjeta del usuario luego de cumplir ciertas condiciones.
Cómo funciona a nivel técnico
La operación se interpreta como una captura de fondos de una tarjeta para ser enviado a través de un procesador a otra tarjeta.
El desarrollador debe enviar:
- Identificador del tercero que recibe (Recipient):
- Identificador del tercero que envía (Sender), No aplica para recarga de billetera:
- Datos de la tarjeta de origen (Card Sender):
- Datos de la tarjeta destino (Card Recipient):
- El monto (para el caso de open link, quien envía es quien coloca el monto):
- Un identificador único de la transacción para seguimiento:
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 recibirá 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 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 sender: PAN de la tarjeta, Fecha expiración, CVV, Nombre de la tarjeta.
- 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 Link
2. Tarjeta existente (sender - tokenizada) y Tarjeta nueva (recipient)
- Se registra la tarjeta que recibirá 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 (Está tokenizada) que enviará el dinero, solo debe inyectar:
{
"thirdBankUUID": "dfb56715-ed55-4839-b0"
}
- 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 recibirá el dinero (está tokenizada), solo es inyectar el ThirdBankUUID:
{
"thirdBankUUID": "dfb56715-ed55-0046-a3"
}
- Como ya existe la tarjeta (Está tokenizada) que enviara el dinero, solo debe inyectar:
{
"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 - tokenizada)
- Como ya existe la tarjeta que recibirá el dinero(está tokenizada), solo es inyectar el ThirdBankUUID:
{
"thirdBankUUID": "dfb56715-ed55-1546-d9"
}
- 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 sender: PAN de la tarjeta, Fecha expiración, CVV, Nombre de la tarjeta.
- 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