Webhook tras el pago
El teléfono puede llamar a una dirección de su elección después de cada pago correcto, para que su propio sistema se entere. No es el webhook de Stripe: la llamada procede del teléfono.
Llamar tras cada pago |
El interruptor. |
|---|---|
Dirección |
La dirección HTTPS de su receptor, como en el primer ejemplo. Después del host pueden usarse variables como {reference}. |
Método |
GET, POST o PUT. Por defecto es POST. |
Formato del cuerpo |
JSON, FORM o TEXT. Por defecto es JSON. |
Cabeceras |
Una Name: value por línea, por ejemplo para una clave de API o un token. |
Cuerpo (plantilla) |
El cuerpo con variables. Por defecto es el JSON del segundo ejemplo, con el ID del pago, la referencia, el importe, la divisa y la hora. |
Secreto de firma (opcional) |
Si se establece, cada llamada lleva X-QR2Stripe-Timestamp y X-QR2Stripe-Signature (HMAC-SHA256). |
Cuándo se llama: una vez tras cada pago correcto, en todos los modos, desde el teléfono mientras la aplicación está abierta. Si no hay red, la aplicación reintenta la llamada, la guarda en una cola y la entrega al volver a iniciarse o cuando toca Entregarlas ahora. Tras 10 intentos la llamada se abandona.
Configurarlo en la aplicación: Ajustes del comercio → Webhook tras el pago → Configurar el webhook. Active Llamar tras cada pago, introduzca la dirección, toque Enviar llamada de prueba y Guardar. La llamada de prueba envía un pago inventado, así que ve enseguida si el receptor lo acepta.
El receptor puede ser su propio servidor o una herramienta sin programación (n8n, Make, Zapier) con un disparador de tipo webhook. Responda rápido con un estado 2xx; el mismo pago puede llegar dos veces, así que reconózcalo por payment_id.
Variables como {reference}, {amount}, {amount_decimal}, {currency} y {payment_id} rellenan los datos del pago (la lista completa está en la especificación). El cuerpo por defecto es el JSON del segundo ejemplo.
Establezca un secreto de firma para que su sistema pueda comprobar la firma de cada llamada, y no publique la dirección. Sin él, cualquiera que conozca la dirección podría enviarle una llamada falsificada.
La llamada procede del teléfono, no de Stripe. En modo inline amount_from_qr es true, lo que significa que ningún servidor verificó el importe. Antes de entregar mercancía valiosa, busque el pago en el Dashboard de Stripe.
https://example.com/hook
{
"event": "payment.succeeded",
"payment_id": "{payment_id}",
"reference": "{reference}",
"description": "{description}",
"amount": {amount},
"currency": "{currency}",
"merchant": "{merchant}",
"site": "{site}",
"paid_at": "{paid_at}",
"amount_from_qr": {amount_from_qr}
}