Agregar un endpoint
Panel → Webhooks → agrega tu URL HTTPS y elige los eventos (empieza conpayment.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 resultadomatchedWallet /
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
2xxen 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
paymentIntentIdcomo clave.