Retrieving Qplus Invoice Information¶
Returns the current status of the Qplus invoice and the corresponding payment.
For scenario using this method, please see “Payment via Qplus“
Request¶
GET /payin/v1/sites/{siteId}/qplus/invoices/{invoiceUid}
Path Parameters¶
| Parameter | Required | Type | Description |
|---|---|---|---|
| siteId | Yes | string | Merchant site identifier |
| invoiceUid | Yes | string | Unique identifier of the original Qplus invoice request in the merchant’s information system: invoiceUid value from the response to the Qplus invoice creation request |
Headers¶
| Header | Required | Type | Description |
|---|---|---|---|
| Authorization | Yes | string | API access key. Bearer [access-token] |
| Accept | No | string | Response content. application/json |
Request Example¶
Retrieving Qplus invoice information
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
Response¶
See also HTTP error codes
Successful Response Parameters¶
| Parameter | Required | Type | Description |
|---|---|---|---|
| invoiceUid | Yes | string | Qplus invoice creation request identifier |
| invoiceStatus | Yes | string | Qplus invoice status |
| amount | Yes | object | Operation amount info |
| paymentUrl | Yes | string | URL of the payment link of the Qplus invoice |
| qrCode | Yes | string | QR code in base64 format for the Qplus payment form |
| createdOn | Yes | string | Date and time of creation of the Qplus invoice in ISO8601 format |
| payment | No | object | Qplus invoice payment information |
Qplus invoice payment information¶
Qplus payment information is transmitted in the payment object of the response.
| Parameter | Required | Type | Description |
|---|---|---|---|
| paymentUid | Yes | string | Payment identifier |
| paymentStatus | Yes | string | Current payment status |
Error Parameters¶
| Parameter | Required | Type | Description |
|---|---|---|---|
| serviceName | Yes | string | Name of the service that produced the error |
| errorCode | Yes | string | Error code |
| description | Yes | string | Error description for the merchant |
| userMessage | Yes | string | Error description for the customer |
| dateTime | Yes | string | Error date and time |
| traceId | Yes | string | Error Log unique ID |
Response Examples¶
{
"invoiceUid": "Test012",
"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"
}