Vai al contenuto
QR code to Stripe paymentsDocumentazione QR2Stripe

← Tutte le guide

Webhook dopo il pagamento

Il telefono può chiamare un indirizzo a vostra scelta dopo ogni pagamento riuscito, così il vostro sistema ne viene a conoscenza. Non è il webhook di Stripe: la chiamata proviene dal telefono.

Chiama dopo ogni pagamento L'interruttore.
Indirizzo L'indirizzo HTTPS del vostro ricevitore, come nel primo esempio. Dopo l'host si possono usare variabili come {reference}.
Metodo GET, POST o PUT. Il valore predefinito è POST.
Formato del corpo JSON, FORM o TEXT. Il valore predefinito è JSON.
Intestazioni Una Name: value per riga, ad esempio per una chiave API o un token.
Corpo (modello) Il corpo con le variabili. Il predefinito è il JSON del secondo esempio, con l'ID del pagamento, il riferimento, l'importo, la valuta e l'ora.
Segreto di firma (facoltativo) Se impostato, ogni chiamata porta X-QR2Stripe-Timestamp e X-QR2Stripe-Signature (HMAC-SHA256).

Quando viene chiamato: una volta dopo ogni pagamento riuscito, in ogni modalità, dal telefono finché l'app è aperta. Se la rete non funziona, l'app riprova, mette la chiamata in coda e la consegna al successivo avvio o quando toccate Consegnale ora. Dopo 10 tentativi la chiamata viene abbandonata.

Configurarlo nell'app: Impostazioni dell'esercente → Webhook dopo il pagamento → Configura il webhook. Attivate Chiama dopo ogni pagamento, inserite l'indirizzo, toccate Invia chiamata di prova e Salva. La chiamata di prova invia un pagamento inventato, così vedete subito se il ricevitore lo accetta.

Il ricevitore può essere il vostro server o uno strumento no-code (n8n, Make, Zapier) con un trigger di tipo webhook. Rispondete subito con uno stato 2xx; lo stesso pagamento può arrivare due volte, quindi riconoscetelo con payment_id.

Variabili come {reference}, {amount}, {amount_decimal}, {currency} e {payment_id} inseriscono i dati del pagamento (l'elenco completo è nella specifica). Il corpo predefinito è il JSON del secondo esempio.

Impostate un segreto di firma perché il vostro sistema possa verificare la firma di ogni chiamata, e non rendete pubblico l'indirizzo. Senza, chiunque conosca l'indirizzo potrebbe inviarvi una chiamata falsificata.

La chiamata proviene dal telefono, non da Stripe. In modalità inline amount_from_qr è true, cioè nessun server ha verificato l'importo. Prima di consegnare merce di valore, cercate il pagamento nella Dashboard di 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}
}