> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestión de webhooks

> Registra los endpoints que reciben los eventos de Bank Transfer, rota su secreto de firma y reintenta las entregas fallidas, desde el plugin Bank Transfer en Lerian Console.

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](https://docs.lerian.studio/es/interfaces/ted-jd/ted-webhooks.md).

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.

| Columna | Descripción |
| - | - |
| Name | Nombre del registro. |
| Endpoint | URL que recibe los eventos. |
| Status | **Enabled** o **Disabled**. |
| Events | Número de tipos de evento que recibe el registro. Cuando el registro no lista ningún tipo de evento, la columna muestra **All events**. |
| Updated | Cuándo cambió el registro por última vez. |
| Actions | **Edit**, **Enable** o **Disable**, **Rotate signing secret** y **Delete**. |

### 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.

> [!WARNING]
>
> 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.

| Columna | Descripción |
| - | - |
| Event | El tipo de evento. |
| Transfer | La transferencia del evento. |
| Failure | Por qué falló la entrega. |
| Automatic retries | Número de reintentos automáticos. |
| Manual retries | Número de reintentos manuales. |
| Failed at | Cuándo falló la entrega. |
| Actions | **Retry delivery**. |

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

***

> [card] [Webhooks](https://docs.lerian.studio/es/interfaces/ted-jd/ted-webhooks.md)
>
> Eventos, verificación de firma y el calendario de reintentos.

> [card] [Guía para desarrolladores](https://docs.lerian.studio/es/interfaces/ted-jd/ted-developer-guide.md)
>
> Código de validación de firma y la lista de verificación de integración.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.