Завершение аутентификации при проверке карты¶

После успешного прохождения дополнительной аутентификации 3D-Secure необходимо отправить запрос с результатом дополнительной аутентификации для завершения проверки.

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

Запрос¶

POST /payin/v1/sites/{siteId}/validation/card/requests/{requestUid}/complete

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

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

Заголовки¶

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

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

Параметр	Обязательный	Тип	Описание
pares	Да	string	Результат аутентификации покупателя, полученный после его возврата с ACS банка-эмитента

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

Завершение аутентификации при проверке карты

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

{
    "pares": "eJzVWFevo9iyfu9fMZrzaM0QjWHk3tIiGptgooE3cgabYMKvv3jvTurTc3XOfbkaJMuL...."
}

Ответ¶

См. также список общих 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": "PASSED",
  "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"
}