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

# Webhooks

Los webhooks/callbacks permiten a Localpayment enviar notificaciones en tiempo real a tu servidor sobre eventos como actualizaciones de transacciones, cambios en el estado de los pagos y más. Esta guía te mostrará los pasos para configurar los webhooks en tu Business Portal de Localpayment.

## ¿Por qué usar funciones de devolución de llamada?

> [card] Actualizaciones de transacciones en tiempo real
>
> Recibe notificaciones instantáneas sobre cambios en el estado de los pagos, confirmaciones de transacciones y actualizaciones de procesamiento en el momento en que se produzcan.

> [card] Integración automatizada de flujos de trabajo
>
> Activa procesos automatizados en tu sistema en función de los eventos de pago, lo que permitirá una gestión de pedidos y una comunicación con el cliente fluidas.

> [card] Monitoreo de seguridad mejorado
>
> Recibe alertas inmediatas sobre actividades sospechosas, transacciones fallidas o incidentes de seguridad para proteger tu negocio y a tus clientes.

***

## Requisitos previos

Antes de comenzar, asegúrate de tener:

**Requisitos de acceso**

* Credenciales válidas para el [Business Portal de Localpayment](https://ui.v3.localpayment.com/login).
* Cuenta de usuario con [permisos de configuración de seguridad](https://docs.localpayment.com/es/docs/user-roles-and-permissions.md).

**Requisitos técnicos**

* Una URL de endpoint de servidor de acceso público que puede recibir solicitudes HTTP POST.
* Capacidad del servidor para procesar y responder a las notificaciones de webhook.

***

## Ruta de navegación

```
Side Menu → Configurations → Client → Edit → Notifications → Callbacks
```

***

## Guías paso a paso

### Webhooks de URL

1. Navega al módulo de **Configuraciones**.
2. Dentro de Configuraciones, selecciona la sección **Clientes**.
3. Haz clic en la opción **Editar** para abrir la configuración de tu cuenta.
4. En la configuración de tu cuenta, localiza y selecciona la pestaña **Notificaciones**.
5. Selecciona **Devoluciones de llamada** en el menú Notificaciones.
6. Selecciona la pestaña **URL** para configurar las notificaciones webhook en tiempo real a tu servidor.
7. Haz clic en el botón **Agregar**.
8. Introduce la **URL** del endpoint de tu servidor que recibirá las notificaciones del webhook.
9. Selecciona el campo **País** y aparecerán todos los países disponibles.
10. Selecciona una **cuenta**. Este campo muestra todas tus cuentas de Localpayment para el país seleccionado. Si eliges **Todas** en el campo **País**, también debes seleccionar **Todas** en el campo **Cuenta**.
11. Si tu integración requiere encabezados personalizados, haz clic en el botón **Agregar encabezado**.

    11.1 Para cada encabezado, especifica su **Clave** y su **Valor** correspondiente.
12. Finaliza el proceso haciendo clic en **Guardar** y aparecerá un mensaje de confirmación.

Navega al módulo de **Configuraciones**.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/e0b31e6797aead93d5f3d643acea2d370f242310b5d15c244d018a0149694733-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=702d9cce60ed4a61538a74a7b055ff28)

Dentro de Configuraciones, selecciona la sección **Clientes**.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/dcbec917bfb334d8d72674be038956c53bd79126c7b4116c1d3f83f7800e2bff-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=562df275f6933883832b321f01afefce)

Haz clic en la opción **Editar** para abrir la configuración de tu cuenta.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/027aec6709a8f0aac50c7e16fa033d93b4edb231017628644905e8a9f8576309-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=349fe1926b9b871500710d0377d43ce4)

En la configuración de tu cuenta, localiza y selecciona la pestaña **Notificaciones**.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/4d08e9dbc51a8395f2992417b5cfe042de70179130d1016ec0f874d03a74cc22-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=82ff363723c0e33540a7d54044893d64)

Selecciona **Devoluciones de llamada** en el menú Notificaciones.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/37f155413c859dab45f093cdfc4d7121fa7070c0473c5d8d8d81931d9845621a-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=1656d1545ed2862e54d1b2b4ddba7775)

Selecciona la pestaña **URL** para configurar las notificaciones webhook en tiempo real a tu servidor.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/ad92d010058af5e0859b44957e83877a3316f5f6bacc1f5b8d9d81d2d4c53985-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=b95574357e4898efcaed28b8483ae2c0)

Haz clic en el botón **Agregar**.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/ee764e5c0363c5d6d6b2fce20e119b80634e676b826632a1dbdf20fc4f45d0e8-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=59cd61bc6343f7bf4d9c28492f02f77c)

Introduce la **URL** del endpoint de tu servidor que recibirá las notificaciones del webhook.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/d2de9c6ee624ec6f1c7f118ca3ff36b91ced9edcd967cbf3442a9d2ce83b5d05-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=dd948f89a12fb3ad0cb47d24eb559d3b)

Selecciona el campo **País** y aparecerán todos los países disponibles.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/87891b9ea3dabc9297cbb52d36fa16cf1b7fc534a6f6a6713518ae3cbafe86ca-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=c136bcc4cb02404a8624ecac70c7d806)

Selecciona una **cuenta**. Este campo muestra todas tus cuentas de Localpayment para el país seleccionado. Si eliges **Todas** en el campo **País**, también debes seleccionar **Todas** en el campo **Cuenta**.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/7cd3ccf505405c240392bcf845f1ac5432fdb5d5133de80679835ed2bbc4ceed-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=70674180597e9c8534fcd641a3a13728)

Si tu integración requiere encabezados personalizados, haz clic en el botón **Agregar encabezado**.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/b321a49b21bb9001c0cac332ac9ca6e23f6a9b0aabad95d847fd461c460c19dd-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=b1233c2a4dfbf392ef01c93afe0cd3d0)

Para cada encabezado, especifica su **clave** y su **valor** correspondiente.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/aa92b2b6181eb5ea8cbb134201e568de9f4040b00b84ddea53ec3fdcbb5e42ad-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=cc68f9515bd2067ecb02c3a77877512f)

Finaliza el proceso haciendo clic en **Guardar** y aparecerá un mensaje de confirmación.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/b08e2c0f9072fcc37108bd56987959c85c6f0de8a33f2d582e696b90b9eb2bf7-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=ceae7f2e3b7e5d91ce4d44132bb93b40)

### Webhooks de correo electrónico

1. Navega al módulo de **Configuraciones**.
2. Dentro de Configuraciones, selecciona la sección **Clientes**.
3. Haz clic en la opción **Editar** para abrir la configuración de tu cuenta.
4. En la configuración de tu cuenta, localiza y selecciona la pestaña **Notificaciones**.
5. Selecciona **Devoluciones de llamada** en el menú Notificaciones.
6. Selecciona la pestaña **Correo electrónico** para configurar las notificaciones por correo electrónico.
7. Haz clic en el botón **Agregar**.
8. Introduce la dirección de **correo electrónico** que recibirá las notificaciones del webhook.
9. Selecciona el campo **País** y aparecerán todos los países disponibles.
10. Selecciona una **cuenta**. Este campo muestra todas tus cuentas de Localpayment para el país seleccionado. Si eliges **Todas** en el campo **País**, también debes seleccionar **Todas** en el campo **Cuenta**.
11. Selecciona un **tipo de transacción** entre las opciones disponibles: Wire In o Wire Out.
12. Finaliza el proceso haciendo clic en **Guardar** y aparecerá un mensaje de confirmación.

Navega al módulo de **Configuraciones**.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/e0b31e6797aead93d5f3d643acea2d370f242310b5d15c244d018a0149694733-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=702d9cce60ed4a61538a74a7b055ff28)

Dentro de Configuraciones, selecciona la sección **Clientes**.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/dcbec917bfb334d8d72674be038956c53bd79126c7b4116c1d3f83f7800e2bff-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=562df275f6933883832b321f01afefce)

Haz clic en la opción **Editar** para abrir la configuración de tu cuenta.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/027aec6709a8f0aac50c7e16fa033d93b4edb231017628644905e8a9f8576309-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=349fe1926b9b871500710d0377d43ce4)

En la configuración de tu cuenta, localiza y selecciona la pestaña **Notificaciones**.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/4d08e9dbc51a8395f2992417b5cfe042de70179130d1016ec0f874d03a74cc22-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=82ff363723c0e33540a7d54044893d64)

Selecciona **Devoluciones de llamada** en el menú Notificaciones.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/37f155413c859dab45f093cdfc4d7121fa7070c0473c5d8d8d81931d9845621a-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=1656d1545ed2862e54d1b2b4ddba7775)

Selecciona la pestaña **Correo electrónico** para configurar las notificaciones por correo electrónico.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/b6580eb5673b98b773e24c6099ae878e8584d606b8eb76315df29a62bb5fa4bf-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=4ec8e97aeb8c92418bdcc823c9d79dc0)

Haz clic en el botón **Agregar**.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/8acfbe0b701e036b065fc4576d1dea5c9025340e23475bccaac07686126e61fa-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=da433d25d78c5cfd9f9703f57420041f)

Introduce la dirección de **correo electrónico** que recibirá las notificaciones del webhook.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/40633b8b00291715a00124c7c526077c76b81569fa564afc760c9e60fd0bcf8f-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=ea91bbdfbb921846baa36c616ce0fdd6)

Selecciona el campo **País** y aparecerán todos los países disponibles.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/87891b9ea3dabc9297cbb52d36fa16cf1b7fc534a6f6a6713518ae3cbafe86ca-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=c136bcc4cb02404a8624ecac70c7d806)

Selecciona una **cuenta**. Este campo muestra todas tus cuentas de Localpayment para el país seleccionado. Si eliges **Todas** en el campo **País**, también debes seleccionar **Todas** en el campo **Cuenta**.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/6e42b87ea452de4e2bc3e1e323cad37b4079961ce6174d30c96fd32cc729d614-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=4d5da253b9b964f119b3a26baefc289c)

Si tu integración requiere encabezados personalizados, haz clic en el botón **Agregar encabezado**.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/b321a49b21bb9001c0cac332ac9ca6e23f6a9b0aabad95d847fd461c460c19dd-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=b1233c2a4dfbf392ef01c93afe0cd3d0)

Selecciona un **tipo de transacción** entre las opciones disponibles: Wire In o Wire Out.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/5ef53ce2b19d348525e45b65602cf0ca36256dc1ef3070c9bfda2b10a3c34986-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=08f3891e1ba19c33382f5381f012fb23)

Finaliza el proceso haciendo clic en **Guardar** y aparecerá un mensaje de confirmación.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/d225ed44e2106e2422465c1443ba3c246eabfbdf5175405fdba52d6aeec5a18b-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=1922be4d8df82f6c1c9032ace801a1b5)

***

## Gestionar tus webhooks

### Modificación de webhooks existentes

1. Haz clic en el icono **Editar** para la configuración de webhook deseada.
2. Actualiza la URL/correo electrónico del webhook, los encabezados de autenticación (pares clave/valor), la configuración de notificaciones o el tipo de transacción.
3. Haz clic en **Guardar** para aplicar los cambios.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/8334fe244d3c16d0dd99bf45fd1f144019a93ce209018e6b78c2ca1fc48f8b45-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=480d29e8170d5250123b61f363e43999)

### Historia de los webhooks

1. Haz clic en el icono de **Historial** del webhook deseado.
2. Se mostrarán los detalles del webhook y un historial de cambios, incluyendo el editor, la acción y la fecha.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/0fb0055d633782722a106200d2896fb36f073cb14cbe496b3adf515a72efcce8-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=1104278283b1a6df80ef0b870e9cdeae)

### Eliminación de webhooks

1. Haz clic en el icono **Eliminar** que aparece junto al webhook que deseas eliminar.
2. Confirma la acción haciendo clic en **Aceptar**.
3. El webhook se desactivará inmediatamente y se eliminará de tu configuración.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/dfa5e6a4b4f83d82a89b33ddddd80e8a9f5a74c202def80466a843eb7d4d5138-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=9dd74d0d95872d0c1bd32a58b648225f)

***

> **¿Necesitas ayuda?** Si tienes preguntas sobre este proceso o cualquier otra función, nuestro [equipo de soporte](mailto:support@localpayment.com) está a tu disposición. Podemos ayudarte con la resolución de problemas, la planificación de la integración y la optimización.


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