Começando com Webhooks
Há duas partes para configurar o Event Webhook: uma URL que você fornece e um processo interno do PEP que faz uma solicitação POST para essa URL. Isso significa que você deve ter um servidor web configurado para aceitar solicitações POST na URL que você fornece.
Uma lista de eventos que você pode configurar para serem enviados como parte do conteúdo da solicitação POST para a URL fornecida.
Requisitos:
- Você deve ter um servidor web com uma URL pública que aceite solicitações HTTP POST
- As solicitações HTTP POST devem retornar um código de status HTTP 202 Accepted
- Certifique-se de que nenhum limite de taxa de API esteja definido
- Implementar o whitelist adequado dos endereços IP do PEP fornecidos em sua solicitação de integração
Configurando Webhooks
Agora que você tem todos os requisitos, você pode visitar nossa interface administrativa e registrar uma nova URL de webhook. Em configurações do sistema, navegue até a seção Webhooks e clique em Adicionar Novo:
Na janela de configuração do webhook, registre sua URL e forneça um nome amigável e configure os eventos que você precisa receber na solicitação POST:
- Nome: Adicione um nome amigável para ajudar a diferenciar seus webhooks.
- URL de Callback: Adicione a URL onde o Gamanza PEP deve enviar os dados. Essa URL pode ser o endpoint do seu servidor, um endpoint fornecido por uma ferramenta de dados de terceiros que você está usando ou uma URL de teste de uma ferramenta como o "Ngrok".
- Eventos: Selecione os tipos de eventos que você gostaria de receber dados sobre em cada carga útil da solicitação de webhook.
- Clique em Salvar para armazenar a nova configuração do Event Webhook.
Depois de salvar a configuração, você receberá uma notificação com a chave de assinatura:
Certifique-se de armazenar a Chave de Assinatura de forma segura. Ela só é visível uma vez e, quando você fechar a janela, não poderá vê-la novamente.