Webhooks

Programadores

Os pontos de ligação que chamamos quando acontece um evento do seu lado — um pagamento concluído, um pagamento falhado, um litígio aberto.

Sem ponto de ligação, a sua integração tem de consultar a plataforma. Com um, os desfechos são-lhe entregues, assinados.

Adicionar um ponto de ligação

Um URL https e a lista dos eventos que lhe interessam. Nenhum evento marcado = todos.

O segredo de assinatura é mostrado uma só vez, na criação.

Renovar um segredo sem partir nada

É uma manobra em dois tempos, e é deliberado:

1. Renovar acrescenta um segundo segredo. Ambos são válidos — o seu ponto de ligação tem tempo de aceitar o novo.
2. Promover faz do novo o único válido.

Só promova quando o seu ponto de ligação aceitar o novo segredo. As entregas assinadas com o antigo deixam de ser verificáveis de imediato.

Um segredo promovido já não é legível aqui. Perdido, renova-se — não se recupera.

Verificar

Enviar um evento de teste faz uma entrega real aos seus pontos de ligação ativos e mostra o código de resposta e a duração. Se nada estiver subscrito ao evento, o ecrã di-lo em vez de o deixar julgar que teve sucesso.

Pausar para as entregas sem apagar a configuração.

O detalhe entrega a entrega está em Registos de programador; o formato das mensagens é descrito no guia Webhooks.

— /dashboard/webhooks