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
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í.
Hostovaná brána /pay/...
Nemusíte programovat vlastní QR stránku ani párování – vše zařídí naše brána.
returnUrl.REST API na 2 endpointy
Jedno volání pro založení platby, druhé pro ověření stavu po návratu na e-shop.
X-Api-Key.orderId přímo k platbě.Začněte přijímat platby na e-shopu ještě dnes
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).
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" }
}'{
"checkoutId": "chk_x7k9m2",
"paymentUrl": "https://qrcheck.cz/pay/chk_x7k9m2",
"status": "pending",
"amount": 1490,
"vs": "2200000042",
"paidAt": null,
"metadata": {
"orderId": "405021"
}
}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.
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"{
"checkoutId": "chk_x7k9m2",
"paymentUrl": "https://qrcheck.cz/pay/chk_x7k9m2",
"status": "paid",
"amount": 1490,
"vs": "2200000042",
"paidAt": 1794391200000,
"metadata": {
"orderId": "405021"
}
}pendingČeká na platbuPlatba 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ýškoZákazník poslal vyšší než požadovanou částku.
underpaidNedoplatekDorazila pouze část platby – objednávku zatím nevyřizujte.
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.
Máte dotaz? Rádi pomůžeme
Jsme vám k dispozici pro zodpovězení dotazů k nastavení, napojení banky i provozu.



