Přejít k obsahu
QR code to Stripe paymentsDokumentace QR2Stripe

← Všechny návody

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