Skip to main content
La página Webhooks del plugin Bank Transfer registra los endpoints que reciben los eventos de Bank Transfer. También lista las entregas que fallaron. Para los eventos, la firma y el calendario de reintentos, consulta Webhooks. Cada pantalla de Bank Transfer necesita el permiso bank-transfer: get para verla, post para actuar en ella, patch para cambiar los ajustes y el documento de enrutamiento, y delete para eliminar un webhook. En esta página, Register webhook, Rotate signing secret y Retry delivery necesitan post. Edit, Enable y Disable necesitan patch. Delete necesita delete.

​
Cómo abrir la página

1

Abre Bank Transfer

En la barra lateral de Midaz Module, expande Bank Transfer.
2

Haz clic en Webhooks

Selecciona Webhooks en el submenú.
La página tiene dos pestañas: Registrations y Failed deliveries.

​
Registros

La pestaña Registrations lista tus registros de webhook, 10 por página.

​
Registrar un webhook

1

Abre el formulario

Haz clic en Register webhook.
2

Completa los campos

  • Name: un nombre para el registro.
  • Endpoint URL: la URL que recibe los eventos.
  • Enabled: activado por defecto.
  • Event types: los eventos que quieres recibir. Deja la lista vacía para recibir todos los eventos.
3

Guarda

Haz clic en Save.
4

Copia el secreto de firma

El diálogo Signing secret muestra el secreto una sola vez. Cópialo antes de hacer clic en I’ve saved it. Usa el secreto para verificar la firma de cada entrega.
Si la copia falla, selecciona el secreto y cópialo a mano antes de cerrar el diálogo. Si el diálogo no muestra ningún secreto, el plugin ya entregó ese secreto una vez. Rota el secreto de firma para obtener uno nuevo.

​
Editar un webhook

Haz clic en Edit en las acciones de la fila. Cambia los campos y haz clic en Save. La Console envía solo los campos que cambias.

​
Activar o desactivar un webhook

Haz clic en Disable en las acciones de la fila de un webhook activado, o en Enable en las acciones de la fila de un webhook desactivado.

​
Rotar el secreto de firma

1

Inicia la rotación

Haz clic en Rotate signing secret en las acciones de la fila.
2

Confirma

Haz clic en Rotate signing secret en el diálogo.
3

Copia el nuevo secreto

El diálogo Signing secret muestra el nuevo secreto una sola vez, como en el registro.
La rotación invalida el secreto actual de inmediato. Las entregas fallan la verificación hasta que despliegues el nuevo secreto.

​
Eliminar un webhook

Haz clic en Delete en las acciones de la fila y luego confirma.

​
Entregas fallidas

La pestaña Failed deliveries lista los eventos que el plugin no pudo entregar después de sus reintentos automáticos, 50 por página. Cuando el plugin no expone las rutas de entregas fallidas, la pestaña muestra el mensaje del plugin en lugar de la lista.

​
Reintentar una entrega

1

Inicia el reintento

Haz clic en Retry delivery en las acciones de la fila.
2

Confirma

Haz clic en Retry delivery en el diálogo. El endpoint puede recibir el evento más de una vez.
Si el plugin rechaza el reintento porque la entrega alcanzó su máximo de reintentos manuales, Retry delivery deja de estar disponible en esa fila. Su indicación dice Maximum manual retries reached.

​
Páginas relacionadas

Webhooks

Eventos, verificación de firma y el calendario de reintentos.

Guía para desarrolladores

Código de validación de firma y la lista de verificación de integración.