Volání API a platební toky

Pro lepší pochopení fungování API a pořadí volání použijte diagram níže:

Volání API

sequenceDiagram actor Customer autonumber note over Customer: Checkout process Customer->>Eshop: purchase goods activate Eshop Eshop->>Merchant's Server: create checkout deactivate Eshop activate Merchant's Server Merchant's Server->>Twisto: CheckoutCreate (POST) activate Twisto Twisto->>Merchant's Server: CheckoutCreate response deactivate Twisto Merchant's Server->> Customer: redirect to Twisto Gateway deactivate Merchant's Server activate Customer Customer ->> Twisto: redirected Twisto Gateway webpage deactivate Customer activate Twisto Twisto ->> Twisto: risk evaluation Twisto ->> Merchant's Server: redirect to checkout.redirect_uri deactivate Twisto opt asynchronous noticiations enabled note over Customer: Checkout <br/>status update Twisto ->> Merchant's Server: webhook (checkout.status) end opt immediate capture not enabled note over Customer: Charge Merchant's Server ->> Twisto: ChargeCreate (POST) activate Merchant's Server activate Twisto Twisto ->> Merchant's Server: ChargeCreate response deactivate Twisto deactivate Merchant's Server end opt refund note over Customer: Refund Customer ->> Eshop: returns goods activate Eshop Eshop ->> Merchant's Server: reports a return deactivate Eshop activate Merchant's Server Merchant's Server ->> Twisto: RefundCreate (POST) activate Twisto Twisto ->> Merchant's Server: RefundCreate response deactivate Twisto deactivate Merchant's Server end

Toky stavů plateb

Tok stavů checkoutu

První volání API při platbě Twisto je požadavek na endpoint /checkouts. Odešlete ho ve chvíli, kdy si zákazník vybere Twisto jako platební metodu.

Tok stavů charge

Neplatí, pokud jste při registraci obchodníka zvolili režim Immediate Capture.

Pro dokončení platby Twisto zavoláte endpoint /charges.

Tento požadavek odešlete poté, co od Twisto obdržíte schválený checkout (webhookem nebo v URL přesměrování na e-shop).

Pokud checkout není schválený, /charges bude zamítnuto