1. Webhooks
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • Conceptos Fundamentales
    • Catálogo de APIs
      • Diccionario de Datos - Enumeraciones
      • Autenticación
        • Obtener Token de Acceso
      • Cuentas
        • Crear Cuenta
        • Obtener Cuenta por ID
        • Listar Cuentas por Ledger
        • Actualizar Cuenta
        • Eliminar Cuenta
        • Suspender Cuenta
        • Activar Cuenta
        • Obtener Balance de Cuenta
        • Obtener Cuentas linkeadas
        • Linkear Cuenta Bancaria
        • Deslinkear Cuenta Bancaria
      • Personas
        • Crear Persona
        • Listar Personas
        • Obtener Persona por ID
        • Actualizar datos de persona
        • Eliminar persona (soft delete)
        • Obtener jerarquía de persona
        • Bloquear persona y descendientes
        • Desbloquear persona y descendientes
      • Transacciones y Operaciones
        • Transacciones
          • Crear Transacción
        • Operations
          • Listar Operaciones
      • Webhooks
        • Crear Suscripción Webhook
          POST
        • Listar Suscripciones
          GET
        • Obtener Suscripción
          GET
        • Actualizar Suscripción
          PUT
        • Eliminar Suscripción
          DELETE
      • Ledgers
        • Activar Ledger
        • Deshabilitar Ledger
  • Casos de Uso
    • Cuentas Virtuales
      • Guía de implementación
      • Create Notification
  • Raíz
  1. Webhooks

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#

1.
La suscripción se crea.
2.
Tu endpoint recibirá un mensaje de validación con SubscribeURL.
3.
Debes invocar esa SubscribeURL para completar la validación.
4.
Una vez confirmada, comenzará el envío de eventos a tu endpoint.

Solicitud

Autorización
JWT Bearer
Agregar el parámetro
Authorization
a Encabezados
Ejemplo:
Authorization: ********************
or
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)
Bodyapplication/json

🟢202
🟠400
🟠401
🟠429
🔴500
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox.fidi.money/fidix/v1/webhooks/subscriptions' \
--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 '{
    "url": "https://eo7s4xnzwtk2abg.m.pipedream.net",
    "name": "Production Webhook",
    "event_types": [
        "transfer.received",
        "transfer.failed"
    ]
}'
Respuesta 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": "active",
    "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-06-05 16:43:20
Anterior
Webhooks
Siguiente
Listar Suscripciones
Built with