Notificaciones - CICO Emisores
POST
/notificationsConfigurar y gestionar notificaciones de operaciones CICO
Objetivo
Este endpoint permite configurar webhooks y canales de notificacion para recibir actualizaciones en tiempo real sobre el estado de las operaciones CICO. El emisor puede recibir notificaciones cuando una operacion es completada, cancelada o expira.
Request
Headers
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
x-api-key | String | Sí | Clave de API proporcionada por Tapi para autenticar la solicitud. |
x-authorization-token | String | Sí | Token de autenticacion obtenido en el login. |
Body Parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
webhookUrl | String | Sí | URL del webhook donde se enviaran las notificaciones. |
events | String[] | Sí | Lista de eventos a notificar: 'completed', 'cancelled', 'expired', 'authorized'. |
secret | String | No | Secreto para firmar las notificaciones (HMAC). |
Response
Response Body
| Parámetro | Tipo | Descripción |
|---|---|---|
webhookId | String | Identificador unico del webhook configurado. |
status | String | Estado de la configuracion: 'active', 'inactive'. |
Consideraciones
- Las notificaciones incluyen una firma HMAC-SHA256 en el header 'X-Tapi-Signature' si se configuro un secreto.
- Se reintentara el envio de notificaciones hasta 3 veces en caso de fallo.
CLIENT LIBRARIES
REQUEST EXAMPLE
curl --request POST \
--url https://cash-in.homo.tapila.cloud/notifications \
--header 'x-authorization-token: YOUR_TOKEN_HERE' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--header 'Content-Type: application/json' \
--data '{
"webhookUrl": "https://mi-servidor.com/cico/webhook",
"events": ["completed","cancelled","expired"],
"secret": "mi-secreto-seguro"
}'