Sale статус

Введение

Sale статус инициируется через запрос HTTPS POST с использованием URLs и parameters.
Sale статус запрос is made by Присоединяющаяся сторона’s app to site.company_название to get the статус of sale транзакция. SBC
Рекомендуется отправлять запрос статуса Sale в течение 2–3 минут с интервалом 3–5 секунд между запросами. Сервер Присоединяющейся стороны должен полагаться на callback для получения окончательного статуса.

API URL

Примечание

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

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

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

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

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

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

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

Описание

Значение

session
Тип: Object

session.accessToken

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

session.token

Session token транзакции sale.
Тип: String
Длина: 16-36

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

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

Описание

Значение

invoiceId

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

session
Тип: Object

session.token

The session token of sale транзакция
Тип: 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

orderId

Идентификатор заказа в системе обработки платежей.
Необходимость: Условно
Тип: String

transaction

Необходимость: Условно
Тип: Object

transaction.amountCentis

Сумма денежного перевода в центах: 1,00 EUR = 100 центов.
Необходимость: Условно
Тип: Integer

transaction.commissionCentis

Сумма удержанной комиссии в центах (зависит от интеграции).
Необходимость: Условно
Тип: Integer

transaction.orderCreatedDate
Дата создания заказа в системе обработки платежей.
Необходимость: Условно
Тип: String

transaction.transactionCreatedDate

Дата создания транзакции в системе обработки платежей.
Необходимость: Условно
Тип: String

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

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

Идентификатор транзакции sale.
Тип: 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 sale"

session.accessToken

Generated by Merchant's server in "Consumer authentication"

session.token

Obtained in "Perform sale" response