Проверка карты¶

Запрос выполняет проверку карты и создаёт платёжный токен, если проверка успешная. Если используется дополнительная аутентификация пользователя 3D-Secure, токен возвращается в успешном ответе на запрос завершения проверки.

Подробности см. в статье «Проверка карты».

Запрос¶

PUT /payin/v1/sites/{siteId}/validation/card/requests/{requestUid}

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

Параметр	Обязательный	Тип	Описание
siteId	Да	string	Строковый идентификатор сайта ТСП в QIWI Кассе
requestId	Да	string	Уникальный идентификатор запроса проверки карты в информационной системе ТСП. Уникальность означает, что идентификатор должен отличаться от идентификаторов всех ранее отправленных запросов проверки карты в рамках одного `siteId`.

Заголовки¶

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

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

Параметр	Обязательный	Тип	Описание
cardData	Да	object	Реквизиты банковской карты
tokenizationData	Нет	object	Данные для генерации платёжного токена карты

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

Проверка карты и создание платёжного токена

PUT /partner/payin/v1/sites/test-01/validation/card/requests/acd7bf20-22e2-4cbf-a218-38d90e9f29b9 HTTP/1.1
Accept: application/json
Authorization: Bearer 5c4b25xx93aa435d9cb8cd17480356f9
Content-type: application/json
Host: b2b-api.qiwi.com

{
    "cardData": {
        "pan": "1111222233334444",
        "expiryDate": "12/34",
        "cvv2": "123",
        "holderName": "Super Man"
    },
    "tokenizationData": {
        "account": "cat_girl"
    }
}

Ответ¶

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

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

Параметр	Обязательный	Тип	Описание
requestUid	Да	string	Идентификатор запроса. Такой же как в запросе
status	Да	string	Статус проверки карты
checkOperationDate	Нет	string	Дата проверки
isValidCard	Нет	boolean	Результат проверки карты. `true` — карта доступна для покупок
threeDsStatus	Нет	string	Статус дополнительной аутентификации 3D-Secure
cardInfo	Нет	object	Информация о банковской карте
requirements	Нет	object	Аутентификационное сообщение для передачи в ACS банка-эмитента через браузер покупателя
createdToken	Нет	object	Данные платежного токена. Возвращается если дополнительная аутентификация 3D-Secure не требуется, параметр `isValidCard=true` и в запросе указан параметр `account`

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

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

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

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

{
  "requestUid": "acd7bf20-22e2-4cbf-a218-38d90e9f29b9",
  "status": "SUCCESS",
  "isValidCard": true,
  "threeDsStatus": "WITHOUT",
  "checkOperationDate": "2025-03-25T12:55:12+03:00",
  "cardInfo": {
    "issuingCountry": "643",
    "issuingBank": "Gazprombank",
    "paymentSystem": "MIR",
    "fundingSource": "DEBIT",
    "paymentSystemProduct": "details"
  },
  "createdToken": {
    "token": "1a77343a-dd8a-11eb-ba80-0242ac130004",
    "name": "111122******4444",
    "expiredDate": "2034-12-31T00:00:00+03:00",
    "account": "cat_girl"
  }
}

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