Спецификация команд

Команда TRANSFER_PREPARE

Параметры запроса:
Параметр Описание Значение параметра Обязательность
action Тип операции TRANSFER_PREPARE
client_key Уникальный ключ Клиента (CLIENT_KEY)
client_order_id ID перевода в системе Клиента Строка до 255 символов
sender_card_number Номер карты Отправителя перевода
sender_card_exp_month Месяц окончания срока действия карты Отправителя Месяц в формате XX
sender_card_exp_year Год окончания срока действия карты Отправителя Год в формате XXXX
sender_card_cvv2 CVV/CVC2 код карты Отправителя 3-4 символа
receiver_card_number Номер карты Получателя
transfer_amount Сумма перевода Число в формате XXXX.XX
transfer_currency Валюта перевода 3-символьный код
sender_phone Номер телефона Отправителя Строка до 32 символов
sender_ip IP-адрес Отправителя XXX.XXX.XXX.XXX
term_url_3ds URL на который необходимо вернуть отправителя, после прохождения 3DS.
Поле является обязательным, если аккаунт поддерживает 3D-Secure.
Строка до 1024 символов
signature Подпись запроса

Команда используется для регистрации в Платежной Платформе данных для выполнения перевода, а также расчета комиссии за перевод.

Успешный ответ:
Параметр Описание
action TRANSFER_PREPARE
result SUCCESS
status INIT
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
transfer_amount Сумма перевода
transfer_commission Сумма комиссии
transfer_currency Валюта перевода
transaction_date Дата транзакции
Не успешный ответ:
Параметр Описание
action TRANSFER_PREPARE
result DECLINED
status DECLINED
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
decline_reason Причина отказа
transaction_date Дата транзакции

Команда TRANSFER_RUN

Описание параметров
Параметр Описание Значение параметра Обязательность
action Тип операции TRANSFER_RUN
client_key Уникальный ключ Клиента (CLIENT_KEY)
transfer_id ID перевода в Платежной платформе
sender_card_cvv2 CVV/CVC2 код карты Отправителя 3-4 символа
signature Подпись запроса

Команда используется для начала выполнения перевода по ранее введенным данным.

В зависимости от используемых карт и настроек аккаунта, может потребоваться выполнить дополнительную проверку или проверки.

Успешный ответ, если не выполняется 3DS или Look-up проверка
Параметр Описание
action TRANSFER_RUN
result SUCCESS
status SETTLED
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
transaction_date Дата транзакции
Успешный ответ, если необходимо выполнить 3DS
Параметр Описание
action TRANSFER_RUN
result SUCCESS
status 3DS
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
redirect_url URL на который необходимо перенаправить Отправителя
redirect_params Массив параметров
redirect_method POST или GET
transaction_date Дата транзакции

После этого, необходимо выполнить редирект плательщика (Отправителя) на redirect_url (ACS сервер банка-эмитента карты), с параметрами redirect_params, которые должны быть отправлены методом POST или GET (см. redirect_method). После прохождения 3DS, плательщик будет переадресован на term_url_3ds.

Для дальнейшей работы, чтобы узнать результат прохождения 3DS — необходимо обязательно выполнить запрос TRANSFER_STATUS. На основе полученного статуса перевода, необходимо инициировать дальнейшие команды.

Например:
— если получен статус SETTLED – значит, проверка прошла успешно, и перевод уже выполнен.
— если получен статус LOOKUP – значит, проверка прошла неуспешно, и необходимо пройти еще Look-up проверку.

Успешный ответ, если необходимо выполнить Look-up проверку
Параметр Описание
action TRANSFER_RUN
result SUCCESS
status VERIFICATION_BCODE
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
transaction_date Дата транзакции

Для дальнейшей работы необходимо выполнить команду TRANSFER_VERIFY

Не успешный ответ:
Параметр Описание
action TRANSFER_RUN
result DECLINED
status DECLINED
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
transaction_date Дата транзакции

Команда TRANSFER_VERIFY

Параметры запроса:
Параметр Описание Значение параметра Обязательность
action Тип операции TRANSFER_PREPARE
client_key Уникальный ключ Клиента (CLIENT_KEY)
transfer_id ID перевода в Платежной платформе
sender_card_cvv2 CVV/CVC2 код карты Отправителя 3-4 символа
lookup_code Проверочный код полученный Отправителем 6 цифр в формате XXXXXX
signature Подпись запроса
Успешный ответ
Параметр Описание
action TRANSFER_VERIFY
result SUCCESS
status SETTLED
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
transaction_date Дата транзакции
Не успешный ответ
Параметр Описание
action TRANSFER_VERIFY
result DECLINED
status DECLINED
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной платформе
decline_reason Причина отказа
transaction_date Дата транзакции

Команда TRANSFER_STATUS

Параметры запроса:
Параметр Описание Значение параметра Обязательность
action Тип операции TRANSFER_STATUS
client_key Уникальный ключ Клиента (CLIENT_KEY)
transfer_id ID перевода в Платежной платформе
signature Подпись запроса

Команда используется для получения текущего статуса и данных о переводе.

Команду можно выполнить в любой момент после того, как перевод был зарегистрирован в Платежной Платформе с соответствующим идентификатором.

Не успешный ответ
Параметр Описание
action TRANSFER_STATUS
result SUCCESS
status Текущий статус перевода
client_order_id ID перевода в системе Клиента
transfer_id ID перевода в Платежной Платформе
sender_card_bin BIN карты Отправителя
sender_card_last4 Последние 4 цифры номера карты Отправителя
receiver_card_bin BIN карты Получателя
receiver_card_last4 Последние 4 цифры номера карты Получателя
sender_phone Номер телефона Отправителя
transfer_amount Сумма перевода
transfer_commission Сумма комиссии
transfer_total Общая сумма операции (сумма перевода + сумма комиссии)
transfer_currency Валюта перевода
redirect_url URL на который необходимо перенаправить Отправителя
redirect_params Массив параметров
redirect_method POST или GET
decline_reason Причина отказа
transfer_date Дата перевода

Ошибки

В случае невозможности обработать запрос, будет отправлено сообщение об ошибке:
Параметр Описание
result ERROR
error_message Текст сообщения об ошибке