Como configurar webhooks e ver o histórico de entregas

O webhook é um aviso automático que a Quibly Pay manda para o seu sistema quando um pagamento é confirmado. Hoje o evento enviado é o de transação paga (transaction.paid).

Como cadastrar um webhook

1. Vá em Desenvolvedor > Credenciais de API.
2. No card Webhooks, informe a URL do endpoint. Ela precisa começar com https://.
3. Clique em Adicionar.
4. Copie o Segredo do webhook que aparece. Ele serve para o seu sistema conferir que o aviso veio mesmo da Quibly Pay. Sem segredo, não enviamos nada.
5. Clique em Enviar teste para mandar um aviso de teste. O resultado aparece no histórico.

Cada aviso vai assinado nos cabeçalhos X-Quibly-Signature e X-Quibly-Timestamp. Como validar a assinatura, com exemplos em Node.js, Python e PHP, está na documentação: https://app.quiblypay.com/docs.

Gerenciar seus webhooks

Em cada endereço cadastrado você pode:

• Pausar ou Ativar o envio.
• Enviar teste.
• Gerar novo segredo: o segredo atual deixa de valer. Atualize o seu sistema para não rejeitar os próximos avisos.
• Remover: paramos de enviar avisos para essa URL.

Ver o histórico de entregas

1. Vá em Desenvolvedor > Histórico de webhooks.
2. Veja cada tentativa de aviso: evento, transação, status, data de criação, última tentativa e próxima tentativa.
3. Clique numa entrega para ver o corpo enviado e a resposta do seu sistema.
4. Use a busca por Transação ou URL e o filtro de Status.

Quando o envio falha

Se o seu sistema não responder com sucesso, tentamos de novo automaticamente algumas vezes, em intervalos crescentes. Você também pode reenviar pelo histórico, inclusive todas as entregas com falha de uma vez.

Boa prática

Antes de liberar um pedido, confirme o pagamento consultando a transação pela API. Não entregue o produto só porque o comprador voltou para o seu site.