> ## 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](/es/interfaces/ted-jd/ted-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

***

<Steps>
  <Step title="Abre Bank Transfer">
    En la barra lateral de Midaz Module, expande **Bank Transfer**.
  </Step>

  <Step title="Haz clic en Webhooks">
    Selecciona **Webhooks** en el submenú.
  </Step>
</Steps>

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

<Steps>
  <Step title="Abre el formulario">
    Haz clic en **Register webhook**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Guarda">
    Haz clic en **Save**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Steps>
  <Step title="Inicia la rotación">
    Haz clic en **Rotate signing secret** en las acciones de la fila.
  </Step>

  <Step title="Confirma">
    Haz clic en **Rotate signing secret** en el diálogo.
  </Step>

  <Step title="Copia el nuevo secreto">
    El diálogo **Signing secret** muestra el nuevo secreto una sola vez, como en el registro.
  </Step>
</Steps>

<Warning>
  La rotación invalida el secreto actual de inmediato. Las entregas fallan la verificación hasta que despliegues el nuevo secreto.
</Warning>

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

<Steps>
  <Step title="Inicia el reintento">
    Haz clic en **Retry delivery** en las acciones de la fila.
  </Step>

  <Step title="Confirma">
    Haz clic en **Retry delivery** en el diálogo. El endpoint puede recibir el evento más de una vez.
  </Step>
</Steps>

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

***

<Columns cols={2}>
  <Card title="Webhooks" icon="webhook" horizontal href="/es/interfaces/ted-jd/ted-webhooks">
    Eventos, verificación de firma y el calendario de reintentos.
  </Card>

  <Card title="Guía para desarrolladores" icon="code" horizontal href="/es/interfaces/ted-jd/ted-developer-guide">
    Código de validación de firma y la lista de verificación de integración.
  </Card>
</Columns>


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