Skip to main content

Agregar un endpoint

Panel → Webhooks → agrega tu URL HTTPS y elige los eventos (empieza con payment.confirmed). Recibirás un secreto de firma (whsec_…).

Payload

Verificar la firma

Verifica siempre antes de confiar en cualquier dato:

Eventos

Los payloads de wallet.* y bridge.* incluyen walletId/bridgeTransferId, chain/route, amount, y los hashes de transacción relevantes — con la misma forma que sus respuestas de API en Wallets y Bridge.

Disputas

Se abre una disputa cuando un cliente, desde tu página de checkout, reporta haber enviado fondos que no se confirmaron automáticamente — monto incorrecto, dirección incorrecta, o un envío tardío. Es autoservicio del lado del cliente (reciben al instante un resultado matchedWallet / amountCovered / lateByMinutes), y payment.dispute_opened te da el mismo detalle para que puedas darle seguimiento manual si la verificación automática no lo resuelve — por ejemplo, acreditar un pedido a pesar de un pago ligeramente incompleto, a tu criterio.

Entrega y reintentos

  • Responde 2xx en menos de 10 segundos; cualquier otra cosa cuenta como un fallo.
  • Reintentamos hasta 3 veces con backoff; las entregas y códigos de estado son visibles en el panel.
  • Los manejadores deben ser idempotentes — usa paymentIntentId como clave.