Transfer статус

Введение

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

API URL

Примечание

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

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

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

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

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

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

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

Описание

Значение

session
Тип: Object

session.accessToken

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

session.token

Token сессии транзакции transfer.
Тип: String
Длина: 16-36

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

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

Описание

Значение

invoiceId

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

session
Тип: Object

session.token

Token сессии транзакции transfer.
Тип: String

state

Возможные значения: PROCESSING, REDIRECT_REQUEST, APPROVED, DECLINED. Если включены заданные Покупателем тарифы перевода, возвращается TRANSFER_FEE_REQUEST.
Тип: 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 означают, что карта не поддерживает 3-D Secure либо процесс аутентификации 3DS завершился с неизвестным статусом.
Необходимость: Опционально
Тип: Enum

randomSumAuthStatus

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

Параметры успешного ответа для определённых клиентом тарифов Transfer

Ответ статуса Transfer содержит параметр state со значением TRANSFER_FEE_REQUEST и объект transferFeeList со списком комиссий для возможных гейтов обработки. Каждый гейт обработки представлен собственным псевдонимом в параметре assignedId. Значение TRANSFER_FEE_REQUEST параметра state существует только в потоке «Consumer defined transfer rates».
Когда транзакция достигает состояния TRANSFER_FEE_REQUEST, обработка останется приостановленной, пока не будет отправлен запрос Complete transfer.

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

Описание

Значение

transferFeeList
Тип: Object

transferFeeList.assignedId

Aliased платёж gateway название.
Тип: String

transferFeeList.commissionCentis

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

transferFeeList.currency

Буквы верхнего регистра (alpha-код по ISO 4217).
Тип: String

state

Помимо значений из Status Transfer, только в этом процессе существует значение TRANSFER_FEE_REQUEST.
Тип: String

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

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

Описание

Значение

error
Тип: Object

error.cause

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

error.code

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

error.message

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

invoiceId

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

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

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

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

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

Success Ответ Example for Потребитель defined transfer rates


Следующая структура расширяет стандартное тело ответа о статусе Transfer (например, 2 обрабатывающих шлюза):

{
  "bankOrderId": "string",
  "invoiceId": "string",
  "redirectUrl": "string",
  "session": {
    "token": "string"
  },
  "state": "TRANSFER_FEE_REQUEST",
  "transferFeeList": [
    {
      "assignedId": "string",
      "commissionCentis": "integer",
      "currency": "string"
    },
    {
      "assignedId": "string",
      "commissionCentis": "integer",
      "currency": "string"
    }
  ]
}

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

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

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

Endpoint Id
Invoice Id

Generated by Merchant's server in "Initiate transfer"

session.accessToken

Generated by Merchant's server in "Consumer authentication"

session.token

Obtained in "Perform transfer" response