Ошибка валидации неверный номер карты киви

Последнее обновление: 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"
  }
}

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

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

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

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

Запрос → 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
  }
}

Создание сессии подтверждения 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"
  }
}

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

Тело ответа

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

Повторная отправка 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"
  }
}

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

Тело ответа

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

Подтверждение 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"
  }
}

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

Тело ответа

{
  "applicationStatus" : "AWAITING_PASSPORT_CONFIRMATION"
}

Подтверждение заявки по 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"
  }
}

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

Тело ответа

{
  "applicationStatus" : "IN_PROGRESS"
}

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

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

Запрос → 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-массив объектов с персональными данными.

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

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

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

Запрос → POST

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

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

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

Тело запроса

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

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

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

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

ИНН

Атрибуты

ИНН

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

СНИЛС

Атрибуты

СНИЛС

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

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

Атрибуты

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

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

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

Атрибуты

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

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

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

Атрибуты

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

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

Справочники

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

Запрос → GET

• URL /dictionary/v1/countries

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

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

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

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

Запрос → GET

• URL /dictionary/v1/russian-regions

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

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

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

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

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

Стандартный 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"
}

При возвращении ошибки валидации запроса в 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):

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

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

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

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

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

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

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

Предлагаю расширить коды ошибок для транзакций:

{
  "3": "Техническая ошибка, нельзя отправить запрос провайдеру",
  "4": "Неверный формат счета/телефона",
  "5": "Номер не принадлежит оператору",
  "8": "Прием платежа запрещен по техническим причинам",
  "13": "Сервер занят, повторите запрос через минуту",
  "74": "Ошибка платежа. Временный технический сбой",
  "130": "Платеж в адрес выбранного провайдера невозможен",
  "131": "Платежи на выбранного провайдера запрещено проводить из данной страны.",
  "155": "Прием платежа для данного провайдера запрещен",
  "202": "Ошибка в параметрах запроса",
  "203": "Ошибка авторизации пользователя",
  "206": "Кошелек временно заблокирован службой безопасности. Обратитесь в поддержку",
  "220": "Недостаточно средств",
  "241": "Сумма платежа меньше минимальной",
  "242": "Сумма платежа больше максимальной",
  "270": "Ошибка на стороне провайдера (получателя)",
  "300": "Техническая ошибка. Проверьте правильность введенных данных или повторите попытку позже. Возможно отправитель и получатель совпадают!",
  "319": "Платеж невозможен",
  "402": "Вас давно не было. =( Начните авторизацию заново.",
  "500": "По техническим причинам этот платеж не может быть выполнен. Для совершения платежа обратитесь, пожалуйста, в свой обслуживающий банк",
  "521": "Неверный счет или БИК плательщика",
  "522": "Неверный номер или срок действия карты получателя",
  "542": "Неверный номер карты получателя",
  "544": "Ошибка платежа",
  "547": "Ошибка в сроке действия карты получателя",
  "548": "Истек срок действия карты получателя",
  "561": "Платеж отвергнут оператором банка получателя",
  "601": "Недопустимое значение кода подтверждения",
  "702": "Платеж не проведен из-за ограничений у получателя",
  "705": "Ежемесячный лимит платежей и переводов для статуса Стандарт - 200 000 р. Для увеличения лимита пройдите идентификацию.",
  "704": "Ошибка платежа",
  "745": "Ошибка платежа",
  "746": "Превышен лимит по платежам в пользу провайдера",
  "747": "Превышен лимит по платежам в пользу провайдера",
  "750": "Ошибка платежа",
  "780": "Проведение платежа запрещено СБ",
  "801": "Кажется, что-то пошло не так. Пожалуйста, авторизуйтесь заново",
  "852": "Превышен лимит по платежам в пользу провайдера",
  "868": "Платеж не проведен. 5 000 рублей — лимит на переводы в месяц. Повысьте статус идентификации в Профиле и переводите без ограничений.",
  "893": "Срок действия перевода истек",
  "901": "Ошибка платежа",
  "934": "Cервис недоступен в стране пользователя",
  "943": "Ошибка платежа",
  "1001": "Кажется, что-то пошло не так. Повторите попытку позже.",
  "1018": "Пул номеров страны не активен",
  "1021": "Ограничение исходящих платежей",
  "1022": "Пополнение чужого номера запрещено",
  "1050": "Превышен лимит на операции, либо превышен дневной лимит на переводы на карты Visa/MasterCard",
  "1066": "Ошибка платежа",
  "7700": "Провайдер заблокирован",
  "7703": "Персона заблокирована"
}
``