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}
}