Sale статус

Введение

Sale статус инициируется через запрос HTTPS POST с использованием URLs и parameters.
Запрос статуса Sale отправляется приложением Присоединяющейся стороны в SBC для получения статуса транзакции Sale.
Рекомендуется отправлять запрос статуса 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	Ключ токена доступа, полученный при необязательной аутентификации потребителя.	`Тип`: String `Длина`: 32-128
session.token	Session token транзакции sale.	`Тип`: String `Длина`: 16-36

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

Название параметра	Описание	Значение
invoiceId	Идентификатор транзакции sale.	`Тип`: String
session		`Тип`: Object
session.token	Токен сессии транзакции Sale	`Тип`: String
state	Возможные значения: `PROCESSING`, `REDIRECT_REQUEST`, `APPROVED`, `DECLINED`.	`Тип`: Enum
bankOrderId	Обязательно, если state имеет значение `APPROVED` или `DECLINED`.	`Необходимость`: Условно `Тип`: String `Длина`: 128
redirectUrl	Обязательно, если state имеет значение `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

Curl for Unix
Curl for Windows