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

Os webhooks/callbacks permitem que o Localpayment envie notificações em tempo real para o seu servidor sobre eventos como atualizações de transações, alterações no status de pagamentos e muito mais. Este guia irá orientá-lo passo a passo na configuração de webhooks no seu Business Portal do Localpayment.

## Por que usar callbacks?

> [card] Atualizações de transações em tempo real
>
> Receba notificações instantâneas sobre alterações no status do pagamento, confirmações de transações e atualizações de processamento assim que elas ocorrerem.

> [card] Integração automatizada de fluxo de trabalho
>
> Acione processos automatizados em seu sistema com base em eventos de pagamento, permitindo o processamento de pedidos e a comunicação com o cliente de forma integrada.

> [card] Monitoramento de segurança aprimorado
>
> Receba alertas imediatos sobre atividades suspeitas, transações falhas ou eventos de segurança para proteger sua empresa e seus clientes.

***

## Pré-requisitos

Antes de começar, certifique-se de ter:

**Requisitos de acesso**

* Credenciais válidas para o [Business Portal Localpayment](https://ui.v3.localpayment.com/login).
* Conta de usuário com [permissões de configurações de segurança](https://docs.localpayment.com/pt-br/docs/user-roles-and-permissions.md).

**Requisitos técnicos**

* Um endereço URL de servidor publicamente acessível que pode receber solicitações HTTP POST.
* Capacidade do servidor de processar e responder a notificações de webhook.

***

## Caminho de navegação

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

***

## Guias passo a passo

### Webhooks de URL

1. Acesse o módulo **Configurações**.
2. Em Configurações, selecione a seção **Clientes**.
3. Clique na opção **Editar** para abrir as configurações da sua conta.
4. Nas configurações da sua conta, localize e selecione a aba **Notificações**.
5. Selecione **Retornos de chamada** no menu "Notificações".
6. Selecione a aba **URL** para configurar notificações webhook em tempo real para o seu servidor.
7. Clique no botão **Adicionar**.
8. Insira a **URL** do endpoint do seu servidor que receberá as notificações do webhook.
9. Selecione o campo **País** e todos os países disponíveis serão exibidos.
10. Selecione uma **Conta**. Este campo lista todas as suas contas Localpayment para o país selecionado. Se você escolher **Todas** no campo **País**, também deverá selecionar **Todas** no campo **Conta**.
11. Se a sua integração exigir cabeçalhos personalizados, clique no botão **Adicionar Cabeçalho**.

    11.1 Para cada cabeçalho, especifique sua **Chave** e seu **Valor** correspondente.
12. Finalize o processo clicando em **Salvar** e uma mensagem de confirmação será exibida.

Acesse o módulo **Configurações**.

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

Em Configurações, selecione a seção **Clientes**.

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

Clique na opção **Editar** para abrir as configurações da sua conta.

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

Nas configurações da sua conta, localize e selecione a aba **Notificações**.

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

Selecione **Retornos de chamada** no menu "Notificações".

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

Selecione a aba **URL** para configurar notificações webhook em tempo real para o seu servidor.

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

Clique no botão **Adicionar**.

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

Insira a **URL** do endpoint do seu servidor que receberá as notificações do webhook.

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

Selecione o campo **País** e todos os países disponíveis serão exibidos.

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

Selecione uma **Conta**. Este campo lista todas as suas contas Localpayment para o país selecionado. Se você escolher **Todas** no campo **País**, também deverá selecionar **Todas** no campo **Conta**.

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

Se a sua integração exigir cabeçalhos personalizados, clique no botão **Adicionar Cabeçalho**.

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

Para cada cabeçalho, especifique sua **Chave** e seu **Valor** correspondente.

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

Finalize o processo clicando em **Salvar** e uma mensagem de confirmação será exibida.

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

### Webhooks de e-mail

1. Acesse o módulo **Configurações**.
2. Em Configurações, selecione a seção **Clientes**.
3. Clique na opção **Editar** para abrir as configurações da sua conta.
4. Nas configurações da sua conta, localize e selecione a aba **Notificações**.
5. Selecione **Retornos de chamada** no menu "Notificações".
6. Selecione a aba **E-mail** para configurar as notificações por e-mail.
7. Clique no botão **Adicionar**.
8. Insira o endereço de **e-mail** que receberá as notificações do webhook.
9. Selecione o campo **País** e todos os países disponíveis serão exibidos.
10. Selecione uma **Conta**. Este campo lista todas as suas contas Localpayment para o país selecionado. Se você escolher **Todas** no campo **País**, também deverá selecionar **Todas** no campo **Conta**.
11. Selecione um **Tipo de transação** entre as opções disponíveis: Wire In ou Wire Out.
12. Finalize o processo clicando em **Salvar** e uma mensagem de confirmação será exibida.

Acesse o módulo **Configurações**.

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

Em Configurações, selecione a seção **Clientes**.

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

Clique na opção **Editar** para abrir as configurações da sua conta.

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

Nas configurações da sua conta, localize e selecione a aba **Notificações**.

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

Selecione **Retornos de chamada** no menu "Notificações".

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

Selecione a aba **E-mail** para configurar as notificações por e-mail.

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

Clique no botão **Adicionar**.

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

Insira o endereço de **e-mail** que receberá as notificações do webhook.

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

Selecione o campo **País** e todos os países disponíveis serão exibidos.

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

Selecione uma **Conta**. Este campo lista todas as suas contas Localpayment para o país selecionado. Se você escolher **Todas** no campo **País**, também deverá selecionar **Todas** no campo **Conta**.

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

Se a sua integração exigir cabeçalhos personalizados, clique no botão **Adicionar Cabeçalho**.

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

Selecione um **Tipo de transação** entre as opções disponíveis: Wire In ou Wire Out.

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

Finalize o processo clicando em **Salvar** e uma mensagem de confirmação será exibida.

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

***

## Gerenciando seus Webhooks

### Modificando Webhooks Existentes

1. Clique no ícone **Editar** para a configuração de webhook desejada.
2. Atualize o URL/e-mail do webhook, os cabeçalhos de autenticação (pares chave/valor), as configurações de notificação ou o tipo de transação.
3. Clique em **Salvar** para aplicar as alterações.

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

### Histórico do Webhook

1. Clique no ícone **Histórico** do webhook desejado.
2. Os detalhes do webhook e um histórico de alterações (incluindo o editor, a ação e a data) serão exibidos.

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

### Removendo Webhooks

1. Clique no ícone **Excluir** ao lado do webhook que deseja remover.
2. Confirme a ação clicando em **OK**.
3. O webhook será imediatamente desativado e removido da sua configuração.

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

***

> **Precisa de ajuda?** Se tiver dúvidas sobre este processo ou qualquer outra funcionalidade, nossa [equipe de suporte](mailto:support@localpayment.com) está à sua disposição. Podemos ajudar com a resolução de problemas, planejamento de integração e otimização.


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