Ir para o conteúdo

Ferramenta para times de pagamentos

Pix Webhook Inspector

Cole um evento Pix e encontre problemas de estrutura, idempotência e segurança antes que eles cheguem à sua operação.

Seu payload é analisado localmente no navegador e não é enviado para a AZPay.

Payload do webhook

Entrega anterior (A, opcional)
Pronto para analisar.

Diagnóstico

Cole um JSON para começar a análise.

O que a ferramenta verifica

O endToEndId identifica o Pix. O txid vincula a cobrança quando presente. Confirme o recebimento no PSP e registre a baixa uma única vez. Banco Central do Brasil · API Pix 2.10.0 · WebhookPixBody

Um diagnóstico rápido para ajudar sua equipe a construir consumidores de webhook mais previsíveis. A ferramenta não substitui a validação da assinatura no servidor.

Idempotência

Procura identificadores estáveis para evitar que o mesmo pagamento seja processado duas vezes.

Estados do pagamento

Ajuda a tornar transições como pending, confirmed, failed e refunded explícitas.

Segurança

Sinaliza possíveis tokens, senhas ou dados de cartão antes que um exemplo seja compartilhado.

Consumidor seguro, em qualquer stack

Registre o ID do evento antes de executar efeitos colaterais, responda rapidamente e processe o evento de forma assíncrona.

for (const pix of payload.pix) {
  await db.transaction(async tx => {
    if (await tx.insertReceiptIfAbsent(pix.endToEndId)) {
      await tx.enqueueReconciliation(pix);
    }
    for (const refund of pix.devolucoes ?? []) {
      await tx.reconcileRefundOnce(refund.rtrId, refund.status);
    }
  });
}
return response(200);

Perguntas frequentes

A ferramenta envia meu payload para algum servidor?

Não. A análise básica acontece no navegador. Ainda assim, evite colar tokens, chaves, dados pessoais ou dados de cartão reais.

O Inspector valida a assinatura do webhook?

Não sem conhecer o segredo e o algoritmo da sua integração. Ele alerta sobre estrutura e segurança; a verificação criptográfica deve acontecer no seu backend.

Por que idempotência é importante em pagamentos?

Webhooks podem ser reenviados quando há timeout ou falha de rede. Um identificador estável permite reconhecer o evento já processado sem duplicar cobrança, baixa ou entrega.

Pronto para conectar pagamentos?

Veja como o Checkout da AZPay se encaixa na experiência de pagamento da sua operação.

Conheça o Checkout