Уведомление о сопоставлении карты Verification

Введение

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

Уведомление о сопоставлении карт позволяет сопоставлять учётные данные Consumer (телефон, e-mail, адрес выставления счёта, имя в Twitter и т. д.) с данными карты. Сопоставления можно использовать в транзакциях Transfer или Sale вместо номеров карт и иной информации о держателе карты. SBC отправляет запрос уведомления о сопоставлении карты Verification на сервер/прокси Присоединяющейся стороны с созданной на своей стороне ссылкой на карту — {serverCardId}.

Сервер Присоединяющейся стороны сопоставляет {serverCardId} с созданным на своей стороне {clientCardId}. Затем {clientCardId} может быть сопоставлен в приложении или на сервере Присоединяющейся стороны с любыми данными Consumer из исходного запроса Perform validation. Это позволяет приложению Присоединяющейся стороны обрабатывать транзакции Sale или Transfer по электронному адресу Consumer, номеру телефона и т. д.

{uniqueReferenceCardId} остаётся неизменным, если клиент выполняет другую проверку с тем же номером карты, но, например, с другой датой истечения срока действия. Присоединяющаяся сторона может использовать его для программ лояльности или контроля мошенничества.

API URL

Примечание

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

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

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

Название параметра	Описание	Значение
consumer		Тип: Object
consumer.device		Тип: Object
consumer.device.serialNumber	Серийный номер устройства потребителя.	Тип: String Длина: 1-50
reference		Тип: Object
reference.serverCardId	Идентификатор ссылки на карту (на стороне сервера).	Тип: String Length: 1-64
reference.uniqueReferenceCardId	Идентификатор карты (на стороне сервера).	Тип: Integer
session		Тип: Object
session.accessToken	Ключ токена доступа потребителя.	Тип: String Длина: 32-128
session.token	Токен сеанса транзакции верификации.	Тип: String Длина: 16-36
sourceCard		Тип: Object
sourceCard.bin	BIN исходной карты.	Тип: Integer

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

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

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

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

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

{
  "consumer": {
    "device": {
      "serialNumber": "string"
    }
  },
  "reference": {
    "serverCardId": "string",
    "uniqueReferenceCardId": "integer"
  },
  "sourceCard": {
    "bin": "integer"
  },
  "session": {
    "accessToken": "string",
    "token": "string"
  }
}

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

{
  "invoiceId": "string",
  "session": {
    "checkSignature": "string",
    "nonce": "string",
    "token": "string"
  }
}

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

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