Skip to content

Retrieving FPS QR Code Information

Returns current Faster payment system (FPS) QR code status and corresponding payment status.

For scenarios using this method, please see “Payment via FPS” and “Payment Token

Request

GET /payin/v1/sites/{siteId}/sbp/qrCodes/{qrCodeUid}

Path Parameters

Parameter Required Type Description
siteId Yes string Merchant site identifier
qrCodeUid Yes string Unique identifier of the original QR code request in the merchant’s information system: qrCodeUid value from the response to the QR code generation 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 QR code information
GET /partner/payin/v1/sites/test-01/sbp/qrCodes/Test 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
qrCodeUid Yes string QR code request identifier.
qrCode Yes [object] QR code parameters
createdOn Yes string QR code generation date and time
amount No object Operation amount
token No object FPS payment token information.
Returned if the FPS token issue is requested
payment No object QR code payment information. Only for type=DYNAMIC
refunds No array of objects QR code refunds information. Only for type=DYNAMIC

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

{
  "qrCodeUid": "Test",
  "amount": {
    "currency": "RUB",
    "value": "1.00"
  },
  "qrCode": {
    "type": "DYNAMIC",
    "ttl": 60,
    "payload": "https://qr.nspk.ru/AD10006M8KH234K782OQM0L13JI31LQDtype=02bank=100000000009&sum=200&cur=RUB&crc=C63A",
    "status": "PAYED"
  },
  "payment": {
    "paymentUid": "A22231710446971300200933E625FCB3",
    "paymentStatus": "COMPLETED"
  },
  "createdOn": "2022-08-11T20:10:32+03:00"
}
{
  "serviceName" : "payin-core",
  "errorCode" : "validation.error",
  "description" : "Validation error",
  "userMessage" : "Validation error",
  "dateTime" : "2022-03-05T11:49:59.166+03:00",
  "traceId" : "fd0e2a08c63ace83"
}
{
  "serviceName":"payin-core",
  "errorCode":"internal.error",
  "userMessage":"Internal error",
  "description":"Internal error",
  "traceId":"3fb3420ee1795dcf",
  "dateTime":"2020-02-12T21:28:01.813+03:00"
}