Criando webhooks
Visão geral
Webhooks no Connect permitem que você receba notificações em tempo real quando eventos específicos ocorrerem em sua conta. Você pode criar e configurar webhooks pelo portal Trust.
Acessando o gerenciamento de webhooks
Faça login no portal Trust:
Acesse o portal Trust e autentique-se com suas credenciais.
Acesse as Configurações de API:
No painel, localize o menu de navegação.
Clique em Configurações (ícone de engrenagem) no menu.
Selecione Configurações de API no menu.
Acessar a seção de Webhooks:
Na página de configurações de API , clique na aba Webhooks .
Esta página exibe todos os seus webhooks existentes com seus status, URLs de payload e ações disponíveis.
Criando um novo webhook
Para criar um novo webhook, siga estas etapas:
Iniciar a criação do webhook:
Clique no botão "+ Novo webhook" no cabeçalho da página.
Configurar as configurações do webhook:
Um Novo webhook modal será exibido, onde você pode configurar as definições do seu webhook.
Configuração básica
URL do payload: Informe a URL para a qual a Certta deve enviar eventos de webhook. Isso deve ser um endpoint HTTPS válido que possa receber solicitações POST.
Segredo: Forneça uma chave secreta que será usada para gerar a assinatura do webhook. Isso permite verificar se as solicitações realmente vieram da Certta.
Configuração de autenticação
Escolha o método de autenticação para o endpoint do seu webhook:
Nenhuma
Nenhuma autenticação será usada ao enviar solicitações de webhook.
Autenticação básica
Forneça credenciais de nome de usuário e senha que serão incluídas nas solicitações de webhook usando Autenticação Básica HTTP.
Autenticação por chave de API
Configure a autenticação por chave de API especificando:
Cabeçalho: O nome do cabeçalho (por exemplo,
X-API-Key)Valor: O valor da chave de API
Seleção de eventos
Escolha quais eventos devem acionar seu webhook:
Enviar tudo
Esta opção enviará todos os eventos disponíveis para o endpoint do seu webhook.
Deixe-me selecionar eventos individuais
Quando você selecionar esta opção, poderá escolher eventos específicos na lista disponível. A interface exibirá todos os eventos atualmente compatíveis, incluindo Eventos de Comunicação, Eventos de Transação e Eventos de Autenticação.
Os eventos mostrados na interface são apenas para fins ilustrativos. A lista real de eventos pode ser diferente, pois novos eventos podem ser adicionados ou eventos existentes podem ser modificados ao longo do tempo. Consulte sempre a interface atual para obter a lista mais atualizada dos eventos disponíveis.
Para obter informações detalhadas sobre cada tipo de evento, sua estrutura e exemplos de payload, consulte a documentação de Eventos.
Ativação
Marque a caixa de seleção "Ativo" para habilitar o webhook imediatamente após a criação. Você sempre pode ativar ou desativar webhooks depois na interface de gerenciamento.
Concluindo a criação do webhook
Após configurar todas as definições:
Revise a configuração do seu webhook
Clique em "Criar webhook" para concluir a configuração
Seu novo webhook aparecerá na lista de webhooks e começará a receber eventos com base na sua configuração
Próximos passos
Após criar seu webhook:
Saiba mais sobre os eventos do webhook para entender os dados que você receberá
Implemente a verificação de assinatura para garantir a autenticidade do webhook
Siga as melhores práticas para um tratamento confiável de webhooks
Atualizado