Webhook po platbě
Telefon může po každé úspěšné platbě zavolat vámi zvolenou adresu, aby se o ní váš vlastní systém dozvěděl. Není to webhook Stripe: volání přichází z telefonu.
Volat po každé platbě |
Vypínač. |
|---|---|
Adresa |
Adresa HTTPS vašeho příjemce, jako v prvním příkladu. Za hostitelem lze použít proměnné, například {reference}. |
Metoda |
GET, POST nebo PUT. Výchozí je POST. |
Formát těla |
JSON, FORM nebo TEXT. Výchozí je JSON. |
Hlavičky |
Jedna Name: value na řádek, například pro klíč API nebo token. |
Tělo (šablona) |
Tělo s proměnnými. Výchozí je JSON z druhého příkladu s ID platby, referencí, částkou, měnou a časem. |
Podpisový klíč (volitelný) |
Když je nastaven, každé volání nese X-QR2Stripe-Timestamp a X-QR2Stripe-Signature (HMAC-SHA256). |
Kdy se volá: jednou po každé úspěšné platbě, v každém režimu, z telefonu, dokud je aplikace otevřená. Když nejde síť, aplikace zkusí volání znovu, uloží ho do fronty a doručí ho při dalším spuštění aplikace nebo když klepnete na Doručit nyní. Po 10 pokusech se volání vzdá.
Nastavení v aplikaci: Nastavení obchodníka → Webhook po platbě → Nastavit webhook. Zapněte Volat po každé platbě, zadejte adresu, klepněte na Odeslat zkušební volání a na Uložit. Zkušební volání pošle vymyšlenou platbu, takže hned vidíte, jestli ji příjemce přijme.
Příjemcem může být váš server nebo nástroj bez programování (n8n, Make, Zapier) se spouštěčem typu webhook. Odpovězte rychle stavem 2xx; tatáž platba může dorazit dvakrát, proto ji poznávejte podle payment_id.
Proměnné jako {reference}, {amount}, {amount_decimal}, {currency} a {payment_id} doplní údaje o platbě (úplný seznam je ve specifikaci). Výchozí tělo je JSON z druhého příkladu.
Nastavte podpisový klíč, aby váš systém mohl ověřit podpis každého volání, a adresu nezveřejňujte. Bez klíče by vám mohl podvržené volání poslat kdokoli, kdo adresu zná.
Volání přichází z telefonu, ne od Stripe. V inline režimu je amount_from_qr rovno true, což znamená, že částku neověřil žádný server. Před předáním cenného zboží si platbu dohledejte ve Stripe Dashboardu.
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}
}