Crear Suscripción Webhook

POST

/fidix/v1/webhooks/subscriptions

Crea una nueva suscripción para recibir notificaciones webhook de los eventos seleccionados.

Flujo de activación

La suscripción se crea.

Puede quedar en estado pending_confirmation.

Tu endpoint recibirá un mensaje de validación con SubscribeURL.

Debes invocar esa SubscribeURL para completar la validación.

Luego la suscripción pasa a active y comienza el envío de eventos.

Seguridad

shared_secret_key es obligatoria.

En cada notificación, valida el valor de Signature antes de procesar el payload.

Recomendación: recalcular HMAC-SHA256 con tu shared_secret_key y comparar en tiempo constante.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

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

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Suscripción creada exitosamente (si queda en pending_confirmation, completar validación vía SubscribeURL para activarla)

Body

🟢202

🟠400BadRequestError

🟠401UnauthorizedError

🔴500InternalServerError

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://sandbox.fidi.money/fidix/v1/webhooks/subscriptions' \
--header 'X-Organization-ID: algo' \
--header 'Idempotency-Key: test-key-001' \
--header 'x-api-key: {{x-api-key}}' \
--header 'x-api-key: {{apikey}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://eo7s4xnzwtk2abg.m.pipedream.net",
    "name": "Production Webhook",
    "event_types": [
        "transfer.received",
        "transfer.failed"
    ],
    "shared_secret_key": "super-secret-key-12345"
}'

Ejemplo de Respuesta

201 - Éxito

{
    "id": "8a9b0c1d-2e3f-4a5b-6c7d-8e9f0a1b2c3d",
    "url": "https://webhook.example.com/notifications",
    "event_types": [
        "transfer.received",
        "transfer.failed"
    ],
    "delivery": {
        "type": "aws_sns",
        "signature": "aws_rsa",
        "confirmation_required": true
    },
    "status": "pending_confirmation",
    "created_at": "2026-03-23T14:55:52Z",
    "updated_at": "2026-03-23T14:55:52Z",
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Production Webhook"
}

Modificado en 2026-03-23 17:43:38

Listar Operaciones

Listar Suscripciones

Crear Suscripción Webhook

Flujo de activación#

Seguridad#

Solicitud

Respuestas

Flujo de activación

Seguridad