Vai al contenuto

Strumento per i team dei pagamenti

Pix Webhook Inspector

Incolla un evento Pix per individuare problemi di struttura, idempotenza e sicurezza prima che incidano sui pagamenti.

Il browser analizza il payload in locale, senza inviarlo ad AZPay.

Payload del webhook

Notifica precedente (A, facoltativa)
Pronto per l’analisi.

Diagnostica

Incolla un JSON per iniziare.

Cosa verifica lo strumento

L’endToEndId identifica il Pix. Il txid collega la richiesta di pagamento, se presente. Conferma la ricezione con il PSP e registra una sola volta. Banco Central do Brasil · API Pix 2.10.0 · WebhookPixBody

Un rapido controllo aiuta a creare gestori di webhook affidabili. Verifica la firma sul server.

Idempotenza

Cerca identificativi stabili per evitare di elaborare due volte lo stesso pagamento.

Stati del pagamento

Aiuta a definire le transizioni tra pending, confirmed, failed e refunded.

Sicurezza

Segnala possibili token, password o dati delle carte prima di condividere un esempio.

Un gestore sicuro per ogni stack

Registra l’ID prima delle operazioni con effetti collaterali, rispondi subito ed elabora l’evento in modo asincrono.

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);

Domande frequenti

Il payload viene inviato a un server?

No. L’analisi avviene nel browser. Evita di incollare token, chiavi, dati personali o dati di carte reali.

Lo strumento verifica la firma del webhook?

Servono il segreto e l’algoritmo dell’integrazione. Lo strumento segnala problemi di struttura e sicurezza. Esegui la verifica crittografica sul backend.

Perché l’idempotenza è importante nei pagamenti?

Un timeout o un errore di rete può causare un nuovo invio. Un ID stabile permette di riconoscere gli eventi già elaborati ed evitare addebiti, registrazioni o consegne duplicate.

Vuoi integrare i pagamenti?

Scopri come integrare AZPay Checkout nel tuo flusso di pagamento.

Scopri Checkout