Webhooks
Desarrolladores
Los puntos de conexión que llamamos cuando ocurre un evento en su lado — un pago completado, un pago fallido, una disputa abierta.
Sin punto de conexión, su integración tiene que consultar la plataforma. Con uno, los desenlaces se le envían, firmados.
Añadir un punto de conexión
Una URL https, y la lista de eventos que le interesan. Ningún evento marcado = todos.
El secreto de firma se muestra una sola vez, al crearlo.
Renovar un secreto sin romper nada
Es una maniobra en dos tiempos, y es deliberado:
- Renovar añade un segundo secreto. Los dos son válidos — su punto de conexión tiene tiempo de aceptar el nuevo.
- Promover hace del nuevo el único válido.
Promueva solo cuando su punto de conexión acepte el nuevo secreto. Las entregas firmadas con el antiguo dejan de ser verificables de inmediato.
Un secreto promovido ya no es legible aquí. Perdido, se renueva — no se recupera.
Comprobar
Enviar un evento de prueba hace una entrega real a sus puntos de conexión activos y muestra el código de respuesta y la duración. Si nada está suscrito al evento, la pantalla lo dice en lugar de dejarle creer que tuvo éxito.
Pausar detiene las entregas sin borrar la configuración.
El detalle entrega por entrega está en Registros de desarrollador; el formato de los mensajes se describe en la guía Webhooks.
— /dashboard/webhooks