Create order

Pay by Payme payment is executed in 2 steps

Step 1: Create payment

Refer to Create order page to create an order with a simple code.

First, you need to create payment token or checkout URL from your backend.

To do this in a proper way, choose your integration type: Redirect/Iframe or Embedded

Redirect/IframeEmbedded

Send request from backend to /api/checkout/url endpoint:

curl -L 'https://sandbox.pay.flitt.dev/api/checkout/url' \
-H 'Content-Type: application/json' \
-d '{
  "request": {
    "server_callback_url": "https://testapi.com/api/callback/",
    "order_id": "test_payme_1",
    "currency": "UZS",
    "merchant_id": 1549901,
    "payment_systems": "paybypayme",
    "payment_method": "paybypayme",
    "order_desc": "Test Payme payment",
    "amount": 10000,
    "response_url": "https://example.com",
    "signature": "1570574166888217a8d5fb78227ff17c1488be72"
  }
}'

The response will contain the checkout URL. Redirect customer to this URL or load it in Iframe.

{
   "response": {
       "checkout_url": "https://sandbox.pay.flitt.dev/merchants/7ee242403e07af2d3fe9f208b66faec8bae2fe96/default/index.html?token=93dfba14daaa2cb01916606b54d0f3e935786cf7",
       "payment_id": "150009301",
       "response_status": "success"
   }
}

Send request from backend to /api/checkout/token endpoint:

curl -L 'https://sandbox.pay.flitt.dev/api/checkout/token' \
-H 'Content-Type: application/json' \
-d '{
  "request": {
    "server_callback_url": "https://testapi.com/api/callback/",
    "order_id": "test_payme_1",
    "currency": "UZS",
    "merchant_id": 1549901,
    "payment_systems": "paybypayme",
    "payment_method": "paybypayme",
    "order_desc": "Test Payme payment",
    "amount": 10000,
    "response_url": "https://example.com",
    "signature": "1570574166888217a8d5fb78227ff17c1488be72"
  }
}'

The response will contain the payment token.

{
    "response": {
        "token": "3bd24c7be3bb750d60c2188df3e392bf9c2d3646",
        "response_status": "success"
    }
}

Follow instructions on Embedded checkout page to complete integration.

Pay attention

To create Pay by Payme payment, the mandatory parameters

payment_systems = paybypayme

payment_method = paybypayme

must be sent during create order request.

Order can be created only within Redirect or Embedded flow and yet not supported for Direct.

Refer to create order and parameters specifications to get details on how to create order.

Step 2: Strong Customer Authentication (SCA)

After the order is created, in case of Redirect flow customer need to be redirected to checkout_url URL for Strong Customer Authentication within Payme application.