Перейти к содержанию

Получение информации о QR-коде СБП

Запрос возвращает текущий статус QR-кода для оплаты через Систему быстрых платежей (СБП) и платежа по нему.

Сценарии, в которых используется запрос статуса QR-кода, см. в статьях «Оплата с помощью СБП» и «Платёжный токен»

Запрос

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

Параметры строки запроса

Параметр Обязательный Тип Описание
siteId Да string Строковый идентификатор сайта ТСП в QIWI Кассе
qrCodeUid Да string Идентификатор исходного запроса QR-кода в информационной системе ТСП: значение qrCodeUid из ответа на запрос создания QR-кода

Заголовки

Заголовок Обязательный Тип Описание
Authorization Да string Авторизационные данные. Bearer [access-token]
Accept Нет string Тип ответа. application/json

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

Запрос информации о QR-коде
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

Ответ

Поля успешного ответа

Параметр Обязательный Тип Описание
qrCodeUid Да string Идентификатор запроса QR-кода
qrCode Да [object] Параметры QR-кода
createdOn Да string Дата и время создания QR-кода
amount Нет object Сумма операции
token Нет object Информация о платёжном токене СБП. Возвращается, если запрошен выпуск токена СБП
payment Нет object Информация о платеже по QR-коду. Только для type=DYNAMIC
refunds Нет array of objects Информация о возвратах по QR-коду. Только для type=DYNAMIC

Поля ответа с ошибкой

Параметр Обязательный Тип Описание
serviceName Да string Имя сервиса, сгенерировавшего ошибку
errorCode Да string Код ошибки
description Да string Описание ошибки для ТСП
userMessage Да string Описание ошибки для отображения покупателю
dateTime Да string Дата и время ошибки
traceId Да string Уникальный ID лога ошибки

Примеры ответов

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