Оплата токеном СБП¶

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

Запрос¶

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

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

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

Заголовки¶

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

Параметры тела запроса¶

Параметр	Обязательный	Тип	Описание
tokenizationAccount	Да	string(64)	Идентификатор Покупателя в системе ТСП, привязанный к токену
token	Да	string	Строка токена СБП

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

Оплата токеном СБП

POST /partner/payin/v1/sites/test-01/sbp/qrCodes/adghj17d1g8/payments HTTP/1.1
Accept: application/json
Authorization: Bearer 5c4b25xx93aa435d9cb8cd17480356f9
Content-type: application/json
Host: b2b-api.qiwi.com

{
  "tokenizationAccount": "customer123",
  "token": "c5ba4a05-21c9-4a36-af7a-b709b4caa4d6"
}

Ответ¶

См. также список общих HTTP кодов ошибок

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

Параметр	Обязательный	Тип	Описание
qrCodeUid	Да	string	Идентификатор запроса QR-кода
qrCode	Да	[object]	Параметры QR-кода
amount	Да	object	Сумма операции
paymentPurpose	Нет	string(140)	Описание товара/услуги, которую получает покупатель
redirectUrl	Нет	string(1000)	URL для переадресации покупателя после оплаты
tokenizationPurpose	Нет	string(140)	Описание платёжного токена СБП
flags	Нет	array of strings	Дополнительные команды для API из исходного запроса
payment	Нет	object	Информация о платеже по QR-коду. Только для `type=DYNAMIC`
refunds	Нет	array of objects	Информация о возвратах по QR-коду. Только для `type=DYNAMIC`
token	Нет	object	Информация о платёжном токене СБП

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

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

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

Успешный ответОтвет с ошибкой 4xxОтвет с ошибкой 5xx

{
  "qrCodeUid": "adghj17d1g8",
  "amount": {
    "value": "100.00",
    "currency": "RUB"
  },
  "paymentPurpose": "Flower for my girlfriend",
  "redirectUrl": "http://someurl.com",
  "qrCode": {
    "type": "DYNAMIC",
    "ttl": 999,
    "status": "INIT_PAYMENT_BY_TOKEN",
    "payload": ""
  }
}

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