Tapi Logo

Recomendamos ingresar en Desktop

Nuestra documentación y herramientas de integración están optimizadas para brindarte la mejor experiencia en computadora.

Por favor, accede desde una computadora para continuar.

Referencia API

Informativo

Descripcion Funcional

Descripcion general del flujo funcional para depositos y retiros para entidades reguladas a traves de CICO Emisores.

Conceptos Generales

En el siguiente documento se describe el flujo funcional para depositos y retiros para entidades reguladas. El emisor podria consumir ambas soluciones en simultaneo o independientemente.

La solucion Tapi es regional, es decir que el proceso de integracion es el mismo para todas las regiones donde opera Tapi.

Descripcion Funcional Transaccionalidad

Flujo de Pago

1

Una vez que el usuario tiene su referencia, el mismo se acerca a la tienda y menciona que va a hacer un pago.

2

El operador de la caja ingresa o escanea la referencia.

3

Tapi enviara un request al emisor para pedir la autorizacion del pago.

4

Una vez que el usuario obtiene el comprobante se notifica al emisor mediante un webhook que debe disponibilizar a Tapi.

Diagramas de Comunicacion de APIs

Diagrama de flujo para operaciones de Cash In (depositos). El usuario se acerca a una tienda con su codigo de referencia para realizar un deposito.

[POST] /payment-intent
[POST] /notifications
[POST] /operation
Diagrama de comunicacion de APIs Cash In
Situaciones de Fuerza Mayor - Reversos

Existen situaciones de fuerza mayor, en donde la tienda no ha podido procesar la autorizacion confirmada del pago. La causa principal es una falla de conexion dentro de los sistemas de la cadena.

Proceso de Reverso Automatico

En estos casos, el usuario final no ha podido realizar la operacion y la tienda solicita de manera automatica un reverso de la operacion. Dicho reverso se dispara desde los sistemas de Tapi hacia los del emisor. Se utiliza la misma mensajeria que el webhook de notificacion.

Diagrama de Reversos

El diagrama muestra dos escenarios de reverso: uno donde la operacion es confirmada y luego cancelada, y otro donde el request de Cash In es directamente cancelado.

[POST] /payment-intent
[POST] /notifications
Diagrama de Reversos
Resumen del Flujo
PasoActorAccion
1UsuarioGenera referencia en app del emisor
2UsuarioSe acerca a tienda con referencia
3CajeroIngresa/escanea referencia
4TapiSolicita autorizacion al emisor
5EmisorAprueba/rechaza operacion
6TapiNotifica al emisor via webhook