Este endpoint permite habilitar la capacidad de recibir pagos internacionales (cross-border) para un usuario específico a través de nuestros rieles de pago.
Cuando un usuario se registra para recibir pagos internacionales, se inicia un proceso de conocimiento de clientes (KYC, por sus siglas en inglés, Know Your Customer) para asegurar el cumplimiento normativo y de seguridad.
Proceso de Habilitación:
Verificación de Identidad: Se realiza una verificación exhaustiva de la identidad del usuario.
Revisión de Listas Restrictivas: El sistema verifica si el usuario o entidad tienen presencia en listas restrictivas o vinculantes para prevenir la vinculación de personas naturales o jurídicas que estén involucradas en actividades como lavado de activos, financiamiento al terrorismo, fraude, entre otros.
Si el usuario aprueba el proceso de conocimiento de clientes, se registrará de manera inmediata, incluyendo tantos los datos del usuario como los de la tarjeta (método de pago), todo lo anterior ocurre en un solo paso.
La respuesta incluirá la información del usuario, el método de pago y un link de cobro.
{
"thirdUUID": "{{third-xborder}}",
//"thirdBankUUID": "{{thirdBankUUID}}"
"paymentMethod": {
"cardNumber": "{{card2}}",
"cardExpiry": "202708",
"cardCVV": "772"
}
}
Nota importante sobre Sandbox: En el entorno sandbox (pruebas), solo se permiten un conjunto limitado de tarjetas de prueba para registrar métodos de pago y realizar operaciones. Estas tarjetas serán proporcionadas al momento de habilitar el acceso al entorno. Cualquier intento de registrar tarjetas no autorizadas será rechazado por el sistema.
Body:
| Parámetro | Descripción | Ejemplo |
|---|---|---|
thirdUUID | UUID del tercero | 123e4567-e89b-12d3-a456-426614174000 |
thirdBankUUID | UUID de una cuenta tokenizada del tercero (opcional) | 123e4567-e89b-12d3-a456-426614174000 |
paymentMethod.cardNumber | Número de la tarjeta de crédito | 4111111111111111 |
paymentMethod.cardExpiry | Fecha de vencimiento de la tarjeta (formato YYYYMM) | 202612 |
paymentMethod.cvv | Código de seguridad de la tarjeta | 123 |
Respuesta
{
"error": 0,
"code": "ML000",
"category": "GENERAL",
"message": "Registro guardado con éxito.",
"data": {}
}