Obchod · Košík a checkout
Košík, který počítá
za váš frontend
Pro vývojáře headless e-shopů. Frontend jen vykresluje, co vrátí API: položky, ceny, dopravu, platby a jejich povolené kombinace. Pravidla checkoutu zůstávají na serveru a v administraci.
- Anonymní i přihlášený košík přes jedno ID
- Jen kombinace dopravy a platby, které dávají smysl
- Voucher ověříte ještě před odesláním objednávky
Registrace zdarma, API klíč vytvoříte v administraci.
// GET /api/v1/cart/detail?apiKey=…&cartId=b411056d…
// Košík vrací i dopravu, platby a jejich povolené kombinace
{
"id": "b411056d304d9y6mHe2SoMFBL2Apxfnb",
"currency": "CZK",
"priceTotal": 1078,
"items": [
{
"label": "Espresso blend 1 kg",
"productCode": "espresso-blend",
"variantCode": "espresso-blend-1kg",
"quantity": 1
}
],
"deliveryList": [
{ "code": "packeta", "name": "Zásilkovna", "price": 79 },
{ "code": "gls", "name": "GLS na adresu", "price": 129 }
],
"paymentList": [
{ "code": "comgate", "name": "Platba kartou", "price": 0 },
{ "code": "cod", "name": "Dobírka", "price": 39 }
],
"deliveryAndPaymentCombinations": [
{ "deliveryCode": "packeta", "paymentCode": "comgate" },
{ "deliveryCode": "gls", "paymentCode": "comgate" },
{ "deliveryCode": "gls", "paymentCode": "cod" }
]
}- Košík přes APIPřidání produktu nebo varianty, změna množství, odebrání.
- Doprava a platbaCeny a povolené kombinace nastavené v administraci.
- Výdejní místaZásilkovna v košíku, GLS ParcelShopy přes vyhledávání.
- VoucheryKontrola platnosti s důvodem odmítnutí.
Proč košík z BizKitHub
Checkout je místo, kde se ztrácí peníze
Každá chyba v košíku znamená nedokončenou objednávku. Logiku dopravy, plateb a slev přitom vývojáři obvykle píšou znovu pro každý projekt.
Dnes
- Ceny dopravy a platby natvrdo ve frontendu
- Zákazník zvolí dobírku k dopravě, která ji neumí
- Neplatný slevový kód se pozná až po odeslání
- Přihlášený zákazník a anonymní košík jsou dva světy
S BizKitHub
- Ceny a metody se mění v administraci, frontend se nepřepisuje
- API vrací jen povolené kombinace dopravy a platby
- Voucher se ověří předem a vrátí přesný důvod odmítnutí
- Košík se pomocí identity naváže na přihlášeného zákazníka
Doprava a platba
Frontend nabídne jen to, co jde dohromady
Způsoby dopravy, platby a jejich ceny nastavíte v administraci. Košík vrací seznam obou a tabulku povolených kombinací, takže checkout nikdy nenabídne nesmysl.
- Cena dopravy a platby u každé metody
- Povolené kombinace dopravy a platby
- Výběr výdejního místa Zásilkovny přímo v košíku
- Vyhledání GLS ParcelShopů a boxů podle adresy
| Doprava | Karta online | Převod | Dobírka |
|---|---|---|---|
| Zásilkovna · 79 Kč | Ano | Ano | Ne |
| GLS na adresu · 129 Kč | Ano | Ano | Ano |
| Osobní odběr · 0 Kč | Ano | Ne | Ne |
Vouchery v checkoutu
Zákazník se dozví, proč kód neplatí
Než zákazník objednávku odešle, ověříte kód voucheru. Odpověď řekne, jestli kód existuje, v jakém je stavu a proč by ho objednávka odmítla. Pro přihlášeného zákazníka se zkontroluje i jednorázové použití na účet.
- Neexistuje, neaktivní, ještě neplatí, vypršel
- Vyčerpaný limit použití
- Už použitý tímto zákazníkem
- Kód určený jen pro stránku uplatnění voucheru
// Ověření kódu před odesláním objednávky
GET /api/v1/voucher/analyze?apiKey=…&code=vanoce25
&redeemContext=order&identityId=9jq49ZE1…
// Odpověď s důvodem odmítnutí
{
"exists": true,
"code": "VANOCE25",
"type": "percentage",
"value": "25",
"isValid": false,
"status": "expired",
"rejectionReason": "expired"
}Z košíku objednávka
Jedno volání a košík je objednávka
Objednávku vytvoříte z košíku jedním voláním. Odpověď vrátí číslo objednávky, odkaz na stránku objednávky, platební odkaz a skóre rizika. Košík se vyprázdní a zboží se zarezervuje na skladu.
- Doprava, výdejní místo a vouchery v jednom požadavku
- Platba kreditem zákazníka, nebo jen penězi
- Poznámka zákazníka a návratová URL po platbě
- Atribuce z Meta reklam uložená k objednávce
- 1POST /cart/buyEspresso blend 1 kg, 1 ks
- 2GET /cart/detailDoprava, platby, kombinace
- 3GET /voucher/analyzeVITEJTE10 platí
- 4POST /shop/order/createObjednávka 26000412, riziko 3/100
- 5Přesměrování na payLinkPlatba kartou, návrat na děkovací stránku
Košíky v administraci
Vidíte košíky, které nedošly k pokladně
Administrace ukáže všechny rozpracované košíky: kolik jich je, kolik má položky, kolik patří přihlášeným zákazníkům a kolik peněz v nich leží. U každého košíku je obsah, zvolená doprava a platba i zeměpisné údaje návštěvy.
Co všechno umí
Checkout bez vlastní logiky na frontendu
Varianty v košíku
Do košíku jde konkrétní varianta produktu s obrázkem a cenou.
Změna množství
Množství nastavíte, nulou položku odeberete.
Přihlášený zákazník
S identitou zákazníka se košík naváže na jeho účet.
Ceny s DPH
Položky nesou cenu s DPH i bez DPH v měně košíku.
Skutečná IP zákazníka
Při volání ze serveru předáte IP návštěvníka pro geolokaci a riziko.
Rezervace skladu
Po vytvoření objednávky se zboží rezervuje, nezaplacené se uvolní.
Hotová platební stránka
Objednávka vrátí odkaz na platbu i na stránku objednávky.
Kredit zákazníka
Objednávku lze uhradit kreditem a zbytek penězi.
Swagger
Všechny endpointy košíku s příklady požadavků a odpovědí.
Jak začít
Checkout ve třech krocích
- 01
Nastavte dopravu a platbu
V administraci zvolíte metody, ceny a povolené kombinace.
- 02
Vytvořte API klíč
Klíč uložte na server, do prohlížeče nepatří.
- 03
Napojte košík
Podle Swaggeru: košík, voucher a vytvoření objednávky.
Pro koho
Kde se hotový košík hodí
Headless e-shopy
Next.js, Nuxt nebo Astro frontend nad hotovým checkoutem.
Mobilní aplikace
Nativní košík volaný přes váš backend.
Agentury
Stejný checkout pro e-shopy více klientů.
Napojení
Co checkout umí obsloužit
- Comgate
- GoPay
- Stripe
- Zásilkovna
- GLS
- Meta Conversions API (atribuce)
- REST API
Propojené moduly
Funguje nad stejnými daty jako zbytek firmy
E-shop
Headless e-shop přes API. Vlastní frontend, hotový backend.
Objednávky
Celý život objednávky od košíku po zaplacení a expedici.
Vouchery
Slevové kódy, dárkové poukazy a jejich čerpání.
Platební brány
GoPay, Comgate a Stripe. Karta, převod i opakované platby.
Doprava
Zásilkovna, GLS, způsoby dopravy a sledování zásilek.
REST API
Veřejné API se Swaggerem nad každým modulem.
Časté otázky
Na co se ptáte u košíku
Jak se košík pozná mezi požadavky?
Podle cartId. První volání bez cartId vrátí nový košík a jeho ID si uložíte třeba do cookie.
Jak navážu košík na přihlášeného zákazníka?
Po přihlášení přes zákaznické API dostanete identitu zákazníka. Když ji pošlete při přidání do košíku, košík se naváže na jeho účet.
Kde se počítá cena?
Na serveru. Košík vrací cenu položek a ceny dopravy a platby, konečnou cenu objednávky včetně voucherů a kreditu spočítá vytvoření objednávky.
Co když zákazník objednávku nezaplatí?
Rezervace zboží na skladu má časový limit. Nezaplacené rezervace se samy uvolní pro další zákazníky.
Posíláte data do Meta?
Ne. Atribuci (fbc, fbp, URL) jen uložíme k objednávce a vrátíme ji v detailu. Odeslání do Meta Conversions API je na vašem serveru.
Napojte košík ještě dnes
Založte si účet zdarma, nastavte dopravu a platbu a vytvořte API klíč.