Оплата

Вывести деньги с карты пользователя на счет мерчанта можно двумя способами.

Конечные точки

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

Этапы оплаты

1. Создайте платежную транзакцию, отправив запрос на конечную точку merchant/receipts/create/. (возвращает transactionId)
2. Подтвердить платеж

1. Создать платежную транзакцию

Подробности конечной точки

Метод: POST
URL: BASE_URL/merchant/receipts/create/
Заголовок:

Authorization: Bearer <ACCESS_TOKEN>

Поля	sample_data	Тип	Требуется	Описание
userId	123	string	Нет	userId (ID заявлено мерчантом)
amount	1000	int	Да	Сумма в SUM (1000 = 1 тысяча SUM)
account		dict	Да	(«account»: {} ) отправить пустой текст, если у мерчанта нет дополнительных данных для сохранения

Пример запроса

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

Пример успешного ответа

{
  "transactionId": "string"
}

Пример ответа об ошибке

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

2. Подтвердить платеж

Подробности конечной точки

Метод: POST
URL: BASE_URL/merchant/receipts/pay/
Заголовок:

Authorization: Bearer <ACCESS_TOKEN>

Поля	sample_data	Тип	Требуется	Описание
transactionId	9f877739-bc25-4f0f-a13f-ec485fd04250	string	Да	transactionId, возвращаемый методом /receipts/create/
cardId	9f877739-bc25-4f0f-a13f-ec485fd04250	string	Да	cardId, созданный в системе Paylov
userId	123	string	Да	userId (ID заявлено мерчантом)

Тело запроса

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

Успешный ответ

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

Ответ об ошибке

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

Статус транзакции

Подробности конечной точки

Метод: GET
URL: BASE_URL/merchant/getTransactions/?transactionId=your_transaction_id
Заголовок:

Authorization: Bearer <ACCESS_TOKEN>

Успешный ответ

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

Ответ об ошибке

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