Payment

There are two methods used to withdraw money from the user's card to the merchant's account.

Endpoints

BASE_URL/merchant/receipts/create/
BASE_URL/merchant/receipts/pay/

Payment steps

1. Create payment transaction by sending request to the merchant/receipts/create/ endpoint. (returns transactionId)
2. Confirm Payment

1. Create payment transaction

Endpoint details

Method: POST
URL: BASE_URL/merchant/receipts/create/
Header:

Authorization: Bearer <ACCESS_TOKEN>

Fields	sample_data	Type	Required	Description
userId	123	string	No	userId (ID declared by the merchant)
amount	1000	int	Yes	Amount in SUM (1000 = 1 Thousand SUM)
account		dict	Yes	(”account”: {} ) send empty dict if merchant does not have additional data to save

Request example

{
  "userId": "string",
  "amount": 1000,
  "account": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}

Success response example

{
  "transactionId": "string"
}

Error response example

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

2. Confirm payment

Endpoint details

Method: POST
URL: BASE_URL/merchant/receipts/pay/
Header:

Authorization: Bearer <ACCESS_TOKEN>

Fields	sample_data	Type	Required	Description
transactionId	9f877739-bc25-4f0f-a13f-ec485fd04250	string	Yes	transactionId that is returned by the /receipts/create/ method
cardId	9f877739-bc25-4f0f-a13f-ec485fd04250	string	Yes	cardId that is created in Paylov system
userId	123	string	Yes	userId (ID declared by the merchant)

Request body

{
  "transactionId": "string",
  "cardId": "string",
  "userId": "string"
}

Successful response

{
  "result": {
    "transactionId": "9b370dde-dfe1-4365-be8a-d3581c9479ba"
  }
}

Error response

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Transaction Status

Endpoint details

Method: GET
URL: BASE_URL/merchant/getTransactions/?transactionId=your_transaction_id
Header:

Authorization: Bearer <ACCESS_TOKEN>

Successful response

{
    "result": {
        "totalTransaction": 1,
        "transactions": [
            {
                "id": "3667c3fb-68a5-4d1c-bd86-99df49c895d9",
                "userId": null,
                "card_id": "9a192005-f61c-4874-51a3-f3bf154d6feb",
                "cardNumber": "986030******9999",
                "owner": "Levi A.",
                "amount": 1000.0,
                "amount_in_tiyin": 100000,
                "date": "2026-04-01 06:38:38",
                "is_split": false,
                "is_hold": false,
                "is_a2c": false,
                "transaction_type": "To'lov",
                "via_link": true,
                "ofd": [
                  "receipt_id": 123456,
                  "qr_code_url": "https://ofd.soliq.uz/epi?t=EP000000000001&r=001&c=20060102000000&s=000000000001",
                  "date_time": "2026-04-01 06:38:38",
                  "is_refund": false
                  
                ]
            }
        ],
        "error": null
    }
}

Error response

{
    "result": {
        "totalTransaction": 0,
        "transactions": [],
        "error": null
    }
}