Инициировать проверку

Введение

Инициация проверки выполняется запросом HTTPS POST с использованием URL-адресов и параметров.

Чтобы инициировать верификацию карты, приложение Присоединяющейся стороны отправляет {accessToken} с другими параметрами устройства на сервер Присоединяющейся стороны. Эти параметры используются для начала сессии с уникальными случайными {nonce} и зашифрованной {signature}. В ответ сервер Присоединяющейся стороны также предоставляет информацию о {invoiceId} в системе Присоединяющейся стороны и {endpointId} в SBC.

API URL

Примечание

Это пример URL на сервере Присоединяющейся Стороны.

Сервер Присоединяющейся Стороны
https://proxy.connectingpartyserver.com/verification/initiate-verification

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

Название параметра	Описание	Значение
consumer		`Необходимость`: Обязательно `Тип`: Object
consumer.device		`Необходимость`: Обязательно `Тип`: Object
consumer.device.serialNumber	Серийный номер устройства потребителя.	`Необходимость`: Обязательно `Тип`: String `Длина`: 1-50
transaction		`Необходимость`: Обязательно `Тип`: Object
transaction.currency	Буквы верхнего регистра (alpha-код по ISO 4217).	`Необходимость`: Обязательно `Тип`: String `Длина`: 3
session		`Необходимость`: Обязательно `Тип`: Object
session.accessToken	Ключ токена доступа, полученный при необязательной аутентификации потребителя.	`Необходимость`: Обязательно `Тип`: String `Длина`: 32-128
consumer.device.imei	Международный идентификатор мобильного оборудования устройства потребителя.	`Необходимость`: Опционально `Тип`: String `Длина`: 14-16
location		`Необходимость`: Опционально `Тип`: Object
location.lat	Широта указывается в диапазоне от -90.0 до +90.0 включительно.	`Необходимость`: Опционально `Тип`: Double
location.lng	Долгота указывается в диапазоне от -180.0 до +180.0 включительно.	`Необходимость`: Опционально `Тип`: Double
consumer.ipAddresses	IP-адреса потребителя.	`Необходимость`: Опционально `Тип`: List
consumer.ipAddresses[]	IP-адрес потребителя.	`Необходимость`: Опционально `Тип`: String `Длина`: 7-15

Параметры успешного ответа

Название параметра	Описание	Значение
endpointId	Идентификатор точки входа для транзакции Verification.	`Тип`: String
invoiceId	Идентификатор транзакции верификации.	`Тип`: String
session		`Тип`: Object
session.nonce	Уникальная случайная строка, сгенерированная сервером Присоединяющейся стороны.	`Тип`: String
session.signature	Контрольная сумма, сгенерированная hmac-sha1 (см. Вычисление подписи) из конкатенации accessToken, consumer.device.serialNumber, endpointId, session.nonce, invoiceId и transaction.currency.	`Тип`: String

Параметры неуспешного ответа

Название параметра	Описание	Значение
error		`Тип`: Object
error.cause	Причина ошибки. Возможные значения: `FILTERED`, `INVALID_REQUEST`, `SERVER_FAILED`, `SERVER_UNAVAILABLE`.	`Тип`: Enum
error.code	Уникальный код ошибки.	`Тип`: String
error.message	Описание ошибки.	`Тип`: String

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

{
  "consumer": {
    "device": {
      "imei": "string",
      "serialNumber": "string"
    },
    "ipAddresses": ["string"]
  },
  "location": {
    "lat": "double",
    "lng": "double"
  },
  "session": {
    "accessToken": "string"
  },
  "transaction": {
    "currency": "string"
  }
}

Пример успешного ответа

{
  "endpointId": "string",
  "invoiceId": "string",
  "session": {
    "nonce": "string",
    "signature": "string"
  }
}

Пример неуспешного ответа

{
  "error": {
    "cause": "enum",
    "code": "string",
    "message": "string"
  }
}