Autopay Ciclo de vida
Autopay permite que un usuario final delegue el pago de sus servicios. Una vez suscripto, tapi detecta cada factura nueva y notifica a la fintech para que ejecute el débito sobre la cuenta del usuario. La fintech confirma el débito y tapi registra el pago contra el biller.
El flujo involucra cuatro operaciones que sólo se entienden en conjunto.
1
Suscripción
PATCH /automatic-debitel usuario activa Autopay para un servicio ya adherido en agenda.
2
Factura nueva
tapi detecta una deuda nueva para ese servicio.
3
Notificación
webhook debit-incomingtapi le informa a la fintech el monto a debitar y le entrega un taskToken.
4
Débito
la fintech debita de la cuenta del usuario final.
5
Confirmación
POST /automatic-debit/confirmla fintech devuelve el taskToken y tapi procesa el pago contra el biller.
6
Consulta de estado
GET /operation/{operationId}estado final del pago.
Ventana de confirmación: 300 segundos. Desde que tapi envía el webhook
debit-incoming, la fintech tiene 5 minutos para llamar a POST /automatic-debit/confirm con el taskToken recibido. Si no confirma dentro de esa ventana, la notificación expira y el débito pasa a un ciclo de reintentos. Este valor es configurable por cliente; 300 segundos es el default. Coordiná con tu contacto técnico en tapi si tu flujo necesita una ventana mayor.