Payment

Foydalanuvchi kartasidan merchant hisobiga mablag‘ yechish uchun ikki xil metod ishlatiladi.

Endpoints

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

Payment steps

1. merchant/receipts/create/ endpoint’iga so‘rov yuborib payment tranzaksiyasini yarating. (transactionId qaytadi)
2. Payment’ni tasdiqlang

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 (merchant tomonidan berilgan identifikator)
amount	1000	int	Yes	Summa SUM ko‘rinishida yuboriladi (1000 = 1 ming SUM)
account		dict	Yes	Merchant saqlashi kerak bo‘lgan qo‘shimcha ma’lumot bo‘lmasa bo‘sh dict yuboring: {"account": {}}

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	/receipts/create/ metodi orqali qaytgan transactionId
cardId	9f877739-bc25-4f0f-a13f-ec485fd04250	string	Yes	Paylov tizimida yaratilgan cardId
userId	123	string	Yes	userId (merchant tomonidan berilgan identifikator)

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
  }
}