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