Desarrolladores · Webhooks

Eventos firmados
para cada pago.

Añade un endpoint en Ajustes → API y webhooks, elige tus eventos y verifica cada envío con tu secreto.

Envíos · https://yourapp.com/hooks

14:02payment.succeeded200

14:05subscription.renewed200

14:09dispute.created500 · reintentando

14:10dispute.created200

Cada intento registrado

SIGNED WITHHMACSHA-256 en cada envío

EVENT TYPES9pagos, disputas, suscripciones

FAILED DELIVERIES↻reintentados y registrados

FirmadoCada envío lleva una cabecera UP-Signature: el HMAC-SHA256 de la marca de tiempo y el cuerpo.

ReintentadoLos envíos fallidos se reintentan y cada intento queda registrado.

Tus eventosElige los eventos que necesites, o todos.

JSONCada evento tiene un id, un tipo, una fecha de creación y sus datos.

Evento	Cuándo
`payment.succeeded`	Se ha aprobado un pago
`payment.voided`	Se ha anulado un pago
`refund.succeeded`	Se ha hecho un reembolso
`dispute.created`	Una nueva disputa
`dispute.updated`	Una disputa ha cambiado
`subscription.created`	Un nuevo suscriptor
`subscription.renewed`	Se ha cobrado una renovación
`subscription.payment_failed`	Una renovación ha fallado
`subscription.cancelled`	Una suscripción ha terminado

UP-Signature: t=1762340000,v1=5f8c…

// Verify: HMAC-SHA256(secret, t + "." + body) == v1

Preguntas de los comercios

¿Cómo verifico un envío?

Calcula el HMAC-SHA256 de la marca de tiempo y el cuerpo con tu secreto y compáralo con la cabecera UP-Signature.

¿Puedo elegir qué eventos recibo?

Sí, elige los eventos que necesites o todos.