Ir al contenido

Herramienta para equipos de pagos

Pix Webhook Inspector

Pega un evento Pix para detectar problemas de estructura, idempotencia y seguridad antes de que afecten a tu operativa.

Tu navegador analiza el payload de forma local. No se envía a AZPay.

Payload del webhook

Entrega anterior (A, opcional)
Listo para analizar.

Diagnóstico

Pega un JSON para iniciar el análisis.

Qué comprueba la herramienta

El endToEndId identifica el Pix. El txid vincula el cobro cuando está presente. Confirma la recepción con tu PSP y contabilízala una sola vez. Banco Central do Brasil · API Pix 2.10.0 · WebhookPixBody

Haz una comprobación rápida para crear consumidores de webhooks más predecibles. La firma debe verificarse en el servidor.

Idempotencia

Busca identificadores estables para evitar que un mismo pago se procese dos veces.

Estados del pago

Ayuda a definir transiciones como pending, confirmed, failed y refunded de forma explícita.

Seguridad

Señala posibles tokens, contraseñas o datos de tarjeta antes de compartir un ejemplo.

Un consumidor de webhooks seguro en cualquier entorno

Registra el ID del evento antes de ejecutar efectos secundarios, responde pronto y procesa el evento de forma así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);

Preguntas frecuentes

¿Envía la herramienta mi payload a algún servidor?

No. El análisis básico se realiza en el navegador. Evita pegar tokens, claves, datos personales o datos de tarjeta reales.

¿Valida el Inspector la firma del webhook?

Validar la firma requiere el secreto y el algoritmo de tu integración. El Inspector señala problemas de estructura y seguridad. Realiza la verificación criptográfica en tu backend.

¿Por qué es importante la idempotencia en los pagos?

Los webhooks pueden reenviarse tras un tiempo de espera o un fallo de red. Un identificador estable permite reconocer eventos ya procesados y evitar cobros, registros de pago o entregas duplicados.

¿Quieres conectar tus pagos?

Descubre cómo encaja AZPay Checkout en tu experiencia de pago.

Conoce Checkout