POST com JSON quando o status de uma transação muda.
Eventos disponíveis
Pendente
Cobrança PIX aguardando pagamento (
waiting_payment).Pago
Pagamento confirmado (
paid).Recusado
Pagamento recusado (
refused).Cancelado
Transação cancelada (
cancelled).Reembolsado
Pagamento reembolsado (
refunded).Formas de receber eventos
Postback da transação
Postback da transação
Informe
postbackUrl ao criar a transação. Essa URL recebe todos os status da transação, independentemente das configurações do painel.Webhooks cadastrados no painel
Webhooks cadastrados no painel
Cadastre URLs no painel, escolha os eventos recebidos e, quando necessário, configure
application-id e webhook-secret.Requisitos do endpoint
- Utilize uma URL HTTPS pública.
- Aceite requisições
POSTcomContent-Type: application/json. - Responda em até 10 segundos.
- Retorne HTTP
2xxdepois de persistir o evento. - Processe eventos de forma idempotente.
5xx ou 429, a entrega é repetida automaticamente com backoff. Seu endpoint deve aceitar eventos duplicados com segurança.
Cabeçalhos enviados
O
postbackUrl informado diretamente na transação não envia application-id nem webhook-secret.