Saltar al contenido principal
La sección Webhook configura notificaciones salientes para eventos de transferencia. Cuando está habilitada, el plugin envía actualizaciones sobre transferencias a un endpoint HTTPS que usted controla, para que los sistemas downstream puedan reaccionar casi en tiempo real sin consultar la Consola. El encabezado de la sección muestra una insignia Enabled o Disabled según el alternador de abajo.

​
Acceder a la sección

1

Abrir Settings

En la barra lateral de Bank Transfer, haga clic en Settings.
2

Expandir Webhook

Haga clic en el encabezado de la sección para expandirla.

​
Campos

​
Webhook Enabled

Alternador que activa o desactiva la entrega del webhook. Cuando está deshabilitado, los campos Endpoint URL y Signing Secret permanecen editables pero inactivos — el plugin no enviará ninguna solicitud hasta que el alternador esté activado.

​
Endpoint URL

La URL HTTPS que recibirá las solicitudes del webhook (por ejemplo https://example.com/webhook). Editable solo cuando el webhook está habilitado.

​
Signing Secret

Un secreto compartido usado para firmar los payloads del webhook, de modo que su endpoint pueda verificar la autenticidad. Almacenado como secreto: una vez guardado, el campo muestra puntos de marcador de posición en lugar del valor. Déjelo vacío al guardar para mantener el secreto existente sin cambios. Editable solo cuando el webhook está habilitado.
Los payloads del webhook pueden contener información sobre transferencias, montos y contrapartes. Siempre termine el endpoint con HTTPS, valide la firma en cada solicitud y rechace los payloads que no coincidan con la firma esperada.

​
Guardar cambios

Haga clic en Save en la barra de herramientas en la parte superior de la página. Cada cambio se registra en la pestaña Settings History. El Signing Secret se almacena pero se muestra como •••• en el historial, así que el hecho de un cambio es auditable sin exponer el secreto en sí.

​
Consejos

  • Al habilitar el webhook por primera vez, apúntelo a un endpoint de prueba (por ejemplo un request bin) para verificar la forma del payload antes de conectarlo a sistemas de producción.
  • Rote el signing secret periódicamente. Cuando lo rote, actualice tanto el plugin como su servicio receptor en la misma ventana para evitar eventos perdidos.
  • Si su receptor se vuelve no disponible, considere deshabilitar el webhook temporalmente en lugar de dejar un endpoint roto — esto evita fallos ruidosos y mantiene el Settings History más limpio.