DEBIN PROGRAMADO PARA BILLETERAS/PSP

Ejemplo del circuito de Debin Programado

En el siguiente apartado, se expone el circuito para la generacion de debines programados y las condiciones que se deben tener en cuenta al integrar el mismo:

Vendedor

1. Alta de prestacion:

En el ambiente de PRODUCCION el vendedor da de alta la prestación.

En el ambiente de QA este paso no es necesario, ya que APIBANKING posee prestaciones de prueba preestablecidas.

2. Solicitud de adhesion a recurrencia:

En el ambiente de PRODUCCION el vendedor carga las solicitudes de adhesión a recurrencia.

En el ambiente de QA este paso no es necesario, ya que APIBANKING realizará la solicitud solo al momento de hacer los casos de homologación, de esta manera poder realizar el flujo lo mas fiel posible al ambiente productivo.

3. Generación de debines programados

Una vez el comprador haya aceptado la recurrencia, el vendedor puede disparar el cobro de la misma. En el ambiente de QA este paso lo hará APIBANKING al momento que se esten realizando pruebas para los casos de homologación.

Nota:

A este punto, el comprador debe tener ya integrado en su desarrollo:

• Recibir notificaciones de aviso de debito pendiente [POST]:/v1/notifications/cvu/debit-pending
• Confirmar o rechazar el debito con la api [POST]:/v1/cvu/operations/debit/confirm

Comprador

4. Consulta de Adhesión

El comprador debe consultar frecuentemente las recurrencias que tiene en estado inactiva, activa, para luego ir confirmando o rechanzo las mismas. Para esto debe consultar desde la api adhesión a la recurrencia, se puede hacer uso de la API [POST]:/v1/debin/recurrence/scheduled/purchaser/adhesion para consultar el estado de la misma

Nota:

Para que los debines programados sean exitosos, la recurrencia debe estar en estado activa y con estado de autorización en true.

5. Autorizacion de la recurrencia:

El comprador deberá autorizar o rechazar la recurrencia a través a traves del servicio indicando: el id asociado a la recurrencia a traves de la api [POST]:/v1/debin/recurrence/purchaser/adhesion/confirm

5.1 Baja de adhesion a recurrencia:

En caso de que la recurrencia aceptada esté con un algun valor incorrecto (vendedor, monto, cuotas, etc). Puede solicitar la baja del mismo a traves de la api [POST]:/v1/debin/recurrence/purchaser/adhesion/cancel

En ambiente de QA, se solicitará hacer alguna baja de adhesion para los casos de homologación.

6. Aceptar débito por debin programado

Una vez el comprador haya aceptado la recurrencia, el vendedor puede disparar el cobro de la misma, donde le llegará al comprador una notificacion desde el webhook [POST]:/v1/notifications/cvu/debit-pending. Usando la informacion recibida en la notificación, ejecutar la api [POST]:/v1/cvu/operations/debit/confirm para confirmar o rechazar el debito segun sea el caso.

En el ambiente de QA, para los casos de homologacion, se enviarán los debines programados necesarios para realizar los casos de confirmar y rechazar el débito.

7. Solicitar contracargo por debin programado

El comprador podrá solicitar el contracargo por un debin programado solo para el caso donde solo se a cobrado la primera cuota. Para esto, debe ejecutar la api [POST]:/v1/debin/scheduled/purchaser/chargeback. De ser exitoso el contracargo, debe llegar notificación desde el webhook [POST]:/v1/notifications/cvu/credit-received

En el ambiente de QA, para los casos de homologacion, deberá completar los casos relacionados a la solicitud de contracargo exitosa o rechazada

Importante:

Si no se recibe alguna notificación, la PSP debe usar el servicio de consulta de debin [GET]:/v3/payments/debin/{debin_id} con el id del contracargo.

8. Consulta de debin programado

El comprador podrá consultar los debines y contracargos a traves de la api [GET]:/v3/payments/debin/{debin_id}

En el ambiente de QA, para los casos de homologacion, se agregaran casos para consultar debines.