1. Webhooks
Fidi X Developer Preview
  • Fidi X
    • 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
    • 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
      • Crear Suscripción Webhook
        POST
      • Listar Suscripciones
        GET
      • Obtener Suscripción
        GET
      • Actualizar Suscripción
        PUT
      • Eliminar Suscripción
        DELETE
  • Schemas
    • CreateSubscriptionRequest
    • Person
    • LinkBankAccountRequest
    • PersonHierarchyResponse
    • UpdateAccountRequest
    • UpdateSubscriptionRequest
    • LinkBankAccountResponse
    • BlockPersonDataResponse
    • HTTPValidationError
    • CreateAccountRequest
    • DeliveryInfo
    • TransactionDataResponse
    • AssetResponse
    • AuthResponse
    • WebhookEventType
    • CreateTransactionRequest
    • ErrorResponse
    • AccountResponse
    • BalanceResponse
    • CreatePersonRequest
    • PersonResponse
    • TransactionOperation
    • CreateWebhookSubscriptionRequest
    • WebhookSubscriptionResponse
    • UpdateWebhookSubscriptionRequest
    • SubscriptionResponse
    • LinkBankAccountDataResponse
    • CreateAssetRequest
    • SubscriptionListResponse
    • AssetListResponse
    • WebhookSubscriptionListResponse
    • AccountDetailResponse
    • TransactionCreateResponse
    • WebhookEventTypesResponse
    • LedgerResponse
    • WebhookEventsListResponse
    • WebhookEventRecord
    • PersonDataResponse
    • SimulateExternalTransferRequest
    • PersonListResponse
    • SimulateExternalTransferResponse
    • TransactionResponse
  1. Webhooks

Actualizar Suscripción

PUT
/fidix/v1/webhooks/subscriptions/subscription_id
Actualiza una suscripción existente.
Puedes cambiar url, name, event_types y opcionalmente shared_secret_key.

Importante#

Si actualizas shared_secret_key, valida Signature con la nueva clave para las siguientes notificaciones.
Este endpoint no cambia el contrato de eventos.

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

🟢200
application/json
Suscripción actualizada exitosamente
Body

🟠400BadRequestError
🟠401UnauthorizedError
🟠404NotFoundError
🔴500InternalServerError
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://sandbox.fidi.money/fidix/v1/webhooks/subscriptions/subscription_id' \
--header 'X-Organization-ID;' \
--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://webhook.example.com/notifications/v2",
    "name": "Updated Production Webhook",
    "event_types": [
        "transfer.received",
        "transfer.pending"
    ]
}'
Respuesta Ejemplo de Respuesta
200 - Éxito
{
    "id": "8a9b0c1d-2e3f-4a5b-6c7d-8e9f0a1b2c3d",
    "url": "https://webhook.example.com/notifications/v2",
    "event_types": [
        "transfer.received",
        "transfer.pending"
    ],
    "delivery": {
        "type": "aws_sns",
        "signature": "aws_rsa",
        "confirmation_required": true
    },
    "status": "active",
    "created_at": "2026-03-23T14:55:52Z",
    "updated_at": "2026-03-23T15:15:20Z",
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Updated Production Webhook"
}
Modificado en 2026-03-23 17:44:36
Anterior
Obtener Suscripción
Siguiente
Eliminar Suscripción
Built with