Получение информации о счёте Qplus¶
Запрос возвращает текущий статус счёта Qplus для оплаты через Qplus и платежа по нему.
Сценарий, в котором используется запрос статуса счёта Qplus, см. в статье «Оплата с помощью Qplus»
Запрос¶
GET /payin/v1/sites/{siteId}/qplus/invoices/{invoiceUid}
Параметры строки запроса¶
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
| siteId | Да | string | Строковый идентификатор сайта ТСП в QIWI Кассе |
| invoiceUid | Да | string | Идентификатор исходного запроса при создании счёта Qplus в информационной системе ТСП: значение invoiceUid из ответа на запрос создания счёта Qplus |
Заголовки¶
| Заголовок | Обязательный | Тип | Описание |
|---|---|---|---|
| Authorization | Да | string | Авторизационные данные. Bearer [access-token] |
| Accept | Нет | string | Тип ответа. application/json |
Пример запроса¶
Запрос информации о счёте Qplus
GET /payin/v1/sites/test-01/qplus/invoices/Test012 HTTP/1.1
Accept: application/json
Authorization: Bearer 5c4b25xx93aa435d9cb8cd17480356f9
Content-type: application/json
Host: b2b-api.qiwi.com
Ответ¶
См. также список общих HTTP кодов ошибок
Поля успешного ответа¶
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
| invoiceUid | Да | string | Идентификатор запроса. Такой же как в параметрах запроса |
| invoiceStatus | Да | string | Статус счёта Qplus |
| amount | Да | object | Данные о сумме операции |
| paymentUrl | Да | string | URL платежной ссылки счёта Qplus |
| qrCode | Да | string | QR-код в формате base64 для платёжной формы Qplus |
| createdOn | Да | string | Дата и время создания счёта Qplus |
| payment | Нет | object | Информация о платеже по счёту Qplus |
Информация о платеже по счёту Qplus¶
Информация о платеже по счёту Qplus передаётся в объекте payment ответа.
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
| paymentUid | Да | string | Идентификатор платежа |
| paymentStatus | Да | string | Текущий статус платежа |
Поля ответа с ошибкой¶
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
| serviceName | Да | string | Имя сервиса, сгенерировавшего ошибку |
| errorCode | Да | string | Код ошибки |
| description | Да | string | Описание ошибки для ТСП |
| userMessage | Да | string | Описание ошибки для отображения покупателю |
| dateTime | Да | string | Дата и время ошибки |
| traceId | Да | string | Уникальный ID лога ошибки |
Примеры ответов¶
{
"invoiceUid": "aae8557a-a1bd-4634-8224-b63bc6d913f3",
"invoiceStatus": "PAYED",
"amount": {
"currency": "RUB",
"value": "6.00"
},
"paymentUrl": "https://example.com/qplus/pay/testtest",
"qrCode": "iVBORw0KGgoAAAANSUhEUgAAASwAAAEsCAYAA",
"payment": {
"paymentUid": "8990ebf3-bd71-3493-b606-da383ee502bb",
"paymentStatus": "COMPLETED"
},
"createdOn": "2026-02-03T15:09:47+03:00"
}