RealTime Payments: Funcionalidad y Flujos de la API

RealTime Payments (RTP) permite la transferencia de dinero a través de tres flujos distintos:

• Money Transfer (Transferencia de Dinero)
• Pull Funds (Retiro de Fondos)
• Push Funds (Adición de Fondos)

A continuación, describimos cada uno de estos flujos:

Money Transfer (Transferencia de Dinero)

La Transferencia de Dinero es una operación diseñada para retirar fondos (Pull) de una tarjeta y transferir fondos (Push) a otra tarjeta Visa.

1. El usuario solicita la transferencia de dinero a nivel doméstico o transfronterizo.

2. El propietario del programa se integra con Novopayment a través de la API de Real Time Payments, que puede obtener la información del titular de la tarjeta y la tarjeta a través de Alias Directory o ingresando esa información si el usuario no está registrado en Alias Directory o no desea registrarse.

3. RTP realiza operaciones de validación (Consulte la guía Flujo de Operaciones de Validación RTP).

   3.1. Operaciones de Validación de Novopayment (Consulte la guía Flujo de Operaciones de Validación RTP).

   3.2. Validación contra las redes (Consulte la guía Flujo de Operaciones de Validación RTP).

4. Si una transferencia es transfronteriza, RTP consulta el núcleo de Foreign Exchange Rates para realizar el intercambio de divisas.

   4.1. Exchange Rates construye la consulta de intercambio entre dos monedas.

   4.2. Las tasas de cambio se validan contra las redes.

5. Integración con el conector de Visa para realizar el Pull y Push.

   5.1. El conector recibe todos los requisitos para ejecutar una transacción Pull y Push y los envía a las redes para su ejecución.

   5.2. Las redes realizan las validaciones correspondientes y envían una respuesta.

   Si la respuesta es exitosa, continúa con el paso 6; si falla, continúa con el paso 5.3.

   5.3. Si la respuesta falla, consume el servicio de API de Consulta.

   5.4. En caso de que la transacción no sea exitosa, el servicio de API de Consulta intentará realizar la transacción nuevamente en un tiempo especificado y según la configuración de intentos.

   5.5. Las redes realizarán intentos de ejecución de la transacción según la configuración realizada.

6. Si la transacción fue exitosa, RTP confirma el estado al propietario del programa (6.1).

7. RealTimePayments responde indicando si la transacción fue exitosa o fallida al propietario del programa (7.1).

Pull Funds (Retiro de Fondos)

Retiro de Fondos es una operación que retira fondos de la tarjeta del remitente (Pull). Este flujo permite al propietario del programa finalizar la transferencia de dinero depositando los fondos (crédito) en la cuenta del destinatario utilizando otro proceso interno del cliente (por ejemplo, cuando el abono es a las tarjetas propias del programa).

1. El usuario solicita la transferencia de dinero a nivel doméstico o transfronterizo.

2. El propietario del programa se integra con Novopayment a través de la API de Real Time Payments, que obtiene los datos del instrumento de pago.

3. Realiza operaciones de validación (Consulte la sección II. Flujo de Operaciones de Validación RTP).

4. Si una transferencia es transfronteriza, RTP consulta las tasas de cambio extranjeras para realizar el intercambio de divisas.

   4.1. Exchange Rates construye la consulta de intercambio entre dos monedas.

   4.2. Las tasas de cambio se validan contra las redes.

5. Integración con el conector de Visa para realizar el Pull, que retirará los recursos de la cuenta del remitente.

   5.1. El conector recibe todos los requisitos para ejecutar una transacción Pull y los envía a las redes para su ejecución.

   5.2. Las redes realizan las validaciones correspondientes y envían una respuesta.

   Si la respuesta es exitosa, continúa con el paso 6; si falla, continúa con el paso 5.3.

   5.3. Si la respuesta falla, consume el servicio de API de Consulta.

   5.4. En caso de que la transacción no sea exitosa, el servicio de API de Consulta intentará realizar la transacción nuevamente en un tiempo especificado y según la configuración de intentos.

   5.5. Las redes realizarán intentos de ejecución de la transacción según la configuración realizada.

6. Si la transacción fue exitosa, RTP confirma el estado al propietario del programa (6.1).

7. RTP responde al propietario del programa, indicando si la transacción Pull fue exitosa o fallida (7.1).

Push Funds (Adición de Fondos)

Adición de Fondos es una operación que agrega fondos a la tarjeta de un destinatario. Este flujo permite al propietario del programa iniciar la transferencia retirando los fondos de la cuenta del remitente utilizando otro proceso.

1. El usuario solicita la transferencia de dinero a nivel doméstico o transfronterizo.

2. El propietario del programa se integra con Novopayment a través de la API de Real Time Payments, que obtiene los datos del instrumento de pago.

3. Realiza operaciones de validación (Consulte la sección II. Flujo de Operaciones de Validación RTP).

4. Si una transferencia es transfronteriza, RTP consulta las tasas de cambio extranjeras para realizar el intercambio de divisas.

   4.1. Exchange Rates construye la consulta de intercambio entre dos monedas.

   4.2. Las tasas de cambio se validan contra las redes.

5. Integración con el conector de Visa para realizar el Push, que depositará los fondos en la cuenta del remitente.

   5.1. El conector recibe todos los requisitos para ejecutar una transacción Push y los envía a las redes para su ejecución.

   5.2. Las redes realizan las validaciones correspondientes y envían una respuesta.

   Si la respuesta es exitosa, continúa con el paso 6; si falla, continúa con el paso 5.3.

   5.3. Si la respuesta falla, consume el servicio de API de Consulta.

   5.4. En caso de que la transacción no sea exitosa, el servicio de API de Consulta intentará realizar la transacción nuevamente en un tiempo especificado y según la configuración de intentos.

   5.5. Las redes realizarán intentos de ejecución de la transacción según la configuración realizada.

6. Si la transacción fue exitosa, RTP confirma el estado al propietario del programa (6.1).

7. RTP responde al propietario del programa, indicando si la transacción Push fue exitosa o fallida (7.1).

Reverse Funds (Reversión de Fondos)

Reversión de Fondos es una operación que revierte automáticamente una transacción de tipo Pull dentro de una ventana de 24 horas después de la transacción.

Se inicia una solicitud de reversión cuando la transferencia falla durante la transacción de Push. El flujo completo es el siguiente:

1. El usuario solicita una transferencia de dinero.

2. El propietario del programa se conecta con Real Time Payment para la transferencia de dinero.

3. RTP se conecta con las operaciones de validación de Novopayment para obtener información de la tarjeta (estado, tipo de tarjeta, entre otros), atributos de la tarjeta y comprobaciones de listas restrictivas.

   3.1. Los servicios de operaciones de validación desde RTP se conectan con las redes.

   3.2. La red proporciona respuestas de validación y responde al servicio de operación de validación correspondiente (Consulta, Seguridad, Monitoreo del Cliente y Tasas de Cambio).

4. Después de la validación, el API de Consulta confirma el estado de la transacción dentro de un tiempo especificado.

   Si el estado de la transferencia es exitoso:

5. RTP responde al propietario del programa con el estado exitoso de la transacción.

   5.1. Se informa al usuario sobre el estado exitoso de la transacción.

   Si la transferencia de dinero falla (ya que el Push no se ejecutó):

6. Consume el servicio API de Retorno de Pull de Novopayment.

   6.1. El servicio API de Retorno de Pull de Novopayment valida con las redes.

   6.2. Las redes proporcionan respuestas de validación previa.

7. En caso de que la reversión no sea exitosa, el servicio de API de Consulta intentará ejecutarla nuevamente dentro de un tiempo especificado.

   7.1. El API de Consulta valida con las redes.

   7.2. Las redes envían la confirmación correspondiente del estado de la reversión.

8. Novopayment, como Habilitador de Pagos, responde al propietario del programa con el estado de la reversión.

9. El estado de la reversión se comunica al usuario a través de la aplicación.

Reverse Adjustment (Ajuste de Reversión)

Ajuste de Reversión es una operación para solicitar la reversión manual de una transacción de tipo Pull, sin una ventana de 24 horas después de la transacción. Esto suele ocurrir debido a fallas en la ejecución del Push o disputas.

1. El propietario del programa inicia la solicitud de reversión.

2. Consume el servicio API de Ajuste de Reversión de Novopayment.

   2.1. El servicio API de Ajuste de Reversión de Novopayment valida con las redes.

   2.2. Las redes proporcionan respuestas de validación previa.

   En caso de que la reversión no sea exitosa:

3. El servicio de API de Consulta intentará ejecutarla nuevamente dentro de un tiempo especificado.

   3.1. El API de Consulta valida con las redes.

   3.2. Las redes envían la confirmación correspondiente del estado de la reversión.

4. Novopayment, como Habilitador de Pagos, a través de la API de RTP, responde al propietario del programa con el estado de la reversión.

5. El estado de la reversión se comunica al usuario a través de la aplicación.

Reportes

Reportes es un servicio en línea que le permite consultar datos de operaciones realizadas en un rango de hasta 120 días. Puede consultar la siguiente información por el BIN del adquirente registrado:

• Token de tarjeta enmascarado
• Transacción realizada
• Estado de la transacción
• Propósito
• Monto
• Impuesto
• Fecha de procesamiento
• Razón de los códigos de respuesta de la transacción

Requisitos para la Implementación

Para implementar esta solución, se requiere lo siguiente:

• Tener un BIN adquirente.
• Documentación del flujo base de la billetera.
• Proceso KYC (Conozca a su cliente).
• Flujo de transacción.
• Corredores interesados en implementar.
• Definiciones de modelos de negocio domésticos o transfronterizos.
• Casos de uso, flujos e identificación de las APIs a utilizar.