Crear Suscripción de Webhook

POST

/fidix/v1/webhooks/subscriptions

Crea una nueva suscripción de webhook para recibir notificaciones de eventos del sistema.

Tipos de eventos disponibles:

transfer.received: Transferencia entrante recibida y procesada

transfer.failed: Transferencia entrante fallida

transfer.pending: Transferencia entrante pendiente

Validaciones:

La URL debe ser HTTPS

Los tipos de eventos deben ser válidos

Máximo 10 tipos de eventos por suscripción

Si no se proporciona un secret, se genera automáticamente

Uso de Variables Guarda el id de la suscripción en ${subscription_id} para usarlo en otros endpoints.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

Authorization: ********************

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Suscripción creada exitosamente

Body

🟠400

🟠401

🟠403

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Suscripción básicaMúltiples tipos de eventos

curl --location --request POST 'https://api-preview.fidi.money/fidix/v1/webhooks/subscriptions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://mi-servidor.com/webhooks/fidi",
    "event_types": [
        "transfer.received"
    ]
}'

Ejemplo de Respuesta

201 - success

{
    "id": "8a9b0c1d-2e3f-4a5b-6c7d-8e9f0a1b2c3d",
    "url": "https://mi-servidor.com/webhooks/fidi",
    "event_types": [
        "transfer.received"
    ],
    "secret": "whsec_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
    "status": "active",
    "created_at": "2026-01-14T10:00:00Z",
    "updated_at": "2026-01-14T10:00:00Z",
    "last_delivery_at": null,
    "delivery_count": 0,
    "failure_count": 0
}

Modificado en 2026-01-14 21:15:27

Crear Transacción

Listar Suscripciones de Webhook