Payment flow
Interaction scheme A (with customer redirection to payment page)
sequenceDiagram
Customer->>Merchant: 1. Customer populates shopping cart
Merchant-->>Customer: 2. Merchant creates HTML form with order details
Customer->>Merchant: 3. Customer submits payment form
Merchant->>Payme : 4. Merchant creates order and <br/>redirects customer to Payme hosted page
Payme -->>Customer: 5. Payme displays payment page to Customer
Customer->>Payme : 6. Customer provides payment details
Payme ->>Customer`s PI: 7. Payme checks if 3DSecure or SCA required
loop 3DSecure/SCA
Customer`s PI-->>Customer`s PI: 8. Customer is authenticated if required <br/>by his payment institution
end
Customer`s PI->>Payme : 9. Customer's PI returns authentication result
Payme ->>Customer`s PI: 10. Payme initiates the charge by sending payment request to customer's PI
Customer`s PI->>Payme : 11. Customer's PI returns payment result to Payme
Payme -->>Merchant: 12. Payme redirects customer back to Merchant <br/>with order status
Merchant-->>Customer: 13. Merchants shows result page to customer with order status
Payme -->>Merchant: 14. Payme sends server-to-server callback <br/>to Merchant with order status
- Customer chooses products or services in merchant online shop or mobile app and adds them to his cart.
- Merchant creates HTML form with request parameters to be submitted to Payme .
- At merchant site customer submits HTML form in browser or mobile application.
- Merchant redirects customer in browser to Payme url https://pay.payme.uz/api/checkout/redirect/, sending parameters with HTTPS POST method.
- Payme creates order and renders hosted payment page with all available methods.
- Customer provides payment details at payment page on Payme site.
- Payme checks if strong customer authentication is requires.
- Payme redirects customer to his payment institution for authentication (3DSecure/password/OTP) via browser.
- Payment institution returns customer back to Payme with authentication result.
- Payme initiates payment by sending request to customer payment institution (PI).
- Customer's payment institution returns payment result to Payme .
- Payme redirects customer to merchant site by sending payment result using HTTPS POST or GET.
- Merchant shows result page with payment details.
- To ensure that merchant received response with payment details, Payme also sends callback with payment result
parameters to merchant site using host-to-host HTTPS POST.
Interaction scheme B (with preliminary host-to-host request to get payment page URL)
sequenceDiagram
Customer->>Merchant: 1. Customer populates shopping cart
Merchant-->>Payme : 2. Merchant submits JSON request to Payme url https://pay.payme.uz/api/checkout/url/.
Payme ->>Merchant: 3. Payme returns to merchant `checkout_url` parameter
Merchant->>Customer: 4. Merchant creates order and <br/>redirects customer to Payme hosted page
Payme -->>Customer: 5. Payme displays payment page to Customer
Customer->>Payme : 6. Customer provides payment details
Payme ->>Customer`s PI: 7. Payme checks if 3DSecure or SCA required
loop 3DSecure/SCA
Customer`s PI-->>Customer`s PI: 8. Customer is authenticated if required <br/>by his payment institution
end
Customer`s PI->>Payme : 9. Customer's PI returns authentication result
Payme ->>Customer`s PI: 10. Payme initiates the charge by sending payment request to customer's PI
Customer`s PI->>Payme : 11. Customer's PI returns payment result to Payme
Payme -->>Merchant: 12. Payme redirects customer back to Merchant <br/>with order status
Merchant-->>Customer: 13. Merchants shows result page to customer with order status
Payme -->>Merchant: 14. Payme sends server-to-server callback <br/>to Merchant with order status
- Customer chooses products or services in merchant online shop or mobile app and adds them to his cart.
- Merchant creates JSON request with request parameters and submit it host-to-host to Payme url https://pay.payme.uz/api/checkout/url/.
- Payme returns to merchant interim response with
checkout_url parameter with URL were customer should be redirected to provide payment details.
- Merchant redirect customer to Payme hosted payment page with all available methods.
- Customer provides payment details at payment page on Payme site.
- Payme checks if strong customer authentication is requires.
- Payme redirects customer to his payment institution for authentication (3DSecure/password/OTP) via browser.
- Payment institution returns customer back to Payme uith authentication result.
- Payme initiates payment by sending request to customer payment institution (PI).
- Customer's payment institution returns payment result to Payme .
- Payme redirects customer to merchant site by sending payment result using HTTPS POST or GET.
- Merchant shows result page with payment details.
- To ensure that merchant received response with payment details, Payme also sends callback with payment result
parameters to merchant site using host-to-host HTTPS POST.