1. Webhooks
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • 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
      • Obtener jerarquía de persona
      • Bloquear persona y descendientes
      • Desbloquear persona y descendientes
      • Actualizar datos de persona
      • Eliminar persona (soft delete)
    • Transacciones
      • Crear Transacción
      • Create Notification
    • Operaciones
      • Listar Operaciones
    • Webhooks
      • Formato de Notificaciones Webhook
      • Crear Suscripción Webhook
        POST
      • Listar Suscripciones
        GET
      • Obtener Suscripción
        GET
      • Actualizar Suscripción
        PUT
      • Eliminar Suscripción
        DELETE
  • Schemas
    • UnlinkAccountResponse
    • AccountListResponse
    • CreateSubscriptionRequest
    • UpdateAccountRequest
    • Person
    • LinkBankAccountRequest
    • PersonHierarchyResponse
    • HTTPValidationError
    • UpdateSubscriptionRequest
    • LinkBankAccountResponse
    • BlockPersonDataResponse
    • CreateTransactionRequest
    • CreateAccountRequest
    • AccountResponse
    • DeliveryInfo
    • BalanceResponse
    • TransactionDataResponse
    • AssetResponse
    • AuthResponse
    • CreatePersonRequest
    • PersonResponse
    • ErrorResponse
    • TransactionOperation
    • CreateWebhookSubscriptionRequest
    • WebhookSubscriptionResponse
    • WebhookEventType
    • SubscriptionResponse
    • UpdateWebhookSubscriptionRequest
    • LinkBankAccountDataResponse
    • CreateAssetRequest
    • SubscriptionListResponse
    • TransactionCreateResponse
    • AccountDetailResponse
    • WebhookSubscriptionListResponse
    • AssetListResponse
    • WebhookEventTypesResponse
    • LedgerResponse
    • WebhookEventsListResponse
    • PersonDataResponse
    • WebhookEventRecord
    • SimulateExternalTransferRequest
    • PersonListResponse
    • SimulateExternalTransferResponse
    • TransactionResponse
  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
🟠400BadRequestError
🟠401UnauthorizedError
🔴500InternalServerError
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-05-20 19:43:09
Anterior
Formato de Notificaciones Webhook
Siguiente
Listar Suscripciones
Built with