Pular para o conteúdo principal
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?

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.

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.

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


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.

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.


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.

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.

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.

Precisa de ajuda? Se tiver dúvidas sobre este processo ou qualquer outra funcionalidade, nossa equipe de suporte está à sua disposição. Podemos ajudar com a resolução de problemas, planejamento de integração e otimização.


Última modificação em 10 de novembro de 2026