Registrace obchodníka
Než začnete Twisto implementovat, musíte obchodníka zaregistrovat a nastavit s obchodním týmem Twisto.
Při registraci volíte parametry, které určí:
- Jak budete od Twisto dostávat platby
- Jak budou refundace zpracovány a vypořádány
- Jaké API volání je potřeba k dokončení transakce
- Kdy aktivujete objednávku a transakci dokončíte
Při registraci může obchodník uvést endpoint, který přijímá POST payload pro webhooky se stavem objednávky.
Parametrizace vypořádání
Parametry vypořádání se nastavují na úrovni obchodníka.
Existují 2 strategie pro refundace a 2 strategie pro platby. Obchodník si pro každý účet vybere preferovanou strategii podle potřeb.
Platba
- Hromadná platba (doporučeno) — všechny objednávky (a refundace) se agregují a v dalším vypořádacím cyklu odešlou v jedné bankovní transakci
- Jednotlivé bankovní transakce — Twisto v dalším vypořádacím cyklu odešle samostatnou bankovní transakci pro každou objednávku.
Refundace
- Dávkové refundace (doporučeno) — součet refundací se v dalším vypořádacím cyklu odečte od součtu objednávek (bez převodu peněz od obchodníka) — možné jen při zapnutých hromadných výplatách
- Ruční — refundace obchodník odesílá skutečnými bankovními převody
Výsledkem jsou dvě obecné strategie vypořádání
Jedna denní dávka — dávkové refundace + hromadná transakce
Doporučená strategie

Jedna po druhé — ruční refundace + jednotlivé / hromadné transakce

Potvrzení nákupu ve dvou krocích
Zpracování objednávky u Twisto má dva kroky. Nejprve vytvoříte checkout, aby zákazník potvrdil platební údaje a Twisto schválilo objednávku. V tomto kroku zadáte také informace o objednávce a zákazníkovi. Poté je nutné provést charge a potvrdit platbu ze strany obchodníka.
První API volání při zpracování platby Twisto je volání endpointu /checkouts. Tento požadavek se odešle ve chvíli, kdy si zákazník zvolí Twisto jako platební metodu k transakci.
Tok okamžitého zachycení (Immediate Capture)
V případech, kdy je jisté, že zákazník nákup dokončí, může obchodník při registraci zvolit režim Immediate Capture. V tomto toku:
- K dokončení transakce stačí pouze endpoint
/checkouts. - Twisto automaticky provede capture charge ve chvíli schválení checkoutu — není potřeba volat
/charges. - Prostředky za transakci vám budou vyplaceny v následujícím vypořádacím cyklu.
- Zákazník může začít splácet nákup od tohoto data.
Zachycení pomocí požadavku Charge
Další možností je, že Twisto počká na potvrzení od obchodníka před uvolněním prostředků. Proces používá následující tok:
- K dokončení transakce stačí jedno API volání na endpoint
/charges. - Prostředky za transakci vám budou vyplaceny v následujícím vypořádacím cyklu.
- Zákazník může začít splácet nákup od tohoto data.
Volba mezi okamžitým capture a odloženým charge přes endpoint /charges se provádí při nastavení obchodnického účtu.