Los webhooks informan a tu servidor de cada cambio en pagos, compras y cobros. Añade una dirección por proyecto y comprueba la firma en cada llamada.
Añade la dirección
- Abre el proyecto y rellena URL del webhook. Debe ser una dirección https pública.
- Pulsa Guardar ajustes y después Enviar test.ping. El panel muestra si tu servidor lo aceptó.
Qué enviamos
Un POST con un cuerpo JSON: el tipo de evento (por ejemplo deposit.in_hold, deposit.success, deposit.hold_returned, purchase.accepted o payout.paid), si es real o de prueba, y el propio objeto. Todos los tipos de evento están en la referencia de la API.
Comprueba la firma
Cada llamada lleva una cabecera SkinPlata-Signature con una marca de tiempo y una firma HMAC-SHA256 hecha con tu secreto de firma del webhook. Calcúlala a partir del cuerpo sin procesar y compárala antes de fiarte de nada. La referencia de la API tiene ejemplos listos.
Responde rápido
Responde con cualquier estado 2xx en pocos segundos y haz después el trabajo lento. Cualquier otra respuesta cuenta como fallo y reintentamos durante unos dos días.
Acredita con seguridad
- Procesa cada evento una sola vez: el mismo evento puede llegar más de una vez.
- Vuelve a leer el pago desde la API antes de dar valor en tu lado.
- Retira el valor cuando se revierte un pago; consulta Protección de intercambio y liberación.
Cada entrega, su respuesta y sus reintentos aparecen en Webhooks, en el panel. Si no llega nada, consulta Webhooks que no llegan: qué revisar.