Platební brána & REST API
0% provize

Platební brána pro e-shopy s 0% provizí a přímou platbou

Hostovaná platební brána QR check pro e-shopy s výhodami přímé QR platby bez platební brány třetích stran. Peníze neprochází účtem prostředníka – jdou ihned na váš účet s 0% provizí a po zaplacení se zákazník automaticky vrátí na e-shop.

Získat API klíč zdarma

Součást bezplatného tarifu Základ. Napojení na vlastní web zabere 15 minut.

Platební brána & REST API
0% provize
https://qrcheck.cz/pay/chk_x7k9m2
Hostovaná platební brána s vaším logem a okamžitou kontrolou platbyAutomatické spárování objednávek v reálném čase podle variabilního symbolu
Hostovaná platební brána s vaším logem a okamžitou kontrolou platbyAutomatické spárování objednávek v reálném čase podle variabilního symbolu
Hostovaná platební brána s vaším logem a okamžitou kontrolou platby
Proč vlastní QR brána

0 % provize místo 1,5 % z každé objednávky

Peníze neprochází účtem prostředníka – jdou přímo k vám a máte je k dispozici ihned

01 • Úspora

0 % poplatky & peníze ihned

Běžná karetní brána si bere 1,2–2,5 % + fixní poplatek a drží peníze několik dní.

0 Kč provize: Z objednávky za 2 000 Kč máte celých 2 000 Kč.
Přímý převod: Peníze jdou přímo z banky zákazníka na váš účet.
Bez schvalování: Žádné prověřování obratu ani smlouvy na 20 stran.
02 • Automatizace

Hostovaná brána /pay/...

Nemusíte programovat vlastní QR stránku ani párování – vše zařídí naše brána.

Vlastní značka: Zobrazuje název e-shopu, vaše logo a popis platby.
Unikátní VS: Automaticky generovaný variabilní symbol pro každou platbu.
Auto-návrat: Po zaplacení zákazníka přesměruje zpět na returnUrl.
03 • Vývojáři

REST API na 2 endpointy

Jedno volání pro založení platby, druhé pro ověření stavu po návratu na e-shop.

Čisté JSON API: Funguje v PHP, Node.js, Pythonu i z cURL.
Jednoduchá autorizace: Stačí hlavička X-Api-Key.
Metadata objednávky: Uložte si vlastní orderId přímo k platbě.
Součást tarifu Základ0 Kč / měsíc • 0% provize
Ano0 % provize z každé objednávky
AnoPřímé připsání peněz na váš účet
AnoUnikátní VS bez rizika kolize
AnoMožnost napojení na míru (Shoptet, Pohoda)
REST API Dokumentace

Integrace ve 3 jednoduchých krocích

API klíč najdete po přihlášení v sekci Nastavení ➔ Bankovní účet & API. Předávejte jej v hlavičce X-Api-Key (případně Authorization: Bearer).

1

Vytvoření platby (POST https://qrcheck.cz/api/checkout)

Při dokončení objednávky váš backend zavolá tento endpoint s částkou a návratovou adresou:

amountnumberpovinné

Částka k úhradě v CZK (musí být větší než 0).

descriptionstringvolitelné

Popis platby zobrazený zákazníkovi i ve zprávě QR platby (max. 60 znaků).

returnUrlstringvolitelné

URL vašeho e-shopu, kam se zákazník po úspěšném zaplacení automaticky vrátí.

metadataobjectvolitelné

Až 5 vlastních párů klíč/hodnota (např. orderId), které se vrátí při ověření stavu.

curl -X POST https://qrcheck.cz/api/checkout \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: qrk_k8m2p9_9f86d0818824cafe" \
  -d '{
    "amount": 1490,
    "description": "Objednávka #405021",
    "returnUrl": "https://vas-eshop.cz/objednavka/405021/uspech",
    "metadata": { "orderId": "405021" }
  }'
Response (JSON) · HTTP 200 OK
{
  "checkoutId": "chk_x7k9m2",
  "paymentUrl": "https://qrcheck.cz/pay/chk_x7k9m2",
  "status": "pending",
  "amount": 1490,
  "vs": "2200000042",
  "paidAt": null,
  "metadata": {
    "orderId": "405021"
  }
}
2

Přesměrování zákazníka na platební bránu

Zákazníka přesměrujete na vrácenou adresu paymentUrl (https://qrcheck.cz/pay/chk_x7k9m2). Zobrazí se mu oficiální QR platba s vaším logem, částkou a klikacími údaji pro snadné zkopírování. Jakmile banka peníze připíše, brána zobrazí potvrzení a automaticky ho vrátí na vaši returnUrl.

3

Ověření stavu platby (GET https://qrcheck.cz/api/checkout/:checkoutId)

Po návratu zákazníka na váš e-shop (nebo při kontrole nezaplacených objednávek) ověříte stav platby:

curl https://qrcheck.cz/api/checkout/chk_x7k9m2 \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: qrk_k8m2p9_9f86d0818824cafe"
Response po zaplacení · HTTP 200 OK
{
  "checkoutId": "chk_x7k9m2",
  "paymentUrl": "https://qrcheck.cz/pay/chk_x7k9m2",
  "status": "paid",
  "amount": 1490,
  "vs": "2200000042",
  "paidAt": 1794391200000,
  "metadata": {
    "orderId": "405021"
  }
}
pendingČeká na platbu

Platba byla vytvořena, zákazník ještě neodeslal peníze.

paidZaplaceno

Částka v plné výši byla připsána na váš bankovní účet.

overpaidPřeplatek / Dýško

Zákazník poslal vyšší než požadovanou částku.

underpaidNedoplatek

Dorazila pouze část platby – objednávku zatím nevyřizujte.

Časté dotazy

Otázky k platební bráně a API

Vše podstatné pro majitele e-shopů i vývojáře

Platební brána i REST API integrace jsou součástí bezplatného tarifu Základ (0 Kč měsíčně) a bez jakýchkoliv procentních provizí z obratu. Neplatíte žádné aktivační ani transakční poplatky.

Po přihlášení do aplikace QR check otevřete Nastavení ➔ Bankovní účet & API a klikněte na tlačítko „API a platební brána pro e-shopy“. Klíč má formát qrk_... a posílá se v hlavičce X-Api-Key nebo Authorization: Bearer.

Ne. Legislativa EET 2.0 se vztahuje na kontaktní platby v provozovně. Online platby na dálku v e-shopu evidenci EET 2.0 nepodléhají.

Jakmile zákazník naskenuje QR kód, většina českých bank provede okamžitou platbu do několika vteřin. Brána na /pay/... kontroluje stav každé 3 sekundy a jakmile banka peníze připíše, zákazníka za 3 vteřiny přesměruje na vaši returnUrl.

Ano. Vlastní vývojář bránu napojí přes 2 jednoduché REST endpointy za 15 minut. Pokud chcete integraci na klíč nebo napojení na Shoptet/WooCommerce/Pohodu, ozvěte se nám v rámci tarifu Na míru.

Kontakt

Máte dotaz? Rádi pomůžeme

Jsme vám k dispozici pro zodpovězení dotazů k nastavení, napojení banky i provozu.

Napište nám e-mail
Zavolejte nám