Skip to content

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   
  1. Customer chooses products or services in merchant online shop or mobile app and adds them to his cart.
  2. Merchant creates HTML form with request parameters to be submitted to Payme .
  3. At merchant site customer submits HTML form in browser or mobile application.
  4. Merchant redirects customer in browser to Payme url https://pay.payme.uz/api/checkout/redirect/, sending parameters with HTTPS POST method.
  5. Payme creates order and renders hosted payment page with all available methods.
  6. Customer provides payment details at payment page on Payme site.
  7. Payme checks if strong customer authentication is requires.
  8. Payme redirects customer to his payment institution for authentication (3DSecure/password/OTP) via browser.
  9. Payment institution returns customer back to Payme with authentication result.
  10. Payme initiates payment by sending request to customer payment institution (PI).
  11. Customer's payment institution returns payment result to Payme .
  12. Payme redirects customer to merchant site by sending payment result using HTTPS POST or GET.
  13. Merchant shows result page with payment details.
  14. 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   
  1. Customer chooses products or services in merchant online shop or mobile app and adds them to his cart.
  2. Merchant creates JSON request with request parameters and submit it host-to-host to Payme url https://pay.payme.uz/api/checkout/url/.
  3. Payme returns to merchant interim response with checkout_url parameter with URL were customer should be redirected to provide payment details.
  4. Merchant redirect customer to Payme hosted payment page with all available methods.
  5. Customer provides payment details at payment page on Payme site.
  6. Payme checks if strong customer authentication is requires.
  7. Payme redirects customer to his payment institution for authentication (3DSecure/password/OTP) via browser.
  8. Payment institution returns customer back to Payme uith authentication result.
  9. Payme initiates payment by sending request to customer payment institution (PI).
  10. Customer's payment institution returns payment result to Payme .
  11. Payme redirects customer to merchant site by sending payment result using HTTPS POST or GET.
  12. Merchant shows result page with payment details.
  13. 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.