Configuração de Webhook
Localização: Configurações → Pagamentos → Webhook
Localização:Configurações → Pagamentos → Webhook
Webhooks permitem que a QuantaPay notifique seu servidor em tempo real quando um pagamento é concluído.
Campos
| Campo | Descrição |
|---|---|
| URL do Webhook | O endpoint HTTPS no seu servidor que receberá solicitações POST quando eventos de pagamento ocorrerem. Deve ser um URL acessível publicamente. |
| Chave Secreta do Webhook | Segredo gerado automaticamente incluído no payload JSON do webhook como o campokey. Use isso para verificar se os webhooks recebidos são genuinamente da QuantaPay. |
Configuração
- Insira o URL do seu endpoint de webhook (por exemplo,
https://yoursite.com/webhook/quantapay) - AChave Secreta do Webhooké gerada automaticamente. Clique no botão de atualização para regenerar, se necessário.
- Salvar configurações.
Como Funciona
Quando um pagamento é concluído (statusC), a QuantaPay envia uma solicitação HTTP POST para o seu URL de Webhook com:
- Um corpo JSON contendo
{ "key": "your-secret", "transaction": { ... } } - Verifique se o campo
keykey corresponde à sua Chave Secreta do Webhook para confirmar a autenticidade
Para obter o formato completo do payload do webhook, o código de verificação de assinatura e as práticas recomendadas, consulteReferência da API: Webhooks.
Testando
Para testar seu webhook:
- Crie uma sessão de checkout de teste via API
- Conclua um pequeno pagamento
- Verifique os logs do seu servidor para o webhook de entrada
Dica: Use um serviço comowebhook.sitedurante o desenvolvimento para inspecionar os payloads de webhook recebidos.