Přejít na hlavní obsah
Karta Platba na objednávce

Objednávky > [Objednávka] > Platba

​
Definice

TWICE rozděluje pohyb peněz do čtyřúrovňové hierarchie: Objednávka → Pokladna → Platba → Transakce. Vedle plateb stojí faktury – zúčtovací dokumenty, které fakturují přesouvané peníze. Vrácení peněz, kauce, částečné platby a rozdělené platební metody se na tuto hierarchii mapují přímočaře.

​
Kde to použiji?

  • Konfigurace platebních poskytovatelů v Nastavení → Platby
  • Účtování zákazníkům u pokladny (online nebo v administraci)
  • Zpracování kaucí na rentálních objednávkách
  • Vystavení plného nebo částečného vrácení peněz proti strženým transakcím
  • Sesouhlasení reportů s výplatami vašeho platebního poskytovatele
  • Budování API integrací, které potřebují zaznamenávat ruční platby nebo vystavovat vrácení peněz

​
Klíčové vlastnosti

​
Hierarchie plateb

Objednávka obsahuje všechny řádkové položky (co si zákazník kupuje nebo pronajímá). Každý platební tok začíná objednávkou.Více: Životní cyklus objednávky
reprezentují to, co zákazník kupuje nebo pronajímá. Každá řádková položka odkazuje na:
  • Inzerát (nebo jednorázovou řádkovou položku)
  • Množství
  • Cenovou informaci
  • Přidružené skladové položky (pro vyřízení)
se vytvoří, jakmile je objednávka připravena k platbě. Pokladnu lze vytvořit:
  • Ručně z objednávky (personálem)
  • Samoobslužně online (zákazníkem)
Pokladna na storefrontu začíná od košíku a při dokončení vytvoří objednávku; pokladna v administraci nebo z odkazu se otevírá proti existující objednávce. V obou případech může mít pokladna připojeno více plateb.
je propojena s pokladnou a vytváří daňový doklad. Klíčové vlastnosti:
  • Vždy odkazuje na řádkové položky objednávky
  • Může obsahovat více transakcí
  • Pokladna může mít více plateb (např. kauce + doplatek)
je obdobou účtenky z platebního terminálu. Jedna platba může obsahovat více transakcí.Příklady:
  • Rozdělená platba: polovina dárkovou kartou, polovina hotovostí → 2 transakce, 1 platba
  • Vrácení peněz: původní stržená transakce na původní platbě, transakce vrácení na propojené platbě vrácení

​
Typy a metody plateb

Každá platba má typ a metodu popisující způsob úhrady:
  • Typy: sale (platba), deposit_auth, deposit_capture, refund, refund_reverse (vrácení peněz stržené zpět k vám), cancel a expire (autorizace, která vypršela nevyzvednutá).
  • Ruční metody: Platba v prodejně (PAY_STORE) a obchodníkem pojmenované vlastní metody (CUSTOM) pro platby na místě a offline.
  • Online metody: karta, Apple Pay a Google Pay přes Stripe; karta, Apple Pay a Google Pay přes Adyen. MobilePay a Pay by Bank jsou metody Stripe zapnuté jen pro vybrané obchodníky.
Jak platba postupuje, prochází fázemi autorizace, strhnutí a vrácení peněz. Každá platba nese jemnější stav – nevyřízená, úspěšná, částečně vrácena, vrácena, vrácení zrušeno, stornována nebo vypršela. Čip platby na objednávce vše shrnuje do binárního Zaplaceno / Nezaplaceno (paymentStatus: PAID / UNPAID).

​
Vizualizace hierarchie

​
Faktury

Vedle plateb vystavuje TWICE faktury – zúčtovací dokumenty v modelu peněz. Řádek platby bez odkazu na fakturu jsou nezaúčtované peníze: jakmile prodej uspěje, TWICE z těchto řádků vyrazí fakturu a zpětně na ně otiskne id vyražené faktury. Řádek platby, který už na fakturu odkazuje, místo toho zúčtuje daný řádek faktury a nic nevyráží. status faktury sleduje jen životní cyklus dokumentu: draft, open, cancelled, uncollectible (ruční odpis) nebo scheduled (nadcházející cyklus předplatného, počítaný na vyžádání – nikdy neukládaný). Zaplacenost se odvozuje samostatně z capturedTotal a refundedTotal faktury a zrcadlí slovník plateb: nezaplaceno, částečně zaplaceno, zaplaceno, částečně vráceno, vráceno. Výnos z předplatného pochází z řádků faktury: každý fakturační cyklus přidá řádek nesoucí id předplatného a fakturační období, takže jedna faktura může fakturovat několik předplatných. Viz Předplatná.

​
Vztahy

  • Platba vždy odkazuje na řádkové položky, za které účtuje – nikdy na celou objednávku v abstraktní rovině.
  • Platba vrácení peněz se zpětně propojuje s původní platbou přes originalPaymentId. Řádky vrácení interně vedou k původním řádkům platby (originalPaymentLineId); toto propojení na úrovni řádku není vystaveno v API.
  • Kauce je samostatný objekt platby na objednávce (s vlastními součty authorised, captured, refunded a cancelled), takže se pohyby kauce nikdy nemíchají s pohyby platby.
  • Platební poskytovatel (Adyen, Stripe, ruční) určuje, jaké metody jsou dostupné a zda je podporována autorizace/strhnutí.

​
Životní cyklus

​
Od objednávky k platbě

1

Objednávka vytvořena

Vytvoří se objednávka obsahující . Objednávky lze vytvořit ručně v administraci nebo automaticky z online pokladny zákazníka.Více: Životní cyklus objednávky
2

Pokladna vytvořena

Pokladna se vytvoří buď z košíku na storefrontu – v takovém případě její dokončení vytvoří objednávku – nebo ručně z administrace proti již existující objednávce.Pokladna nemusí pokrývat celou objednávku. Odkaz na pokladnu nese vámi vybrané řádky, každý s vlastní částkou k vybrání, a zákazník vidí jen tyto řádky. Tato částka je strop: pokladna nikdy nenaúčtuje víc, než řádek v okamžiku platby ještě dluží.Více: Objednávka - Platba
3

Platba (platby) vytvořena(y)

V rámci pokladny se vytvoří jedna nebo více plateb:
  • Každá platba odkazuje na konkrétní řádkové položky
  • Každá platba vytváří vlastní daňový doklad
  • Více plateb umožňuje scénáře částečné platby (kauce + doplatek, splátky)
4

Transakce zpracovány

Každá platba může obsahovat více transakcí – rozdělené platební metody, vrácení peněz atd.

​
Autorizace a strhnutí

U poskytovatelů, kteří to podporují (Adyen a Stripe u karet), používá TWICE dvoukrokový tok autorizace/strhnutí:
  • Autorizace: zablokuje prostředky na kartě, aniž by je strhla. Používá se u rentálních vyzvednutí, aby obchodník mohl upravit konečnou částku.
  • Strhnutí: vezme autorizované prostředky. Může jít o plné strhnutí, nebo částečné strhnutí za méně, než bylo autorizováno.
  • Zrušení: uvolní autorizaci bez strhnutí. Používá se, když je objednávka stornována před vyzvednutím.
  • Vypršelo: poskytovatel automaticky zrušil blokaci, protože nebyla strhnuta v okně autorizace (u Stripe typicky ~7 dní).

​
Kauce

Kauce jsou samostatný objekt platby vedle hlavní platby. Na objednávce se zobrazují jako vlastní blok s vlastními součty authorised, captured, refunded a cancelled. Dostupnost metody kauce je vázaná na platební metodu – PAY_STORE a vlastní ruční metody podporují ruční kauce, zatímco kartové metody podporují automatické kartové kauce.
Ruční platební metody (platba při vyzvednutí, vlastní metody) jsou u pokladny povoleny, i když objednávka obsahuje kauci. V takovém případě se kauce zpracuje jako ruční kauce. Jen objednávky s automaticky stahovanými předplatnými vyžadují kartovou platební metodu – samotné kauce ne.
Pokud kartová blokace kauce není strhnuta v okně autorizace poskytovatele (u Stripe typicky ~7 dní), poskytovatel ji automaticky zruší. Karta Platby ji zobrazuje jako Vypršelo, na rozdíl od ručního uvolnění, které se zobrazuje jako Zrušeno. Viz sekci Vypršení autorizace v Kaucích.

​
Částečná strhnutí a částečná vrácení peněz

Strženou transakci lze částečně vrátit vícekrát, dokud není vrácena celá. Každé vrácení vytvoří nový záznam platby typu refund propojený s původní platbou přes originalPaymentId. Vrácení peněz může poskytovatel sám stáhnout zpět (refund_reverse) – například když bankovní vrácení selže a peníze se vrátí k vám – a nestržená autorizace, která vyprší, vytvoří záznam expire. Když vystavujete vrácení peněz:
  1. Určíte transakci, která se má vrátit, a celkovou částku.
  2. Volitelně určíte, které řádky platby se mají vrátit a kolik na každý.
  3. TWICE vytvoří platbu vrácení a aktualizuje modificationSummary původní transakce.
Určete přesně, které řádky platby se mají vrátit a v jaké výši. Částky po řádcích musí dát dohromady celkovou vracenou částku. Nastavením částky řádku na null se vrátí celá zbývající vratitelná částka daného řádku.Případ použití: Vrácení jednoho produktu ve víceproduktové objednávce, aniž by se to dotklo ostatních.
Řádky platby zcela vynechte. Vracená částka se rozdělí proporcionálně mezi všechny vratitelné řádky podle jejich zbývajících vratitelných částek. Zaokrouhlovací zbytek jde na nejvyšší řádek.Případ použití: Vystavení paušálního vrácení peněz jako gesta dobré vůle, rovnoměrně rozděleného.
modificationSummary původní transakce sleduje dvanáct polí:
refundedTotal je hrubý a nečistý. Stažené vrácení peněz vám vrátí peníze, takže skutečně vrácená částka je refundedTotal - refundReversedTotal. Čtení samotného refundedTotal vrácení nadhodnocuje.
Vrácení peněz se zpracovávají přes původního platebního poskytovatele. Vrátit lze jen transakce se stavem succeeded a typem capture.

​
Sesouhlasení

U integrovaných poskytovatelů TWICE automaticky spáruje transakce s platbami, propojí platby s pokladnami a objednávkami a aktualizuje stav platby objednávky, jak se transakce dokončují.
U ručních plateb (hotovost, bankovní převod, platformy třetích stran) zaznamenejte platbu a transakci přímo. Použijte pole data platby, metody a externí reference, abyste je namapovali zpět na své účetnictví.
Doklady se generují za platbu, ne za transakci. Jedna platba se dvěma transakcemi (dárková karta + hotovost) stále vytvoří jeden doklad pokrývající obě metody.

​
Podporovaní poskytovatelé

TWICE podporuje dva online platební poskytovatele a ruční tok pro vše ostatní.

​
Online poskytovatelé

Stripe a ruční/offline platby jsou dostupné každému obchodu. Adyen je zapnutý jen pro vybrané obchodníky (stejně jako SumUp pro platby na terminálu na místě) – viz Nastavení plateb.

​
Apple Pay a Google Pay

Na Stripe se Apple Pay a Google Pay aktivují automaticky, jakmile připojíte Stripe a zapnete kartové platby. Neexistuje přepínač v administraci – peněženky se za běhu odvozují z kartové metody. TWICE registruje domény vašeho storefrontu (subdoménu i vlastní domény) u Stripe pro ověření domény Apple Pay. Registrace proběhne automaticky, když:
  • Připojíte svůj účet Stripe
  • Změníte subdoménu svého obchodu
  • Aktivujete vlastní doménu
U pokladny Stripe vykreslí tlačítka peněženek podle zařízení a prohlížeče zákazníka. Apple Pay se zobrazuje v Safari a na zařízeních Apple; Google Pay v Chrome a na Androidu. Obě peněženky podporují opakované platby (předplatná) a kauce – Stripe ukládá podkladovou kartu jako znovupoužitelnou platební metodu.
Apple Pay se nezobrazuje, je-li pokladna vložená v iframe. Google Pay toto omezení neovlivňuje.

​
Ruční / offline platby

Existují dvě ruční metody:
  • Platba v prodejně (PAY_STORE) – vestavěná metoda pro platbu vybranou při vyzvednutí.
  • Vlastní metody (CUSTOM) – metody, které si sami pojmenujete, každá s vlastním popiskem a volitelným popisem. Vytvořte jich, kolik potřebujete – „Bankovní převod”, „Dárková karta”, „Externí POS”.
Použijte je pro hotovost přijatou v prodejně, bankovní převody přijaté mimo TWICE, kartové terminály neintegrované přes Adyen/Stripe a obchodní kredit. Ruční platby stále vytváří daňový doklad, podporují vrácení peněz (zadané ručně) a agregují se do stavu platby objednávky stejně jako online platby.

​
Časté dotazy

Na úrovni platby. Jedna platba = jeden doklad, bez ohledu na to, kolik transakcí danou platbu tvoří. Pokud zákazník zaplatí 120 € rozděleně mezi dárkovou kartu a hotovost v jedné platbě, doklad zobrazí 120 € s podrobným rozpisem obou metod.
Vrácení peněz potřebují vlastní daňové doklady a auditní stopu. Vytvořením propojené platby vrácení (originalPaymentId → původní platba) TWICE zachová původní transakci neměnnou a přitom sleduje řetězec vrácení.
Ano. Nastavte strhávanou částku nižší, než je autorizovaná částka; zbytek se uvolní – částečné strhnutí.
Ne. Kauce používají samostatný objekt platby vedle hlavní platby, každý s vlastním životním cyklem autorizace/strhnutí. Díky tomu zůstává reporting a vracení peněz čisté.
Kartové platby Stripe a Adyen. Apple Pay a Google Pay na Stripe také podporují předplatná – Stripe uloží podkladovou kartu pro opakované platby bez přítomnosti zákazníka. Metody s přesměrováním (MobilePay, Pay by Bank) a ruční metody jsou jen jednorázové.
Čip je souhrn. Za scénou má každá platba jemnější stav – nevyřízená, úspěšná, částečně vrácena, vrácena, vrácení zrušeno, stornována, vypršela; čip redukuje všechny platby na objednávce na binární Zaplaceno / Nezaplaceno (paymentStatus: PAID / UNPAID).

​
Vývojářská reference

Transakce jsou vázané na objednávky. Vrácení peněz a strhnutí žijí pod endpointy payments; konfigurace poskytovatele pod paymentAccounts.

API: Payments

Otevřít endpoint v API referenci.

​
Související články

Životní cyklus objednávky

Status objednávky, platby a vyřízení.

Typy objednávek

Jak typ nákupu utváří platební tok.

Integrace

Připojení Stripe a správa platebních poskytovatelů.

Reporty

Finanční reporty a sesouhlasení.