Verification статус

Введение

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

Verification статус запрос is made by Присоединяющаяся сторона’s app to site.company_название to get the статус of verification транзакция. SBC
Рекомендуется отправлять запрос Verification статус в течение 2-3 минут с интервалом 3-5 секунд между запросами.
Присоединяющаяся сторона’s server should rely on the callback for final статус.

API URL

Примечание

Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.

Интеграционная среда

Производственная среда

https://sandbox.sbctech.ru/paynet/dapi/v1/verification/{endpointId}/{invoiceId}/status

https://gate.sbctech.ru/paynet/dapi/v1/verification/{endpointId}/{invoiceId}/status

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

Название параметра

Описание

Значение

session
Необходимость: Обязательно
Тип: Object

session.accessToken

The access token key received in Необязательное потребителя authentication.
Необходимость: Обязательно
Тип: String
Длина: 32-128

session.token

Токен сеанса транзакции верификации.
Необходимость: Обязательно
Тип: String
Длина: 16-36

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

Название параметра

Описание

Значение

invoiceId

Идентификатор транзакции верификации.
Тип: String

session
Тип: Object

session.token

Токен сеанса транзакции верификации.
Тип: String

state

Возможные значения: PROCESSING, REDIRECT_REQUEST, APPROVED, DECLINED.
Тип: Enum

bankOrderId

Обязательное if state is APPROVED or DECLINED.
Необходимость: Условно
Тип: String
Длина: 128

redirectUrl

Обязательное if state is REDIRECT_REQUEST.
Необходимость: Условно
Тип: String
Длина: 128

errorCode

Код причины отклонения; может присутствовать, если состояние — DECLINED.
Необходимость: Опционально
Тип: Integer
Длина: 128

errorMessage

Сообщение о причине отклонения; может присутствовать, если состояние — DECLINED.
Необходимость: Опционально
Тип: String
Длина: 128

secure3DAuthStatus

Возможные значения: AUTHENTICATED, NOT_AUTHENTICATED, UNSUPPORTED. UNSUPPORTED означает, что карта не поддерживает 3-D Secure или процесс аутентификации 3DS завершился с неизвестным статусом.
Необходимость: Опционально
Тип: Enum

randomSumAuthStatus

Возможные значения: AUTHENTICATED, NOT_AUTHENTICATED.
Необходимость: Опционально
Тип: Enum

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

Название параметра

Описание

Значение

error
Тип: Object

error.cause

Причина ошибки. Возможные значения: FILTERED, INVALID_REQUEST, INTERNAL_ERROR, PROCESSING_FAILED, ORDER_NOT_FOUND.
Тип: Enum

error.code

Уникальный код ошибки.
Тип: String

error.message

Описание ошибки.
Тип: String

invoiceId

Идентификатор транзакции верификации.
Тип: String

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

{
  "session": {
    "accessToken": "string",
    "token": "string"
  }
}

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

{
  "bankOrderId": "string",
  "invoiceId": "string",
  "redirectUrl": "string",
  "session": {
    "token": "string"
  },
  "state": "enum"
}

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

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

Конструктор запросов

Endpoint Id
Invoice Id

Generated by Merchant's server in "Initiate verification"

session.accessToken

Generated by Merchant's server in "Consumer authentication"

session.token

Obtained in "Perform validation" response