Confirmar Pago
WEBHOOK
/confirmPaymentConfirma el resultado de una operación de recarga.
Objetivo
Este endpoint es utilizado por Tapi para notificar a la fintech que un pago ha sido completado exitosamente. Tapi envía esta confirmación a un endpoint que la fintech debe disponibilizar, actualizando así el estado de la deuda correspondiente en ambos sistemas.
Request
Headers
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
x-api-key | String | Sí | API Key provista para autenticar el request. |
x-authorization-token | String | Sí | Token de autenticación del cliente. |
Body Parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
externalPaymentId | String | Sí | ID de identificación de la operación propio del cliente. Utilizado para facilitar la trazabilidad. |
externalClientId | String | Sí | Identificador del usuario final por parte del cliente. |
operationId | String | Sí | Id de la operación. |
status | String | Sí | Estado final de la operación (confirmed o failed). |
companyCode | String | Sí | Código de la compañía. |
companyName | String | Sí | Nombre de la compañía. |
amount | Number | Sí | Monto a pagar. |
type | String | Sí | Vertical de negocio. |
hash | String | No | Hash. |
Response
Response Body
| Parámetro | Tipo | Descripción |
|---|---|---|
status | String | Estado de la confirmación de la operación. |
Consideraciones
- Este webhook es invocado por TAPI y debe ser implementado por el cliente.
- Viaja con headers personalizados para autenticación.
- El campo 'status' puede ser 'confirmed' o 'failed'.
CLIENT LIBRARIES
REQUEST EXAMPLE
curl --request POST \
--url https://recharge.homo.tapila.cloud/confirmPayment \
--header 'x-authorization-token: YOUR_TOKEN_HERE' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--header 'Content-Type: application/json' \
--data '{
"externalPaymentId": "",
"externalClientId": "",
"operationId": "",
"status": "",
"companyCode": "",
"companyName": "",
"amount": 0,
"type": "",
"hash": ""
}'