Twisto Universal API (zastaralé)
Universal API je API pro platební brány (PSP).
Toto API je zastaralé!
Nové integrace používejte přes PSP API
Twisto „Kup teď, zaplať později“ je platební metoda, která zákazníkům umožní okamžitý nákup jedním kliknutím s platbou až po dodání zboží. Poskytovatel platebních služeb (PSP) od Twisto obdrží plnou platbu poté, co je zboží odesláno. Zákazník splácí na bankovní účet Twisto podle platebních údajů zaslaných e-mailem od Twisto.
Protože Twisto nese riziko splácení zákazníkem, podléhá každá objednávka kontrole úvěruschopnosti v reálném čase. Z toho důvodu máme specifické požadavky na data, která potřebujeme od PSP. Přesné požadavky jsou popsány v krocích integrace níže. Skórování zákazníka je náš interní dynamický proces závislý na externích zdrojích dat shromážděných během kontroly. Z toho důvodu nelze proces plně implementovat na straně PSP — vede ho plně Twisto.
Aplikace PSP slouží jako obecná integrační brána mezi různými poskytovateli platebních služeb a Twisto. Jejím hlavním účelem je umožnit Twisto Pay na platformě PSP pro jeho obchodníky.
Poskytuje společné API pro PSP a uživatelské rozhraní pro zákazníky, které pokrývá celý platební proces od registrace obchodníka a e-shopu, přijetí objednávky zákazníka, doplnění chybějících osobních údajů, souhlasu s obchodními podmínkami, skórování zákazníka vzhledem k objednávce, vypořádání objednávek až po vrácení peněz.
Výsledkem je, že PSP se musí připojit pouze k tomuto API, aby svým obchodníkům a e-shopům nabídl odložené platby a zvýšil tak upsell.
Obecně může mít každý PSP více obchodníků a každý obchodník více e-shopů.
Očekávané chyby
Tabulka chyb, které API může vrátit při vytváření objednávky:
| Stav | Chyby | Data | Popis |
|---|---|---|---|
| 403 | Např. "errors": {"service": ["\"\" is not a valid choice."]} | - | Některá pole v těle požadavku nejsou platná. |
| 403 | "errors": {"non_field_errors": ["Customer has installments blocked"]}} | - | Checkout byl pro tohoto zákazníka zamítnut z důvodu: {{Message}}. |
| 403 | "errors": {"non_field_errors": ["Customer is overdue"]}} | - | Checkout byl pro tohoto zákazníka zamítnut z důvodu: {{Message}}. |
| 403 | "errors": {"non_field_errors": ["Customer has terminated contract"]}} | - | Checkout byl pro tohoto zákazníka zamítnut z důvodu: {{Message}}. |
| 403 | "errors": {"non_field_errors": ["Installments over customer limit"]}} | - | Checkout byl pro tohoto zákazníka zamítnut z důvodu: {{Message}}. |
| 403 | "errors": {"non_field_errors": ["Customer is over monthly installments limit"]}} | - | Checkout byl pro tohoto zákazníka zamítnut z důvodu: {{Message}}. |
| 403 | "errors": {"non_field_errors": ["Unpaid amount not large enough"]}} | - | Částka objednávky není pro tuto platební službu dostatečně vysoká. |
| 400 | "errors": {"non_field_errors": ["Invalid service: Pay in three (2) on psp.Order 123"]}} | - | Zvolená platební služba není dostupná. |
Tok zákazníka
Vypořádání
- Strategie vypořádání se nastavuje na úrovni PSP
- Existují 2 strategie pro refundace a 2 strategie pro platby
- Refundace
- Ruční — refundace PSP odesílá skutečnými bankovními převody
- Dávková — součet refundací se odečte od součtu objednávek z předchozího dne (bez převodu peněz od PSP) — možné jen u hromadných výplat
- Platba
- Jednotlivá bankovní transakce pro každou objednávku
- Hromadné platby — všechny objednávky (a refundace) se agregují a odešlou v jedné bankovní transakci
- Výsledkem jsou dvě obecné strategie vypořádání
- Jedna po druhé — ruční refundace + jednotlivé / hromadné transakce
- Jedna denní dávka — dávkové refundace + hromadné transakce
Strategie vypořádání — jedna po druhé
Strategie vypořádání — jedna denní dávka
Proces refundace
- PSP odešle POST požadavek na Twisto API a zahájí proces refundace
- Refundace se zaregistruje ihned po obdržení požadavku od PSP
- Podle strategie refundace bude refundace plně potvrzena, když
- Ruční strategie refundace — jakmile Twisto obdrží platbu refundace připsanou na účet Twisto
- Dávková strategie refundace — jakmile Twisto vygeneruje a odešle hromadný převod, kde je částka refundací odečtena od částky vypořádání