Webhooks

Os eventos

• Parceiros: criado, atualizado, apagado, estado alterado, nível alterado, gestor alterado.
• Métodos de pagamento: criado, atualizado.
• Pedidos de formulário: criado, atualizado, apagado.
• Conversões: criada, atualizada, estado alterado.
• Acertos e pagamentos: acerto criado, estado do pagamento alterado.
• Ofertas: criada, atualizada, apagada; acesso concedido, acesso retirado.
• Postbacks: falhado.
• White labels: criado, atualizado, apagado.

Criar um

1. Configurações › Programadores › Webhooks › Novo webhook: o URL do seu endpoint e os eventos.
2. Enviar só quando (opcional): regras sobre os campos do registo, todas ou alguma, comparando com um valor, uma lista ou outro campo.
3. O que enviar: Compatível (formas curtas que uma integração existente espera) ou Registo completo (cada campo, com valores antes e depois nas alterações). O exemplo atualiza-se à medida que escolhe.
4. Cabeçalhos extra, se o seu endpoint precisar.

Verificar a assinatura

Cada chamada tem um cabeçalho Signature: o HMAC-SHA256 do corpo com o segredo de assinatura do seu webhook. O segredo é mostrado uma vez ao criar o webhook; Novo segredo substitui-o.

Envios

• Uma chamada a que o seu servidor não responde bem é repetida.
• O registo de envios mostra cada chamada, as tentativas e o que foi enviado; Enviar de novo repete uma.
• Enviar teste envia um evento com o seu último registo real (ou um exemplo).
• Após 20 falhas seguidas, o webhook pausa-se sozinho e recebe um alerta. Corrija o endpoint e depois Retomar.