Ошибка киви 404

Статусы и типы операций, коды ошибок {#statuses}

Коды ошибок {#http-errors}

Протокол приема платежей использует для запросов API следующие HTTP-коды ошибок:

Код ошибки	Описание
400	Bad Request — Ваш запрос некорректен (ошибка в данных или в формате запроса).
401	Unauthorized — Неправильный ключ доступа к API.
403	Forbidden — Доступ к API запрещен.
404	Not Found — Указанный ресурс не найден.
405	Method Not Allowed — Для создания платежа использовался неправильный метод.
406	Not Acceptable — Формат данных отличается от JSON.
410	Gone — Запрашиваемый ресурс удален.
429	Too Many Requests — Слишком много запросов.
500	Internal Server Error — Внутренняя ошибка сервиса. Если тело ответа пустое, повторите запрос с теми же параметрами. Если тело ответа не пустое, выполните запрос статуса платежа или статуса счета.
502	Bad Gateway — Нет связи с сервисом
503	Service Unavailable  — Сервер временно недоступен по техническим причинам, попробуйте позже.

Типы операций {#operation-types}

Тип операции возвращается в поле {operation}.type уведомления.

Тип операции	Описание
PAYMENT	Платеж. В уведомлении может присутствовать поле flag: [ "SALE" ] (обычный платеж) или flag: [ "AUTH" ] (платеж с холдированием средств).
CAPTURE	Операция подтверждения.
REFUND	Операция возврата. В уведомлении может присутствовать поле flag: [ "REVERSAL" ]. Это значит, что финансовой операции (списания средств со счета покупателя) не было, комиссия по операции удержана не будет.

Статусы операций {#operation-statuses}

Статус операции отражает ее текущее состояние.

API возвращает синхронный статус операции в поле status.value.

В уведомлениях статус помещается в поле {operation}.status.value.

В таблице перечислены возможные статусы и типы операций, в которых эти статусы используются.

Статус операции	Тип операции	Описание статуса	Где возвращается
WAITING	PAYMENT	Ожидание 3DS авторизации	Ответы API
DECLINED	PAYMENT	Запрос авторизации отклонен	Уведомления, Ответы API
DECLINE	REFUND	Запрос возврата отклонен	Уведомления, Ответы API
DECLINE	CAPTURE	Запрос подтверждения отклонен	Уведомления, Ответы API
DECLINED	CAPTURE	Запрос подтверждения отклонен	Ответ API на запрос статуса
SUCCESS	PAYMENT	Запрос авторизации успешно обработан	Уведомления
COMPLETED	PAYMENT	Запрос авторизации успешно обработан	Ответы API
SUCCESS	REFUND	Запрос возврата успешно обработан	Уведомления
COMPLETED	REFUND	Запрос возврата успешно обработан	Ответы API
SUCCESS	CAPTURE	Запрос подтверждения успешно обработан	Уведомления
COMPLETED	CAPTURE	Запрос подтверждения успешно обработан	Ответы API

Для счетов используется только статус CREATED.

Справочник ошибок API {#reason-codes}

Ошибки API описывают причину отклонения операции и передаются:

• в ответах на запросы — в поле status.reason;
• в уведомлениях — в поле status.reasonCode.

Ошибка API	Описание
INVALID_STATE	Некорректный статус транзакции
INVALID_AMOUNT	Некорректная сумма
INVALID_RECEIVER_DATA	Ошибка при передаче данных о получателе
DECLINED_BY_MPI	Отклонено MPI
DECLINED_BY_FRAUD	Отклонено fraud-мониторингом
REATTEMPT_NOT_PERMITTED	Повторный запрос авторизации запрещен на основании полученного ответа от Платежной системы
GATEWAY_INTEGRATION_ERROR	Ошибка взаимодействия с банком
GATEWAY_TECHNICAL_ERROR	Техническая ошибка на стороне банка
ACQUIRING_MPI_TECH_ERROR	Техническая ошибка при проведении 3DS аутентификации
ACQUIRING_GATEWAY_TECH_ERROR	Техническая ошибка
ACQUIRING_ACQUIRER_ERROR	Техническая ошибка
ACQUIRING_AUTH_TECHNICAL_ERROR	Ошибка при проведении авторизации средств
ACQUIRING_ISSUER_NOT_AVAILABLE	Ошибка эмитента. Банк-эмитент не доступен
ACQUIRING_SUSPECTED_FRAUD	Ошибка эмитента. Подозрение на мошенничество
ACQUIRING_LIMIT_EXCEEDED	Ошибка эмитента. Превышен один из лимитов
ACQUIRING_NOT_PERMITTED	Ошибка эмитента. Операция не разрешена
ACQUIRING_INCORRECT_CVV	Ошибка эмитента. Некорректный CVV
ACQUIRING_EXPIRED_CARD	Ошибка эмитента. Неверный срок действия карты
ACQUIRING_INVALID_CARD	Ошибка эмитента. Проверьте корректность введенных данных
ACQUIRING_INSUFFICIENT_FUNDS	Ошибка эмитента. Недостаточно средств
ACQUIRING_UNKNOWN	Неизвестная ошибка
BILL_ALREADY_PAID	Счет уже оплачен
PAYIN_PROCESSING_ERROR	Ошибка при проведении платежа
PAYMENT_EXPIRED_3DS	Не пройдена 3DS-аутентификация
QW_LIMIT_ERROR	Ошибка превышения лимита пользователя QIWI Кошелька
QW_IDENTIFICATION_ERROR	Пользователю необходимо пройти идентификацию в QIWI Кошельке
QW_AUTH_ERROR	Ошибка авторизации в QIWI Кошельке
QW_INSUFFICIENT_FUNDS	Недостаточно средств в QIWI Кошельке
QW_AMOUNT_ERROR	Недопустимая сумма платежа
QW_REGISTRATION_ERROR	Ошибка регистрации пользователя QIWI Кошелька
QW_AGENT_ERROR	Ошибка при пополнении QIWI Кошелька пользователя
QW_ACCOUNT_ERROR	QIWI Кошелек заблокирован
QW_IDENTIFICATION_STATUS_ERROR	Достигнут лимит платежей в QIWI Кошельке
QW_CURRENCY_ERROR	Валюта QIWI Кошелька не найдена
QW_PAYMENT_ERROR	Ошибка проведения платежа в QIWI Кошельке
QW_PROVIDER_ERROR	Провайдер QIWI Кошелька заблокирован
QW_SMS_CONFIRM_EXPIRED	Истекло время СМС-подтверждения платежа в QIWI Кошельке

Всем привет!

Я впервые сталкиваюсь с тем, что сайт (на минуточку платёжная система) не отображается на компьютере, а на сматрфоне отображается «по настроению»…

Кошелек Qiwi технически абсолютно не приспособлен к использованию, работает лишь выборочно на некоторых устройствах и когда ему вздумается, а отправить с него деньги оказалось невыполнимой задачей…уже позже зайдя в официальную группу ВК Qiwi я поняла, что это привычное дело для этой платёжной системы и я не одна такая…

оплачивайте услуги ЖКХ, переводите деньги на карту, кошелек Яндекс. Деньги, расплачивайтесь за покупки

Всё началось с того, что я просто решила зарегистрироваться на сайте Qiwi и создать кошелек. Но «просто» не получилось: сайт на моём компьютере попросту не открывался

Казалось бы, первая мысль что то не так с браузерами, но все без исключения сайты открываются, а Qiwi ни в какую! Я пробовала отключать антивирусники, заходить через Opera и Google Chrom, опять выскакивает колёсико загрузки.

Я написала в официальную группу ВК, а те направили моё письмо в тех. поддержу. Тех поддержка проверили состояние подключения, просили скрины, я послушно оправляла, но в результате сайт на компьютере не заработал, а мне просто предложили попробовать зайти через другое устройство:

Все сайты и интернет на компьютере работают исправно, а Qiwi почему то исключение.

Ваш номер телефона – ваш номер кошелька Qiwi

Пришлось регистрироваться через смартфон, хотя я считаю этот способ крайне небезопасным. Неделю я пыталась зарегистрироваться на смартфоне, но чудо случилось лишь после того как я обновила браузеры до последней версии. Из этого делаю вывод, что Qiwi работает только в самой последней версии браузеров Opera и Google Chrom! Блин, почему нельзя настроить технически сайт и сделать доступным для всех версий браузеров, ведь не у всех технически и финансово есть возможность обновлять браузеры!…Почему Яндекс.Деньги и даже WebMoney будь он не ладен работают как швейцарские часы с любого даже самого устаревшего устройства?…

Я обрадовалась, что создала кошелек, виртуальную бесплатную карту Qiwi (удобная штука если вы расплачиватесь за покупки в интернете) и даже провела через него какую то сумму и опять начались непонятные технические проблемы…

…при попытке перевести деньги на баланс мобильного или на Яндекс.Деньги выскакивала ошибка «ой, такого провайдера не существует»….при чём тут провайдер, когда интернет на смартфоне спокойно работает и заходит на все остальные сайты….и опять тех. поддержка, и опять высылание им скринов и данных…и опять этот стандартный ответ «попробуйте то, попробуте сё», но это не помогает и по факту ошибка сайта продолжает выскакивать по сей день.

Чтобы вывести деньги с Qiwi кошелька и пользоваться ими, мне приходится заходить на Яндекс.Деньги и через кнопку «пополнить картой» выуживать свои же собственные деньги с Qiwi, ведь в самом кошельке платёжные ссылки не работают! Я не могу даже пополнить мобильный с Qiwi кошелька, автоматически выскакивает ошибка 404.

Кроме того, когда я пытаюсь зайти на сайт вбиваю логин и пароль, он выдаёт ошибку сайта «object progress event», на сайт попросту даже не зайти. Происходит это что называется «по настроению» сайта Qiwi, продолжается примерно неделю, потом каким то чудом вход осуществляется. В группе ВК таких сообщений масса, сотни людей пишут об этом «баге» сайта, но тех. поддержка …складывается ощущение что у тех. поддержки нет it-образования, они всегда выдают стандартные ответы, а технически сами не понимают почему сайт вечно не работает.

КОРОЧЕ!…

Из плюсов платёжной системы Qiwi я могу выделить только простой и понятный интерфейс и виртуальную бесплатную карту, которая привязывается к кошельку на год, а баланс карты равен балансу на кошельке. Ею удобно расплачиваться в интернет-магазинах как обычной пластиковой картой, оплачивать интернет, а также переводить с неё деньги на Яндекс.Деньги, которые для меня остаются «the best».

Техническая база сайта Qiwi худшая из всех сайтов, что встречала. Сайт то отображается, то нет, постоянно вылетают ошибки 404, из-за которых пользоваться им полноценно невозможно неделями. Работает исключительно с браузеров последних версий и то не всегда, платёжные ссылки у меня по прежнему не открываются, соответственно деньги перевести напрямую не получается. На компьютере сайт до сих пор не отображается, что у меня вообще впервые.

Многие сравнивают Qiwi с Яндекс Деньги… пффф… система Яндекс.Деньги работает как часы со всех устройств и браузеров и на мой взгляд технически идеальна. Qiwi самый косячный сайт с точки зрения программного обеспечения, а страдают от этого простые пользователи.

Не понимаю как такая популярная платёжная система как Qiwi, где люди держат деньги, так не корректно работает, а разработчики Qiwi ничего не предпринимают для устранения технических проблем.

Всем полных кошельков!

Последнее обновление: 23-11-2022

Общие сведения

API предназначен для проведения идентификации физических лиц. Подробности см. на explain.qiwi.com.

Используемые в тексте термины описаны в этой статье.

Доступ к API

Для успешного вызова методов API необходимы:

• Корректные заголовки Accept и Content-Type. API поддерживает только один MIME-тип: application/json. Любое другое значение приведет к ошибке формата данных.
• URL, составленный согласно требованиям к нужному запросу.
• Bearer-токен, выданный вам для доступа к API.

Авторизация

Авторизация должна передаваться во всех запросах в заголовке Authorization:

Authorization: Bearer {token}

Для получения токенов обращайтесь к своему контактному менеджеру.

Шифрование запросов с персональными данными

Для запросов, в которых передаются персональные данные, нужно использовать HTTPS-протокол со специально настроенным шифрованием в соответствии с ГОСТ Р 34.10-2012 и 34.11-2012. Такие запросы нужно отправлять на соответствующие URL-адреса.

Формирование URL запроса

URL-адрес любого запроса к API складывается из двух компонент: server URL и путь конкретного запроса.

Значения server URL перечислены далее. Эндпоинты запросов указаны в их описании.

Запросы, в которых передаются персональные данные

К ним относятся запросы разделов Упрощенная онлайн-идентификация и Получение персональных данных клиента.

Адреса server URL:

• В тестовой среде:

  https://api-gost-test.qiwi.com/partner/openapi-identification

• В производственной среде:

  https://api-gost.qiwi.com/partner/openapi-identification

Запросы, в которых не передаются персональные данные

Адреса server URL:

• В тестовой среде:

  https://api-test.qiwi.com/partner/openapi-identification

• В производственной среде:

  https://api.qiwi.com/partner/openapi-identification

Упрощенная онлайн-идентификация

Процесс упрощённой идентификации описан на explain.qiwi.com.

Создание заявки

Запрос → POST

• URL /v1/products/{productId}/persons/{personId}/simplified-identification/applications

  • productId — ID продукта
  • personId — ID клиента

Атрибуты тела запроса

Создание заявки (тело запроса)

{
  "firstName" : "Имя",
  "lastName" : "Фамилия",
  "middleName" : "Отчество",
  "birthDate" : "11.01.1996",
  "citizenshipCountryId" : "RU",
  "contacts" : {
    "mobilePhoneNumber" : "+79271234567",
    "email" : "email@email.com"
  },
  "identifyingDocument" : {
    "type" : "RUSSIAN_INNER_PASSPORT",
    "series" : "9208",
    "number" : "556900"
  },
  "secondaryDocuments" : [ {
    "type" : "INN",
    "number" : "33701000015"
  } ],
  "clientDeviceFingerprint" : {
    "IPv4" : "10.12.11.290"
  }
}

Имя	Тип	Описание
birthDate	String	Дата рождения. Формат: ДД.ММ.ГГГГ. Допустимый диапазон: от 14 до 100 лет включительно
citizenshipCountryId	String	Гражданство. Всегда значение RU
clientDeviceFingerprint	object	Сведения о клиентском устройстве, с которого поступил запрос
clientDeviceFingerprint.IPv4	String	IP-адрес клиентского устройства, с которого поступил запрос
contacts	object	Контактные данные клиента
contacts.email	String	e-mail
contacts.mobilePhoneNumber	String	Номер мобильного телефона в международном формате
firstName	String	Имя. Минимум две буквы, допустимо использование тире
lastName	String	Фамилия. Минимум две буквы, допустимо использование тире
middleName	String	Отчество. Минимум две буквы, допустимо использование тире
identifyingDocument	object	Сведения о документе, удостоверяющем личность
identifyingDocument.type	String	Тип документа. Всегда значение RUSSIAN_INNER_PASSPORT
identifyingDocument.number	String	Номер документа. Формат: 6 цифр
identifyingDocument.series	String	Серия документа. Формат: 4 цифры
secondaryDocuments	array	Дополнительные документы. В массиве можно передавать объекты ИНН или СНИЛС

Атрибуты ответа

Ответ на создание заявки

{
  "firstName" : "Имя",
  "lastName" : "Фамилия",
  "middleName" : "Отчество",
  "birthDate" : "11.01.1996",
  "citizenshipCountryId" : "RU",
  "contacts" : {
    "mobilePhoneNumber" : "+79271234567",
    "email" : "email@email.com"
  },
  "identifyingDocument" : {
    "type" : "RUSSIAN_INNER_PASSPORT",
    "series" : "9208",
    "number" : "556900"
  },
  "secondaryDocuments": [
    {
      "type" : "INN",
      "number" : "500100732259"
    }
  ],
  "id" : "1234ABCD4321",
  "creationDateTime" : "2019-01-11T17:16:05.743+03:00",
  "applicationStatus" : "IN_PROGRESS",
  "identificationLevel" : "NOT_VERIFIED",
  "productId" : "111222",
  "personId" : "1"
}

Имя	Тип	Описание
applicationStatus	String	Статус (состояние) заявки. Возможные значения
birthDate	String	Дата рождения. Формат см. в описании запроса
citizenshipCountryId	String	Гражданство. ID из справочника стран
contacts	object	Контактные данные клиента
contacts.email	String	e-mail
contacts.mobilePhoneNumber	String	Номер мобильного телефона
creationDateTime	String	Дата создания заявки
firstName	String	Имя
lastName	String	Фамилия
middleName	String	Отчество
id	String	ID заявки
identificationLevel	String	Текущий уровень идентификации. Возможные значения
identificationLevelReasonCode	String	Код причины полученного уровня идентификации
identifyingDocument	object	Сведения о документе, удостоверяющем личность
identifyingDocument.number	String	Номер документа
identifyingDocument.series	String	Серия документа
identifyingDocument.type	String	Тип документа
personId	String	ID клиента
productId	String	ID продукта
secondaryDocuments	array	Массив дополнительных документов

Получение статуса заявки

Запрос → GET

• URL /v1/products/{productId}/persons/{personId}/simplified-identification/applications/{applicationId}

  • productId — ID продукта
  • personId — ID клиента
  • applicationId — ID заявки

Структура тела ответа идентична структуре ответа на запрос «Создание заявки».

Получение статуса всех заявок

Запрос → GET

• URL /v1/products/{productId}/persons/{personId}/simplified-identification/applications

  • productId — ID продукта
  • personId — ID клиента

Тело ответа — json-массив объектов-заявок. Структура каждого объекта-заявки идентична структуре ответа на запрос «Создание заявки».

Полная идентификация

Процесс полной идентификации описан на explain.qiwi.com.

Поиск заявок на идентификацию

Запрос → GET

• URL /v1/full-identification/applications/search?parameter=value

  • productId — ID продукта
  • flowType — тип заявки (всегда AGENT_FILLED_ONLY_FULL_IDENTIFICATION)
  • mobilePhoneNumber — номер мобильного телефона в международном формате
  • applicationStatus — статус (состояние) заявки, необязательный параметр

Атрибуты объекта-заявки

Запрос поиска

GET /v1/full-identification/applications/search?
productId=agent-ident&flowType=AGENT_FILLED_ONLY_FULL_IDENTIFICATION&mobilePhoneNumber=%2B79071234567 HTTP/1.1
Accept: application/json
Authorization: Bearer YUu2qw048gtdsvlk3iu
Host: <server URL>

В ответе возвращается json-массив объектов-заявок.

Объект-заявка

{
  "id" : "A171EB8417CE11E99124DD04D7207C6E",
  "creationDateTime" : "2019-01-13T11:29:44.943+03:00",
  "applicationStatus" : "AWAITING_PASSPORT_CONFIRMATION",
  "identificationLevel" : "NOT_VERIFIED",
  "maximumPossibleIdentificationLevel" : "FULL",
  "productId" : "111222",
  "identificationDataSource" : {
    "identificationAgentName" : "Евросеть",
    "identificationEndpoint" : {
      "fullAddress" : "г. Москва, ул. Гранатная, 1, оф. 2"
    }
  },
  "firstName" : "И***",
  "lastName" : "Ф***",
  "middleName" : "О***",
  "citizenshipCountryId" : "RU",
  "contacts" : {
    "mobilePhoneNumber" : "+79271234567",
    "email" : null
  }
}

Имя	Тип	Описание
applicationStatus	String	Статус (состояние) заявки. Возможные значения
citizenshipCountryId	String	Гражданство. ID из справочника стран
contacts	object	Контактные данные клиента
contacts.email	String	e-mail
contacts.mobilePhoneNumber	String	Номер мобильного телефона в международном формате
creationDateTime	String	Дата создания заявки
id	String	ID заявки
identificationLevel	String	Текущий уровень идентификации. Возможные значения
firstName	String	Имя
lastName	String	Фамилия
middleName	String	Отчество
maximumPossibleIdentificationLevel	String	Максимально допустимый уровень идентификации. Возможные значения
personId	String	ID клиента
productId	String	ID продукта
identificationDataSource	object	Источник идентификационных данных
identificationDataSource. identificationAgentName	String	Название агента идентификации
identificationDataSource. identificationEndpoint	object	Точка идентификации
identificationDataSource. identificationEndpoint.fullAddress	String	Адрес точки идентификации, в которой клиент оставил заявку

Создание сессии подтверждения SIM-карты

Запрос инициирует отправку SMS-сообщения с OTP (One Time Password, одноразовый пароль) клиенту на указанный номер телефона.

Запрос → PUT

• URL /v1/products/{productId}/full-identification/applications/{applicationId}/sim-confirmation/{confirmationSessionId}

  • productId — ID продукта
  • applicationId — ID заявки
  • confirmationSessionId — клиентский ID подтверждения

Атрибуты тела запроса

Тело запроса

{
  "personId" : "1",
  "mobilePhoneNumber" : "+79271234567",
  "clientDeviceFingerprint" : {
    "IPv4" : "10.12.11.290"
  }
}

Имя	Тип	Описание
clientDeviceFingerprint	object	Сведения о клиентском устройстве, с которого поступил запрос
clientDeviceFingerprint.IPv4	String	IP-адрес клиентского устройства, с которого поступил запрос
mobilePhoneNumber	String	Номер мобильного телефона в международном формате
personId	String	ID клиента

Атрибуты ответа

Тело ответа

{
  "resendDelay" : "PT3M",
  "resendAttemptsLeft" : 3
}

Имя	Тип	Описание
resendAttemptsLeft	integer	Количество оставшихся попыток повторного запроса OTP
resendDelay	String	Интервал времени, через который можно повторно запросить OTP

Повторная отправка SMS-сообщения с OTP

Запрос → POST

• URL /v1/products/{productId}/full-identification/applications/{applicationId}/sim-confirmation/{confirmationSessionId}/resend-otp

  • productId — ID продукта
  • applicationId — ID заявки
  • confirmationSessionId — клиентский ID подтверждения

Атрибуты тела запроса

Тело запроса повторной высылки SMS

{
  "personId" : "1",
  "clientDeviceFingerprint" : {
    "IPv4" : "10.12.11.290"
  }
}

Имя	Тип	Описание
clientDeviceFingerprint	object	Сведения о клиентском устройстве, с которого поступил запрос
clientDeviceFingerprint.IPv4	String	IP-адрес клиентского устройства, с которого поступил запрос
personId	String	ID клиента

Атрибуты ответа

Тело ответа

{
  "resendDelay" : "PT3M",
  "resendAttemptsLeft" : 3
}

Имя	Тип	Описание
resendAttemptsLeft	integer	Количество оставшихся попыток повторного запроса OTP
resendDelay	String	Интервал времени, через который можно повторно запросить OTP

Подтверждение SIM-карты с OTP

Запрос → PUT

• URL /v1/products/{productId}/full-identification/applications/{applicationId}/sim-confirmation/{confirmationSessionId}/confirm-otp

  • productId — ID продукта
  • applicationId — ID заявки
  • confirmationSessionId — клиентский ID подтверждения

Атрибуты тела запроса

Тело запроса подтверждения SIM-карты

{
  "personId" : "1",
  "confirmationCode" : "233210",
  "clientDeviceFingerprint" : {
    "IPv4" : "10.12.11.290"
  }
}

Имя	Тип	Описание
clientDeviceFingerprint	object	Сведения о клиентском устройстве, с которого поступил запрос
clientDeviceFingerprint.IPv4	String	IP-адрес клиентского устройства, с которого поступил запрос
confirmationCode	String	OTP (One Time Password, одноразовый пароль)
personId	String	ID клиента

Атрибуты ответа

Тело ответа

{
  "applicationStatus" : "AWAITING_PASSPORT_CONFIRMATION"
}

Имя	Тип	Описание
applicationStatus	String	Статус (состояние) заявки. Возможные значения

Подтверждение заявки по 4 знакам документа

Запрос → PUT

• URL /v1/products/{productId}/full-identification/applications/{applicationId}/passport-confirmation

  • productId — ID продукта
  • applicationId — ID заявки

Атрибуты тела запроса

Тело запроса подтверждения заявки

{
  "personId" : "1",
  "passportNumberLast4Characters" : "4300",
  "clientDeviceFingerprint" : {
    "IPv4" : "10.12.11.290"
  }
}

Имя	Тип	Описание
clientDeviceFingerprint	object	Сведения о клиентском устройстве, с которого поступил запрос
clientDeviceFingerprint.IPv4	String	IP-адрес клиентского устройства, с которого поступил запрос
passportNumberLast4Characters	String	Последние 4 знака номера документа, удостоверяющего личность
personId	String	ID клиента

Атрибуты ответа

Тело ответа

{
  "applicationStatus" : "IN_PROGRESS"
}

Имя	Тип	Описание
applicationStatus	String	Статус (состояние) заявки. Возможные значения

Получение персональных данных клиента

По умолчанию персональные данные будут маскированными. Если по какой-то причине вам нужны немаскированные данные, обращайтесь к вашему контактному менеджеру.

Запрос → GET

• URL /v1/products/{productId}/persons/{personId}/personal-data

  • productId — ID продукта
  • personId — ID клиента

Ответ

[
  {
    "productId": "1",
    "personId": "8",
    "productIdentificationLevel": "SIMPLIFIED",
    "bankAlias": "QIWI_BANK",
    "firstName": "и***",
    "lastName": "и***",
    "middleName": "и***",
    "citizenshipCountryId": "RU",
    "contacts": {
        "mobilePhoneNumber": "+7***",
        "email": null
    },
    "identifyingDocument": {
        "type": "RUSSIAN_INNER_PASSPORT",
        "series": "3***",
        "number": "1***"
    }
  }
]

JSON-массив объектов с персональными данными.

Атрибуты объекта:

Имя	Тип	Описание
productId	String	ID продукта
personId	String	ID клиента
productIdentificationLevel	String	Текущий уровень идентификации у партнера. Возможные значения
productIdentificationLevelReason	String	Код причины полученного уровня идентификации
bankAlias	String	Акроним системы, в которой клиент получил идентификацию
firstName	String	Имя
lastName	String	Фамилия
middleName	String	Отчество
birthDate	String	Дата рождения клиента (в формате ГГГГ-ММ-ДД)
birthPlace	String	Место рождения клиента
contacts	object	Контактные данные клиента
contacts.email	String	e-mail
contacts.mobilePhoneNumber	String	Номер мобильного телефона в международном формате
citizenshipCountryId	String	Гражданство. ID из справочника стран
identifyingDocument	object	Информация о документе, удостоверяющем личность
identifyingDocument.number	String	Номер документа. Формат: 6 цифр
identifyingDocument.series	String	Серия документа. Только для граждан РФ. Формат: 4 цифры
identifyingDocument.issueDate	String	Дата выдачи документа (в формате ДД.ММ.ГГГГ)
identifyingDocument.issuingAuthorityCode	String	Код подразделения, выдавшего документ
identifyingDocument.issuingAuthorityName	String	Название подразделения, выдавшего документ
identifyingDocument.expiryDate	String	Срок действия документа (в формате ДД.ММ.ГГГГ)
identifyingDocument.type	String	Тип документа. Возможные значения
identifyingDocument. otherDocumentTypeName	String	Название документа, если выбран тип документа OTHER
isPassportExpired	Bool	Признак просроченного паспорта (если true)
isClientActive	Bool	Признак активности клиента: true — клиент активен; false — клиент неактивен
registrationType	String	Тип регистрации: PERMANENT — постоянная, TEMPORARY — временная
registrationAddress	object	Сведения об адресе регистрации
registrationAddress.countryId	String	ID из справочника стран
registrationAddress.zipCode	String	Почтовый индекс
registrationAddress.okatoRegionCode	String	Код субъекта РФ по ОКАТО. Значение из справочника регионов
registrationAddress.district	String	Район
registrationAddress.cityType	String	Тип населенного пункта
registrationAddress.city	String	Наименование населенного пункта
registrationAddress.street	String	Улица
registrationAddress.house	String	Номер дома (владения)
registrationAddress.building	String	Номер корпуса (строения)
registrationAddress.flat	String	Номер квартиры (офиса)
livingAddressIsIdenticalToRegistrationAddress	Bool	Признак того, что адрес проживания совпадает с адресом регистрации
livingAddress	object	Сведения об адресе фактического проживания. Структура объекта совпадает с registrationAddress
secondaryDocuments	array	Массив дополнительных документов
hasInterestOwner	Bool	Признак выгодоприобретателя
hasBeneficialOwner	Bool	Признак того, что лицо является бенефициарным владельцем
publicOfficial	Bool	Признак публичного должностного лица
publicOfficialType	String	Тип публичного должностного лица: RUSSIAN — российское, FOREIGN — иностранное, INTERNATIONAL — международное
publicOfficialPost	String	Занимаемая должность публичного должностного лица
financialPosition	String	Сведения о финансовом положении: GOOD — хорошее, SUFFICIENT — удовлетворительное, BAD — плохое
businessReputation	String	Сведения о деловой репутации: GOOD — положительная, BAD — негативная
fundingSources	String	Сведения об источниках происхождения денежных средств и (или) иного имущества клиента: OWN_FUNDS — собственные средства, BORROWED_FUNDS — заемные средства, OTHER — иное

Деактивация клиента

Деактивация клиента переводит активного клиента из статуса «Активный» в «Неактивный». Физического удаления записи не происходит.

Запрос → POST

• URL /v1/products/{productId}/persons/{personId}/deactivate

  • productId — ID продукта
  • personId — ID клиента

Атрибуты тела запроса

Тело запроса

{
    "deactivationDateTime": "2018-09-24T10:00:00+03:00",
    "deactivationReason": "Здесь причина деактивации клиента"
}

Имя	Тип	Описание
deactivationDateTime	String	Дата/время деактивации клиента (по стандарту ISO 8601)
deactivationReason	String	Причина деактивации клиента

Тело ответа отсутствует.

В случае успешного выполнения возвращается код ответа сервера 204. При повторной деактивации уже неактивного клиента возвращается код ответа сервера 400.

Дополнительные документы

ИНН

Атрибуты

ИНН

{
  "type" : "INN",
  "number" : "500100732259"
}

Имя	Тип	Описание
number	String	ИНН
type	String	Тип документа. Передавать значение INN

СНИЛС

Атрибуты

СНИЛС

{
  "type" : "SNILS",
  "number" : "112-233-445 95"
}

Имя	Тип	Описание
number	String	СНИЛС
type	String	Тип документа. Передавать значение SNILS

Разрешение на проживание

Атрибуты

Разрешение на проживание

{
  "type" : "RESIDENCE_PERMIT",
  "residencePermitType" : "VISA",
  "number" : "N4321",
  "dateFrom" : "11.09.2015",
  "dateTo" : "11.09.2021",
  "issuingAuthorityName" : "МИД РФ"
}

Имя	Тип	Описание
dateFrom	String	Дата выдачи
dateTo	String	Дата окончания действия документа
issuingAuthorityName	String	Орган, выдавший документ, подтверждающий право на пребывание в РФ
number	String	Номер документа
residencePermitType	String	Вид разрешения на пребывание. Значения: VISA, PERMANENT_RESIDENCE_PERMIT, TEMPORARY_RESIDENCE_PERMIT
type	String	Тип документа. Передавать значение RESIDENCE_PERMIT

Миграционная карта

Атрибуты

Миграционная карта

{
  "type" : "MIGRATION_CARD",
  "serial" : "4321",
  "number" : "43211234",
  "dateFrom" : "11.09.2015",
  "dateTo" : "11.09.2021"
}

Имя	Тип	Описание
dateFrom	String	Дата начала срока пребывания
dateTo	String	Дата окончания срока пребывания
number	String	Номер
serial	String	Серия
type	String	Тип документа. Передавать значение MIGRATION_CARD

Патент на работу

Атрибуты

Патент на работу

{
  "type" : "WORKING_PATENT",
  "series" : "77",
  "number" : "8843211234",
  "issuingAuthorityName" : "ФМС",
  "issueDate" : "11.09.2015",
  "documentSeries" : "РА",
  "documentNumber" : "4000123"
}

Имя	Тип	Описание
documentNumber	String	Номер бланка документа
documentSeries	String	Серия бланка документа
issueDate	String	Дата выдачи
issuingAuthorityName	String	Орган, выдавший патент
number	String	Номер
series	String	Серия
type	String	Тип документа. Передавать значение WORKING_PATENT

Справочники

Справочник стран (гражданств)

Запрос → GET

• URL /dictionary/v1/countries

Справочник стран (фрагмент)

[
  {
    "id": "AF",
    "name": "АФГАНИСТАН"
  },
  {
    "id": "AL",
    "name": "АЛБАНИЯ"
  }
]

В ответе приходит json-массив со списком стран.

Имя	Тип	Описание
id	String	ID страны
name	String	Название страны

Справочник регионов России

Запрос → GET

• URL /dictionary/v1/russian-regions

В ответе приходит json-массив со списком регионов РФ.

Справочник регионов России (фрагмент)

[
  {
    "okatoRegionCode": "79",
    "name": "Республика Адыгея"
  },
  {
    "okatoRegionCode": "84",
    "name": "Республика Алтай"
  }
]

Имя	Тип	Описание
name	String	Название региона
okatoRegionCode	String	Код субъекта РФ по ОКАТО

HTTP-статусы и формат ответов

Код	Описание	Тело ответа
200	OK (запрос успешно выполнен)	Тело успешного ответа
201	Created (запрос успешно выполнен, ресурс создан)	Тело успешного ответа
204	No Content (запрос успешно выполнен)	Тело ответа отсутствует
400	Bad Request (некорректный запрос)	Стандартный json ошибки
401	Unauthorized (в запросе отсутствует корректная авторизация)	Пустое тело, либо стандартный json ошибки
403	Forbidden (операция запрещена)	Стандартный json ошибки
404	Not Found (ресурс не найден)	Пустое тело, либо стандартный json ошибки
422	Unprocessable Entity (ошибка валидации запроса)	Стандартный json ошибки
423	Locked (временно заблокирован)	Стандартный json ошибки
500	Internal Server Error (внутренняя ошибка сервера)	Пустое тело, либо стандартный json ошибки

Атрибуты описания ошибки

Стандартный json ошибки

{
    "serviceName": "openapi-identification",
    "errorCode": "internal.error",
    "description": "Undefined error. Please try to make operation later.",
    "userMessage": "Undefined error. Please try to make operation later.",
    "dateTime": "2018-09-03T18:41:27.016+03:00",
    "traceId": "4a3c694ca580a5e0"
}

Имя	Тип	Описание
serviceName	String	Название сервиса, возвратившего ошибку
errorCode	String	Код ошибки (см. далее)
description	String	Описание ошибки
userMessage	String	Пользовательское описание ошибки
dateTime	String	Дата и время формирование ответа
traceId	String	Параметр, необходимый для анализа логов. Его значение также всегда присутствует в заголовке ответа X-B3-TraceId

При возвращении ошибки валидации запроса в JSON-объекте может присутствовать объект cause. В объекте дополнительно описывается, какие ошибки и для каких полей были допущены.

Ошибка с полем cause

{
    "serviceName": "openapi-identification",
    "errorCode": "validation.error",
    "description": "Данные некорректны",
    "userMessage": "Данные некорректны",
    "dateTime": "2018-09-05T13:55:57.897+03:00",
    "traceId": "c8d2b66274672789",
    "cause": {
        "birthDate": [
            "may not be null"
            ]
    }
}

Возможные коды ошибок (атрибут errorCode):

Код	Описание
internal.error	Внутренняя ошибка сервиса
http.message.conversion.failed	Ошибка десериализации сообщения
validation.error	Ошибка валидации (некорректное тело запроса)
forbidden.operation	Операция запрещена
data.not.found	Данные не найдены
inapplicable.operation	Операция не применима для сущности в ее текущем состоянии
secondary.document.invalid	Некорректный второй документ
application.in.progress.already.exists	В данный момент есть незавершенная заявка, которая находится в обработке, или ожидании получения всех данных
invalid.confirmation.factor.value	Неверное значение фактора подтверждения
passport.confirmation.attempts.exceeded	Превышено количество попыток подтверждения паспорта
sim.confirmation.attempts.exceeded	Превышено количество попыток подтверждения sim-карты
confirmation.session.expired	Время жизни сессии подтверждения истекло
incorrect.confirmation.code.error	Неверный OTP (One Time Password, одноразовый пароль)
confirmation.attempts.limit.exceeded.error	Попытки подтверждения исчерпаны
operation.inapplicable	Операция не применима
incorrect.request.parameter	Неверный параметр запроса
invalid.confirmation.data	Неверные данные подтверждения

Значения перечислимых атрибутов

Статусы заявки

Статус	Описание
PROCESSING_FINISHED	Обработка завершена
IN_PROGRESS	В процессе обработки
AWAITING_PRODUCT_CHECKS	Ожидается завершение проверок
AWAITING_SIM_CONFIRMATION	Ожидается подтверждение сим-карты
AWAITING_PASSPORT_CONFIRMATION	Ожидается подтверждение идентификации
AWAITING_AGENT_VERIFICATION	Ожидается верификация заявки у агента (для заявок на сайте)

Типы документов, удостоверяющих личность

Тип	Описание
RUSSIAN_INNER_PASSPORT	Внутренний паспорт РФ
FOREIGN_COUNTRY_IDENTIFYING_DOCUMENT	Документ, удостоверяющий личность иностранного гражданина, выданный его государством
TEMPORARY_RESIDENCE_PERMIT	Разрешение на временное проживание
PERMANENT_RESIDENCE_PERMIT	Вид на жительство
REFUGEE_CERTIFICATE	Удостоверение беженца
OTHER	Иной документ

Код причины полученного уровня идентификации

Список значений полей identificationLevelReasonCode, productIdentificationLevelReason.

Код	Описание
smev.personal.data.not.found	Данные клиента не найдены в СМЭВ
smev.personal.data.invalid	Данные клиента не прошли проверку в СМЭВ
simplified.secondary.documents.constraints.validation.failed	Упрощенная идентификация: невалидный второй документ
simplified.secondary.documents.missing	Упрощенная идентификация: отсутствует второй документ
general.constraints.validation.failed	Ошибка валидации
person.is.unreliable	Переданные персональные данные обнаружены в списках ограничений
passport.expired	Паспорт просрочен
full.identification.exists	У клиента уже есть полная идентификация
one.passport.accounts.limit.exceeded	Превышено ограничение на максимальное количество аккаунтов на один паспорт
person.account.is.deactivated	Аккаунт клиента уже закрыт
personal.data.not.accepted	Клиенту нельзя предоставить идентификацию согласно текущим правилам
identification.application.is.expired	Срок жизни незаполненной заявки истек
passport.confirmation.attempts.exceeded	Превышено количество попыток подтверждения паспорта
sim.confirmation.attempts.exceeded	Превышено количество попыток подтверждения sim-карты
personal.data.and.level.cannot.be.updated.by.submitted.application	Заявка нарушает правила обновления существующего клиента при повышении уровня или повторном прохождении идентификации

Уровень идентификации

Список значений полей identificationLevel, productIdentificationLevel.

Уровень	Описание
SIMPLIFIED	Упрощенная
FULL	Полная
NOT_VERIFIED	Не идентифицирован