Чтобы посмотреть этот PDF файл с форматированием и разметкой, скачайте его и откройте на своем компьютере.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
ИНСТРбК
ж
Ис ПО ИНТЕГРАжИИ И
оКСПЛбАТАжИИ ПЛАТЕЖНОЙ
П
Л
АТФОРМм
RSB
_
ECOMM
МОСКВА
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
2
|
Страница
ОглТвление
Введение
................................
................................
................................
................................
......................
4
1.
Общая функциональная схема
................................
................................
................................
...........
4
2. Настройка сервиса
................................
................................
................................
................................
...
6
3.1.
ИнтегрТция
................................
................................
................................
................................
.....
7
3.1.1.
ПоФготовкТ к реТлизТции
................................
................................
................................
........
8
3.1.2.
Регистрация SaS транзакции
................................
................................
................................
.....
9
3.1.2.1.
ЗТпрос стТтусТ.
................................
................................
................................
.....................
10
3.1.3.
РегистрТция DM3 трТнзТкции (ТвторизТция)
................................
................................
...
11
3.1.4.
Выполнение/Расчет DaS транзакции
................................
................................
......................
14
3.1.5.
ОтменТ/ВозврТт трТнзТкции
................................
................................
................................
16
3.1.6.
ЗТкрытие бизнес
-
Фня
................................
................................
................................
..............
19
3.2.
Регулярные (рекуррентные) плТтежи
................................
................................
....................
20
3.2.1.
РегистрТция регулярного (рекуррентного) плТтежТ
................................
.......................
20
3.2.2.
Повторное списТние регулярного плТтежТ
................................
................................
........
24
4. Переадресация Клиента
................................
................................
................................
.......................
27
5. бведомление об успешном платеже посредством электронной почты
................................
..........
28
6. Изменение максимального времени
для проведения транзакции клиентом
................................
29
7. Информация о маршруте полета в авиакомпанию
–
длинная запись (Airline itinerary)
................
30
8. Выставление счета на оплату по электронной почте / на мобильный телефон Клиента (в
формате
SMS
сообщения)
................................
................................
................................
.........................
32
9. Сервис
M
aster
P
ass.
................................
................................
................................
................................
33
10. Примеры реализации бизнес логики запросов при условии размещения платежной страницы
на стороне организации / провайдера (2.5
Party
).
................................
................................
.................
35
10
.1 Краткое описание функционала:
................................
................................
................................
.
35
10.2 Команды (идентификаторы) используемые при регистрации транзакций:
...........................
35
10.3 Описание пе
ременных:
................................
................................
................................
.................
36
10.4 Адрес платежного шлюза Банка (тест):
................................
................................
.......................
37
10.5 SaS транзакция
................................
................................
................................
.............................
37
10.6
DMS
авторизация
................................
................................
................................
...........................
37
10.7 DaS транзакция/выполнение (используется при W, N)
................................
..............................
38
10.8
Создание
шаблона
recurrent (SMS
транзакция
)
................................
................................
..........
38
10.9 Создание шаблона recurrent (
DMS
авторизация)
................................
................................
.......
38
10.10 Выполнение/вызов шаблона recurrent (SaS транзакция)
................................
.......................
39
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
3
|
Страница
10.11
бдаление
шаблона
recurrent
................................
................................
................................
......
39
10.12 Возврат
................................
................................
................................
................................
.........
40
10.13
Отмена
................................
................................
................................
................................
..........
40
10.14 Запрос ста
туса (используется при L, U, W, N)
................................
................................
...............
40
10.15 Завершение бизнес
-
дня
................................
................................
................................
............
41
10.16
Сервис
MasterPass.
................................
................................
................................
......................
41
11. Передача email / телефона клиента
................................
................................
................................
..
42
12. Расшифровка значений, фигурирующих в ответах Банка на запросы ТСП
................................
....
42
13. Расшифровка кодов ответа (RESULT_/ODE)
................................
................................
......................
44
14. Системные ошибки
................................
................................
................................
..............................
47
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
4
|
Страница
ВвеФение
Платежная платформа
RSB_ECOMM
предназначена для интеграции торгово
-
сервисных
предприятий (далее по тексту
–
ТСП) с системой Банка
Русский Стандарт (далее
–
Банк)
для обработки транзакций, проводимых на интернет
-
сайте
ТСП
в рамках договора
Интернет
-
э
квайринга.
Документация предназначена для технических специалистов.
В документации описаны основные этапы подключения и настройки
системы.
1.
ОбщТя функционТльнТя схемТ
1.
Клиент выбирает продукт
на сайте
Вашей организации (ТСП)
и готов заплатить за
покупку. При нажатии кнопки/ссылки «/heckout»/«Оплатить», контроль передается ТСП.
2.
ТСП посредством запроса регистрирует транзакцию в системе
Банка
RSB_ECOMM
,
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
5
|
Страница
запрос направляется по
зашифрованному каналу на а
дрес
(
Merchant Handler URL
)
,
получая в ответе идентификатор транзакции (
transaction_id
).
3.
ТСП с указанным идентификатором транзакции (
transaction_id
), переадресует
К
лиента
на платежную страницу
Банка
RSB_ECOMM
для ввода карточных данных (
Client Handler
URL
).
4.
После ввода карточных данных, в зависимости от наличия поддержки 3D Secure,
выполняются следующие запросы
(Merchant Pl
u
g
-
in Interface
–
Directory Server
–
Access
Control Server)
:
4.1.
3
D
Secure
.
Процесс
верификации Клиента
:
Производится запрос на проведение соответствующей аутентификации.
Банк
перенаправляет
Клиента
на страницу
банка
-
э
митента
(
ACS
)
для дополнительной 3D
Secure аутентификации посредством
ввода
уникального кода проверки
(СМС или
список кодов, выданный эмитентом
)
.
В случае е
сли подтверждение
кода
прошло успешно,
банк
-
э
митент
на
правляет
ответ о возможности
проведения
данной операции
в Банк.
В случае е
сли
карта Клиента не участвует в 3
D
Secure
, перенаправление на
страницу банка
-
эмитента не производится.
4.2.
Процесс
авторизации платежа
:
Банк направляет запрос на авторизацию в Платежную Систему (
Payment
System
).
Платежная Система перенаправляет запрос в банк
-
эмитент.
Банк
-
э
митент
производит авторизацию
денежны
х
средств и отправляет
ответ
в
соответствующую
Платежную Систему
об успешн
ой авторизации
.
Платежная Система
перенаправляет
ответ
об
успешности
платежа
в Банк
.
5.
Клиент
будет
переадрес
ован
на
страницу возврата
ТСП
–
_URL
(прописывается
на стороне Банка по запросу ТСП
)
при указан
ном
идентификаторе транзакции (
trans ID).
Внимание:
Интернет
-
магазин может реализовать
платежную страницу для ввода карточных данных на своей стороне
.
В
этом
случае организации необходимо предоставить
в Банк
документы
подтверждающие
соответстви
е
PCI
DSS
.
В приложении к инструкции вы можете найти команды и примеры
для
реализации данной
модели.
Тестовая среда Банка для направления запросов
:
Merchant
Handler
URL
(тестовый)
–
используется для получения
trans
action
_
id
https
://
testsecurepay
.
rsb
.
ru
:9443/
ecomm
2/
MerchantHandler
Client
Handler
URL
(тестовый)
–
используется для перенаправления Клиента на
платежную страницу, для ввода
реквизитов карты
https
://
testsecurepay
.
rsb
.
ru
/
ecomm
2/
ClientHandler
?
trans
_
id
=
transaction
_
id
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
6
|
Страница
Внимание:
Время проведения операции ограничено, Клиенту отводится 10 минут на ввод реквизитов карты на
платежной странице. Иными словами с момента
формирования идентификатора транзакции (trans LD) до
момента переадресации Клиента обратно на сайт ТСП (RETURN_URL) должно пройти не более 10 минут. Не
уложившись в указанный период времени, операции будут отклонены системой со статусом TLaEOUT
(время
,
отв
еденное на проведение транзакции
,
истекло).
Примечание:
1.
ТСП необходимо регулярно (раз в день) отправлять
в Банк
запрос на завершение бизнес
-
дня
(подробнее описано в пункте 3.1.5).
2.
По умолчанию на стороне Банка будет установлен стандартный шаблон
платежной страницы.
Дизайн платежной страницы может быть изменен. Для этого ТСП необходимо направить
соответствующий запрос в Банк, ответным письмом будут предоставлены требования на
разработку платежной страницы и стандартный шаблон, который может быть и
спользован в
качестве примера.
Доступна возможность использования платежной страницы на различных языках.
Для использования языка отличного от русского, ТСП необходимо создать соответствующий
шаблон платежной страницы (согласно требованиям) и направить на
установку в Банк.
3.
ТСП может просматривать, и управлять проведенными транзакциями посредством личного кабинета
Банка (Ecomm tortal), используя
любой браузер
актуальной версии.
Ресурс доступен по ссылке:
https://securepay.rsb.ru:8443/ecomm_portal/
.
Дос
туп в личный кабинет Банка предоставляется по з
апросу ТСП на адрес
[email protected]
Инструкция пользователя доступна по ссылке:
https://testsecurepay.rsb.ru/email/ECOMM_Portal_RSB.pdf
–.
НТстрои кТ
сервисТ
ТСП
необходимо
подготовить информацию согласно нижеописанному перечню,
затем
консолидировано направить в Банк посредств
о
м электронный почты на адрес
–
[email protected]
:
1.
Запрос на сертификат, сгенерированный согласно
инструкции
-
ssl_rsb:
http://acquiring.ru/upload/mail/ssl_rsb.7z
Сертификат используется для создания защищенного соединения по протоколу SSL между web
-
сервер
ом
сайта и сервером Банка при обращении, обеспечивает защиту передаваемой информации. За счет SSL
сертификата ТСП идентифицируется на стороне Банка.
2. Информацию относительно страницы возврата (RETURN_URL), для переадресации Клиента обратно на
страницу
ТСП (тестовый и боевой RETURN_URL могут отличаться).
Для переадресации используется метод tOST.
3. Lt адрес сервера ТСП, с которого будут направляться запросы в Банк (тестовый и боевой Lt адрес могут
отличаться
, возможно прописать несколько
IP
адресов
)
.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
7
|
Страница
При обращении в Банк, в
теме письма обязательно долж
н
ы
быть указан
ы
Merchant
ID
(идентификатор, присваиваемый ТСП после регистрации договора
И
нте
рнет
-
о
квайринга)
и
юридическое наименование ТСП
.
При смене/использовании дополнительного Lt адреса, необходимо
заблаговременно проинформировать Банк, направив актуальный Lt
адрес
с указанием среды: тестовая/продукционная
.
Со стороны Банка
будут организованы работы по смене/добавлению Lt адреса.
3.
ИнтегрТция решения
3.1.
ИнтегрТция
Для передачи запроса
со стороны
ТСП
в
Банк
со всеми необходимыми пара
метрами
применяется метод tOST. П
роцесс аутентификации проис
ходит за счет SSL сертификатов.
Полученный
со стороны
Банка сертификат
.pem
(срок действие сертификата Организации
ограничен), корневой сер
тификат
chain
-
ecomm
-
ca
-
root
-
ca
и секретный ключ
.key
должны
быть сохранены в отдельной папке
4
это даст возможность легко переустановить
сертификат в случае сбоя
/
окончания срока действия
.
Организация обязана контролировать актуальность срока действия
SSL
сертификата.
Процесс установки
TLS
соединения зависит
от программного обеспечения,
используемого
на стороне ТСП, в котором необходимо прописать (физические) пути до сертификатов.
SSL
сертификат используется исключительно при обращении к
Merchant
Handler
URL
.
Срок действия
SSL
сертификата
–
1 год с даты его выпуска
Осуществляется поддержка следующих версий
TLS
: 1.0., 1.1., 1.2.
Пример
:
Домашняя директория WEB
-
сервера:
/home/www/
или
/www/
Директория с SSL сертификатами
вне
структуры WEB
-
сервера:
/home/ssl/
и
ли
/ssl/
Д
иректория с SSL сертификатами
не должна
находит
ь
ся внутри
структуры каталогов WEB
-
сервера
. В данном случае
приватный ключ
будет
доступен для скачивания
, пример
:
/ho
me/www/ssl/
или
/www/ssl/
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
8
|
Страница
При необходимости, Банк может предоставить пример при использовании
библиотеки
/URL на tHt.
3.1.1.
ПоФготовкТ к реТлизТции
Изначально
необходимо определить
модель
работы
Вашего интернет
-
магазина.
Б
анк может предложить следующие
схемы интеграции:
Покупка (SaS)
Единая транзакция, которая позволяет перевести деньги со счета Держателя
на Ваш счет. ото означает, что Авторизация платежа и ее Выполнение
осуществляются в рамках одной транзакции.
Авторизация/Выполнение
(DMS)
Требует двух транзакций
4
Авторизации, за которой следует Выполнение.
ото позволяет разнести во времени процесс авторизации операции на счете
Держателя карты (и при этом осуществить блокировку необходимых средств
на его счете) с последующим выполнением авт
оризации (например,
выполнение по факту проверки наличия товара на складе, по факту отгрузки
товара, после проведения дополнительных проверок и т.д.). Следует
отметить, что Выполнение является основанием для перечисления денег со
счета Клиента (финансовая
операция), в то время как Авторизация
подразумевает лишь блокировку средств на счете Клиента.
Рекуррентные операции
Операция, отражающая периодическое предоставление услуг Держателю
карты͖ операция, выполняемая ТСП, которая предоставляет услуги на
постоянной (регулярной) основе Держателям, на основании соглашения͖
соглашение дает право Торговой точке периодически осуществлять
финансовые операции, отражающиеся на банковском счете Держателя.
Выставление счета
Ссылка для перехода на платежную
страниц
у
Банка для проведения
платежа может быть направлена на электронную почту, либо мобильный
телефон Держателя карты.
Срок действия направленной ссылки
–
7
календарных дней (по истечении данного срока произвести платеж будет
невозможно). Соответствующа
я к
оманда в Банк направляется посредством
личного кабинета (
Ecomm
porta
l
), доступ
в который предоставляется Банком
по запросу ТСП по адресу
ecom
@
rsb
.
ru
. Существует возможность прописать
страницу возврата Клиентов (
RETURN
URL
) организации, либо использовать
стандартную страницу возврата на стороне Банка.
Описание необходимых команд для каждой платежной модели представлены ниже. Все
они выполняются на
Merchant
Handler
URL
.
Требования
для перенаправления
К
лиента
на
платежную страницу
Client
Handler
URL
описаны в
пункте
№ 4.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
9
|
Страница
3.1.2.
Регистрация
SMS
транзакции
При выборе Платежной модели SaS
списание с карты
К
лиента происходит
единовременно,
выполнение
не требует
ся
. ото означает, что авториз
ация платежа и ее
выполнение
осуществляются в рамках одной транзакции.
Описание переменных:
Переменная
Тип
поля
Количество
символов
(max)
Описание
-
v
M
1
И
дентифицирует запрос на регистрацию
транзакции.
amount
М
12
С
умма транзакции в целых единицах,
последние два символа
–
копейки.
currency
M
3
К
од валюты транзакции (LSO 4217). На
территории РФ
-
643 код.
client_ip_addr
М
15
Lt адрес клиента
description
О
125 (латиницей)
О
писание платежа (кодировка
–
UTF 8).
Каждая русская (кириллица) буква
-
это 2
(два) символа. Нельзя
использовать
двойные кавычки: ". Не рекомендуется
использовать символы: &, %, №, @, $, *,(для
этих символов используются значения
согласно таблице кодировки URL).
mrch_transaction_id
О
225 (латиницей)
О
писание платежа (кодировка
–
UTF 8).
Каждая
русская (кириллица) буква, это два
символа. Используется для передачи доп.
сведений о заказе.
language
О
32 (латиницей, в
нижнем регистре)
И
дентификатор языка платежной страницы.
Обязателен, в случае необходимости
использования платежной страницы
Банка
на разных языках.
server_version
O
4
И
спользуется для возврата дополнительных
деталей, должно быть указано „2.0”. Если
параметр не указан, дополнительные детали
не возвращаются.
Сокращения
:
М
(
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command=v&amount=amount-5am;-8ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&client_ip_addr=ipi5p;-900;&description=desc淤s-5c;-500;&mrch
_transaction_id=mrch_tx_idm-2;r8c;-5h_;tx-;_i7; -90;&language=language-5l5; -9n;g4u-;g4;-90;&msg_type=SMS&server_version=2.0-52.;-70;
Результат
:
TRANSACTION_ID:
trans_id
trans_id
-
идентификатор транзакции (28 знаков в кодировке base64).
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
10
|
Страница
В случае ошибки возвращаемая строка символов начинается с ‘error:‘.
3.1.2.1.
ЗТпрос стТтусТ.
П
осле перенаправления клиента на результирующую страницу RESULT_URL выполняется
запрос
статуса транзакции
.
В случае е
сли, по независящим от Банка причинам, перенаправление клиента на
RESULT_URL не происходит, запрос статуса транзакции имеет смысл выполнять
исключительно
по
истечении
10 минут с момента регистрации транзакции (trans_id
)
(жизненный цикл транзакции равен 10 минутам).
Важно:
В дальнейшем, запросы в рамках одной транзакции выполняются, когда с транзакцией производятся
новые действия. Последующие запросы
статуса будут считаться
Системой
Банка
, избыточны
ми
и могут
представлять потенциальную угрозу для функционирования ресурсов нашего Банка.
Описание переменных
:
Переменная
Тип поля
Количество
символов
(max)
Описание
-
c
M
1
И
дентифицирует запрос результата
транзакции
trans_id
М
28
И
дентификатор
транзакции
client_ip_addr
M
15
Lt адрес клиента
server_version
O
4
И
спользуется для возврата дополнительных
деталей, должно быть указано „2.0”.
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&client_ip_addr=ipi-6;p-90;
&server_version=2.0b-9;.0-8;
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_PS: result_psr-3;s-3;u-9l;t_-;ps-;
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
3DSECURE: 3dsecc-9; s-3;ì-3;ure0;ure
RRN: rrr-3;r-3n;n
APPROVAL_CODE: app_cod-4ap;p-9;_-9c;-5od;一e
CARD_NUMBER: papa-;n00;n
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
11
|
Страница
MR
CH_TRANSACTION_ID: mrch_tx_im-2;r-3;-5h;_4tx;-4_i;紀d
Пример
:
Регистрация
транзакции
:
Запрос в Банк
, п
араметры
Http
post
:
command=v&amount=12300
¤cy=643&client_ip_addr=10.0.20.30&description=
Заказ
N123
&
mrch_transaction_id=
SMS transaction
&language=ru&msg_type=SMS&
server_version=2.0
Результат
:
TRANSACTION_ID: rEsfhyIk8s9ypxkcS9fj/3C8FqA=
Перенаправление
К
лиента на адрес платежного шлюза для проведения операции
https
://
testsecurepay
.
rsb
.
ru
/
ecomm
2/
ClientHandler
?
trans
_
id
=
rEsfhyIk
8
s
9
ypxkcS
9
fj
/3
C
8
FqA
=
Подтверждение
/определение статуса
платежа
(на странице
RETURN
_
URL
)
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=
rEsfhyIk8s9ypxkcS9fj/3C8FqA=
&client_ip_addr=
10.0.20.30
&server_version=2.0
Результат
:
RESULT: OK
RESULT_PS: FINISHED
RESULT_CODE: 000
3DSECURE: AUTHENTICATED
RRN: 331711380059
APPROVAL_CODE:
327593
CARD_NUMBER: 5***********2372
MRCH_TRANSACTION_ID:
SMS
TRANSACTION
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений͖ 8. Расшифровка кодов ответа
3.1.3.
РегистрТция DM3 трТнзТкции (ТвторизТция)
Платежная модель DaS
-
списание с карты
К
лиента происходит в два этапа:
1. Авторизации
–
денежные
средства на карте
Клиента
блокиру
ю
тся.
2. Выполнение/Расчет
транзакции
(финансовая операция).
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
12
|
Страница
Например, выполнение/расчет по факту проверки наличия товара на складе, по факту
отгрузки товара, после проведения дополнительных проверок
и
т.д.
Операция
Выполнение/
Р
асчет является основанием для списания денежных средств со счета
К
лиента,
в то время как Авторизация подразумевает лишь блокировку средств на счете
К
лиента.
Описание пе
ременных:
Переменная
Тип
поля
Количество
символов
(max)
Описание
-
Т
M
1
И
дентифицирует запрос на регистрацию
транзакции.
client_ip_addr
M
15
Lt адрес клиента
server_version
O
4
И
спользуется для возврата дополнительных
деталей, должно быть указано
„2.0”.
amount
М
12
С
умма транзакции в целых единицах,
последние два символа копейки.
currency
М
3
К
од валюты транзакции (LSO 4217). На
территории РФ
-
643 код.
description
О
125 (латиницей)
О
писание платежа (кодировка
–
UTF 8).
Каждая русская
(кириллица) буква
-
это 2
(два) символа. Нельзя использовать
двойные кавычки: ". Не рекомендуется
использовать символы: &, %, №, @, $, *,(для
этих символов используются значения
согласно таблице кодировки URL).
mrch_transaction_id
О
225 (латинице)
О
писание платеж (кодировка
–
UTF 8).
Каждая русская (кириллица) буква, это два
символа. Используется для передачи доп.
сведений о заказе.
language
О
32 (латиницей, в
нижнем регистре)
И
дентификатор языка платежной страницы.
Обязателен, в случае необходим
ости
использования платежной страницы Банка
на разных языках.
server_version
O
4
Используется для возврата дополнительных
деталей, должно быть указано „2.0”. Если
параметр не указан, дополнительные
детали не возвращаются.
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
command=a&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&client_ip_addr=ipi5p;-900;&description=desc淤s-5c;-500;&mrch
_transaction_id=mrch_tx_idm-2;r8c;-5h_;tx-;_i7; -90;&language=language-5l5; -9n;g4u-;g4;-90;&msg_type=DMS&server_version=2.0
Результат
:
TRANSACTION_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
13
|
Страница
trans_id
-
идентификатор транзакции (28 знаков в кодировке base64).
В случае ошибки возвращаемая строка символов начинается с ‘error:‘.
По результатам перенаправления
К
лиента на указанный
RETURN_URL, следует
подтвердить транзакцию, что также позволит определить успешность операции.
Описание переменных
:
Переменная
Тип поля
Количество
символов
(max)
Описание
-
c
M
1
И
дентифицирует запрос результата
транзакции
trans_id
М
28
И
дентификатор
транзакции
client_ip_addr
M
15
Lt адрес клиента
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опционально
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&client_ip_addr=ipi-6;p-90;
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_PS:
result_ps
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
3DSECURE: 3dsecc-9; s-3;ì-3;ure0;ure
RRN: rrr-3;r-3n;n
APPROVAL_CODE: app_cod-4ap;p-9;_-9c;-5od;一e
CARD_NUMBER: papa-;n00;n
MRCH_TRANSACTION_ID: mrch_tx_im-2;r-3;-5h;_4tx;-4_i;紀d
Пример
:
Регистрация DMS транзакции (авторизация)
Запрос в Банк
, п
араметры
Http
post
:
command=a&
amount=12300&
currency=643&
client_ip_addr=
10.0.20.30
&
description=
Заказ
N123
&
mrch_transaction_id=
DMS authorization
&language=ru&msg_type=
D
MS&server_version=2.0
Результат
:
TRANSACTION_ID: rnSC7dvU73Wt9WTxE6TDXOeal/o=
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
14
|
Страница
Перенаправление
К
лиента на адрес
платежного шлюза для проведения операции
:
https
://
testsecurepay
.
rsb
.
ru
/
ecomm
2/
ClientHandler
?
trans
_
id
=
rnSC
7
dvU
73
Wt
9
WTxE
6
TDXOeal
/
o
=
Подтверждение
/определение статуса
платежа
(на странице
RETURN
_
URL
)
:
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=
rnSC7dvU73Wt9WTxE6TDXOeal/o=
&client_ip_addr=
10.0.20.30
&server_version=
2.0
Результат
:
RESULT: OK
RESULT_PS: ACTIVE
RESULT_CODE: 000
3DSECURE:
AUTHENTICATED
RRN: 331813509357
APPROVAL_CODE: 864745
CARD_NUMBER: 5***********2372
MRCH_TRANSACTION_ID:
DMS
AUTIRI
Z
ATION
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений͖ 8. Расшифровка кодов ответа
3.1.4.
Выполнение/Расчет
DaS транзакции
Описание переменных
:
Переменная
Тип поля
Количество
символов
(max)
Описание
-
t
M
1
Идентифицирует запрос на регистрацию
транзакции.
trans_id
М
28
Идентифицирует авторизацию финансовой
транзакции.
amount
М
12
С
умма транзакции в целых
единицах,
последние два символа копейки.
currency
М
3
Код валюты транзакции (LSO 4217). На
территории РФ
-
643 код.
client_ip_addr
M
15
Lt адрес клиента
description
О
125 (латиницей)
Описание платежа (кодировка
–
UTF 8).
Каждая русская
(кириллица) буква
-
это 2 (два)
символа. Нельзя использовать двойные
кавычки: ". Не рекомендуется использовать
символы: &, %, №, @, $, *,(для этих символов
используются значения согласно таблице
кодировки URL).
language
О
32 (латиницей, в нижнем
регистре)
Идентификатор языка платежной страницы
Банка
.
Обязателен, в случае необходимости
использования платежной страницы
Банка
на
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
15
|
Страница
разных языках.
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command
=
t
&
trans_id= trans_id tr;-14a;-9ns;-3_i;} -;耀&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;nn4;-29;y180;&client_ip_addr=i
p&description=descm-9;s-3;-50;&language=language-5l5; -9n;g4u-;g4;-90;&msg_type=DMS
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
RRN: rrr-3;r-3n;n
APPROVAL_CODE: app_cod-4ap;p-9;_-9c;-5od;一e
CARD
_
NUMBER
pan
trans_id
-
идентификатор транзакции (28 знаков в кодировке base64).
В случае ошибки возвращаемая строка символов начинается с ‘error:‘.
Пример
:
Выполнение
/
расчет
DMS
транзакции
Запрос в Банк
, п
араметры
Http
post
:
command=t&trans_id=
rnSC7dvU73Wt9WTxE6TDXOeal/o
&amount=12300¤cy=643
&
client_ip_add
r=10.0.20.30&description=
Заказ
N123
&language=ru&msg_type=
D
MS
Результат
:
RESULT: OK
RESULT_CODE: 000
RRN: 331813509357
APPROVAL_CODE: 864745
CARD_NUMBER: 5***********2372
Для возврата
полных деталей по платежу, необходимо инициировать запрос статуса
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=
rnSC7dvU73Wt9WTxE6TDXOeal/o
&client_ip_addr=
10.0.20.30
&server_version=2
.0
Результат
:
RESULT: OK
RESULT_PS: FINISHED
RESULT_CODE: 000
3DSECURE: AUTHENTICATED
RRN: 331813509357
APPROVAL_CODE: 864745
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
16
|
Страница
CARD_NUMBER: 5***********2372
MRCH_TRANSACTION_ID:
DMS
TRANSACTION
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений͖ 8. Расшифровка кодов ответа
3.1.5.
ОтменТ/
В
озврТт
трТнзТкции
Отмена/
В
озврат
транзакции
инициируют
ся при необходимости возмещения денежных
средств
К
лиенту.
Рекомендации по применению команд в случае возникновения необх
одимости возврата
денежных средств К
лиенту:
Тип операции
Условия
SMS
До закрытия бизнес дня
После закрытия бизнес дня
-
r (отмена / reverse)
полная
-
k (возврат / refund)
полный / частичный
DaS (авторизация)
-
r (отмена / reverse)
только на всю сумму
DaS (расчет)
-
k (возврат/refund)
полный/ частичный
Примечание:
при операции «отмена»
-
денежные средства Клиенту будут доступны в течение дня, при операции
«возврат»
-
от трех рабочих дней (точный срок регулируется на стороне банка
-
эмитента).
В случае если счет
К
лиента
открыт
в
иностранной
валюте, возмещение по
операции
отмены/возврата будет пересчитано по курсу валют на день со
вершения оригинальной
операции.
Описание переменных
при
проведении операции «О
тмен
а»
Переменная
Тип поля
Количество
символов
(max)
Описание
-
r
M
1
И
дентифицирует запрос отмены
транзакции.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
17
|
Страница
trans_id
М
28
И
дентификатор транзакции.
amount
M/O
12
С
умма транзакции в целых единицах. Если
необходимо возместить сумму меньше суммы
оригинальной операции, параметр
обязателен.
suspected_fraud
O
3
(латиницей)
П
араметр
–
флаг, указывающий, что отмена
делается из
-
за подозрения в мошенничестве.
В таких случаях значение этого параметра
должно быть установлено как "yes". Если этот
параметр используется, отмена только всей
суммы.
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command=r&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&amount=amoujm-; ou;nt0;nt
command=r&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&amount=amoujm-; ou;nt0;nt&suspected_fraud=yes
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
Пример
:
Запрос в Банк
, п
араметры
Http
post
:
command=r&trans_id=HbetBxfr87TvObsevaRhAIdWWqM
=
&server_version=2.0
Результат
:
RESULT: OK
RESULT_CODE: 400
Операцию «Отмена»
ТСП может
про
вести
в личном кабинете Бан
к
а
(
Ecomm
Portal
)
, доступ в
который
предоставляется
по запросу ТСП на адрес
[email protected]
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений и 8. Расшифровка кодов ответа
Доступно производить не более одной операции
«отмены» по транзакции.
Операция «отмены» для SaS транзакции и DaS расчета будет недоступна,
после закрытия бизнес дня.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
18
|
Страница
Описание переменных при проведении операции «Возврат»
Переменная
Тип поля
Количество
символов
(max)
Описание
-
k
M
1
И
дентифицирует запрос возврата суммы
транзакции
trans_id
М
28
И
дентификатор транзакции.
amount
M/O
12
С
умма транзакции в целых единицах. Если
необходимо возместить сумму меньше суммы
оригинальной операции, параметр
обязателен. Если параметр не
указан,
возвращается вся сумма.
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Важно:
Возврат
–
самостоятельная операция, по своей сущности обратная прямой (оригинальной) операции,
имеет свой trans LD.
Операция возврата
проводится только в том случае, когда статус по операции FLNLSHED . Общая сумма,
подлежащая возврату Клиенту
,
не может превышать сумму оригинальной транзакции.
Запрос в Банк
, п
араметры
Http
post
:
command=k&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&amount=amoujm-; ou;nt0;nt
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
REFUND_TRANS_ID: refund_trans_idr-3;ï-8;un4d;_-7t;r-2a;n4s-;_-9;i5d-;退
Пример
:
Запрос в Банк
, п
араметры
Http
post
:
command=k&trans_id=M1pUcZowyEKaM5wrrlzyPbqDooU
=
&server_version=2.0
Результат
:
RESULT: OK
RESULT_CODE: 000
REFUND_TRANS_ID:
6ru/d9kr9u1vtqATyNdlP8KX4Kc=
Статус прямой (оригинальной) операции после возврата суммы не
меняется.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
19
|
Страница
Операцию «Возврат» ТСП может провести в личном кабинете Банка (Ecomm tortal),
доступ в который предоставляется по запросу ТСП на адрес
[email protected]
3.1.6.
ЗТкрытие бизнес
-
Фня
Процедуру закрытия бизнес
-
дня необ
ходимо инициировать раз в сутки.
По результатам проведенной процедуры
Банк о
брабатывает полученные операции, затем
возмещает ТСП денежные средства
посредством перечисления на расчетный счет ТСП в
рамках Договора.
Описание переменных
:
Переменная
Тип поля
Количество
символов
(max)
Описание
-
b
M
1
И
дентифицирует запрос завершения бизнес
-
дня
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command
=
b
Результат
:
RESULT
:
result
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
FLD_075: fld_075o-1;l5d;_-70;݅-;退
FLD_076: fld_076o-1;l5d;_-70;݆-;退
FLD_087: fld_087o-1;l5d;_-70;ࡇ-;退
FLD_088: fld_088o-1;l5d;_-70;ࡈ-;退
Пример
:
Запрос в Банк
, п
араметры
Http
post
:
command=b&
server_version=2.0
Результат
:
RESULT: OK
RESULT_CODE: 500
FLD_075: 12
FLD
_076: 31
FLD
_087: 3201
FLD
_088: 10099
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
20
|
Страница
Операцию «Закрытие бизнес дня» ТСП может однократно провести / автоматизировать в
личном кабинете Банка (Ecomm tortal), доступ в который
предоставляется по запросу ТСП
на адрес
[email protected]
Инструкция пользователя доступна по ссылке:
https://testsecurepay.rsb.ru/email/ECOMM_Portal_RSB.
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений и 8. Расшифровка кодов ответа
Данные по операции «возврат» не учитываются при ответе
3.2.
Регулярные (рекуррентные) плТтежи
Регулярные платежи
–
это платежи,
которые не
требу
ют повторного ввода реквизитов
карты Клиентом.
Клиент производит оплату
1 раз
, соглашается с условиями регулярного списания,
последующ
е
е списание
происходит без участия Клиента.
Регулярный платеж
рег
истрируется при первом платеже, при
этом в базе да
нных
Банка регистрируется
шаблон регулярного платежа. Шаблону присваивается номер, который знает ТСП. По
запросу номера шаблона иницииру
е
тся операция регулярного платежа.
3.2.1.
РегистрТция регулярного (рекуррентного) плТтежТ
Описание переменных
:
Переменная
Тип
поля
Количество
символов
(max)
Описание
-
z
M
1
Запрос на регистрацию регулярного
(рекуррентного) платежа
amount
M
12
Сумма транзакции в целых единицах,
последние два символа
–
копейки
currency
M
3
Код валюты транзакции (LSO 4217)
–
На
территории РФ
-
643 код
client_ip_addr
M
15
Lt адрес клиента
description
O
125 (латиницей)
Описание платежа, (кодировка
–
UTF 8)
Каждая русская (кириллица) буква
-
это 2
(два) символа. Нельзя использовать
двойные кавычки: ". Не рекомендуется
использовать
символы: &, %, №, @, $,
*,(для этих символов используются
значения согласно таблице кодировки
URL).
mrch_transaction_id
O
225 (латиницей)
Описание платежа (кодировка
–
UTF 8)
Каждая русская (кириллица) буква, это
два символа. Используется для передачи
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
21
|
Страница
доп. сведений о заказе.
language
O
32 (латиницей, в
нижнем регистре)
Идентификатор языка платежной
страницы.
Обязателен, в случае необходимости
использования платежной страницы
Банка на разных языках
server_version
O
4
Если необходим возврат
дополнительных
деталей, должно быть указано „2.0”. Если
параметр не указан или равен „1.0”,
дополнительные детали не
возвращаются.
biller_client_id
M
49
В
ыбранный ТСП идентификатор
регулярного платежа. Окончательное
значение идентификатора регулярных
платежей формируется с помощью
aerchant LD ТСП и значения указанного
rec_pmnt_id идентификатора.
expiry
M
4
П
редельный срок действия регулярного
платежа в
формате ММГГ
perspayee_gen=1
M
1
И
спользуется для генерации нового
шаблона регулярного (рекуррентного)
платежа
ask_save_card_data=true
O
4
Используется для включения
функционала
«Сохранение
карточных
данных
»
(ввод cvv2/cvc2 + 3DS при
повторном вызове
регулярного платежа)
.
Функционал «Сохранение карточных данных»
(ввод cvv2/cvc2 + 3DS при повторном вызове
регулярного платежа).
При регистрации регулярного (рекуррентного) платежа передается параметр
«ask_save_card_data=true
». На платежной странице появится
checkbox
.
Если держатель карты решает не хранить карточные данные тогда создаётся простая транзакция
и производится оплата.
Если держатель карты выбирает хранить карточные данные, тогда создается регулярный платеж с
данными этой карты. В следующий раз платеж держателя карты должен использовать
инициализацию регулярных платежей
,
команду
-
f
, который возвращает
trans
_
id
для перехода
держателем карты на Платежную страницу. На Платежной странице содержаться маскированные
к
арточные данные и пустое поле для ввода cvv2/cvc2.
Для работы
c
функционалом
«Сохранение карточных данных»
необходимо направить запрос на
эл. адрес почты
ecom
@
rsb
.
ru
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command=z&amount=amount-5am;-8ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&clien
t_ip_addr=ipi5p;-900;&description=des
c
&mrch
_transaction_id=mrch_tx_idm-2;r8c;-5h_;tx-;_i7; -90;
&language=language-5l5; -9n;g4u-;g4;-90;&msg_type=SMS&biller_client_i
d=recc_pmnt_ir-1;-;<-5;_p4m;-21n;t_4i;崀d
&
perspayee_expi
ry=expiry
&perspayee_gen=1
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
22
|
Страница
Результат
:
TRANSACTION_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
trans_id
-
идентификатор транзакции (28 знаков в кодировке base64).
В случае ошибки возвращаемая строка символов начинается с ‘error:‘.
По результатам перенаправления
К
лиента на указанный RETURN_URL, следует
подтвердить транзакцию, что также позволит определить успешность
проведенной
операции.
Описание переменных:
Переменная
Тип поля
Количество
символов
(max)
Описание
-
c
M
1
И
дентифицирует запрос результата
транзакции
trans_id
М
28
И
дентификатор транзакции
client_ip_addr
М
15
Lt адрес клиента
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&client_ip_addr=ipi-6;p-90;
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_PS: result_psr-3;s-3;u-9l;t_-;ps-;
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
3DSECURE: 3dsecc-9; s-3;ì-3;ure0;ure
RRN: rrr-3;r-3n;n
APPROVAL_CODE: app_cod-4ap;p-9;_-9c;-5od;一e
CARD_NUMBER: papa-;n00;n
RECC_PMNT_ID: rcc_pmnt_ir-3;-5c;-5_p;m-9;nt_4;i-6d;d
RECC_PMNT_EXPIRY: rcc_pmnt_exr-3;-5c;-5_p;m-;!nt;_4ex;-300;
MRCH_TRANSACTION_ID: mrch_tx_im-2;r-3;-5h;_4tx;-4_i;紀d
Редактирование шаблона регулярного платежа (например, в случае изменения
платежных реквизитов Клиентом)
:
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
23
|
Страница
б
же зарегистрированный
ранее шаблон
(идентификатор
RECC_PMNT_ID)
,
возможно
с
указанием дополнительного
параметра
perspayee_overwrite=1
(используется при
command=z
).
С
уществующи
й персональный
платеж (шаблон регулярного платежа) буд
е
т переписан с
новыми реквизитами карты Клиента
. При других значениях буде
т создан только новый
платеж (
если такой платеж уже существ
ует, не будет никаких
действий)
.
Пример
:
Регистрация
шаблона
регулярного
платежа
Запрос в Банк
, п
араметры
Http
post
:
command=z&amount=12300¤cy=643&client_ip_addr=10.0.20.30&description=
Заказ
N123
&mrch_transaction_id=recurrent&language=ru&msg_type=SMS&
biller_client_id=recurrent321&perspaye
e_expiry=0516
&perspayee_gen=1
&perspayee_overwrite=1
&server_version=2.0
Результат
:
TRANSACTION
_
ID
:
Ipnu
4
iHy
4
UpGAB
8
aqc
9
Mwti
58
dE
=
Перенаправление
К
лиента на адрес платежного шлюза для проведения операции
https
://
testsecurepay
.
rsb
.
ru
/
ecomm
2/
ClientHandler
?
trans
_
id
=
Ipnu
4
iHy
4
UpGAB
8
aqc
9
Mwti
58
dE
=
Подтверждение
/определение статуса
платежа
(на странице
RETURN
_
URL
)
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=
Ipnu
4
iHy
4
UpGAB
8
aqc
9
Mwti
58
dE
=
&client_ip_addr=10.0.20.30&server_version=2.
0
Результат
:
RESULT: OK
RESULT_PS: FINISHED
RESULT_CODE: 000
3DSECURE:
AUTHENTICATED
RRN: 332518927710
APPROVAL_CODE:
418900
CARD_NUMBER: 5***********3361
RECC_PMNT_ID:
recurrent
321
RECC_PMNT_EXPIRY: 0516
MRCH_TRANSACTION_ID: RECURRENT
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений и 8. Расшифровка кодов ответа
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
24
|
Страница
3.2.2.
Повторное списТние
регулярного плТтежТ
Важно:
При проведении операции повторного списания регулярно платежа в случае получения отказов с кодами:
100 Decline (general, no comments)
116 Decline, not sufficient funds
121 Decline, exceeds withdrawal amount limit
123 Decline,
exceeds withdrawal frequency limit
Повторное проведение операции рекомендуется проводить не ранее, чем через 16 календарных дней
с
даты последнего отказа.
В случае получения отказов с кодами:
111 Decline, invalid card number
101 Decline, expired card
119
Decline, transaction not permitted to cardholder
2xx
Повторное проведение
списания
недопустимо
.
Описание переменных
:
Переменная
Тип
поля
Количество
символов
(max)
Описание
-
e
M
1
З
апрос на повторное списание
зарегистрированного ранее регулярного
(рекуррентного) платежа.
amount
M
12
С
умма транзакции в целых единицах,
последние два символа
–
копейки.
currency
M
3
К
од валюты транзакции (LSO 4217). На
территории РФ
-
643 код.
client_ip_addr
M
15
Lt адрес клиента.
description
O
125
(латиницей)
О
писание платежа (кодировка
–
UTF 8).
Каждая русская (кириллица) буква
-
это 2
(два) символа. Нельзя использовать двойные
кавычки: ". Не рекомендуется использовать
символы: &, %, №, @, $, *,(для этих
символов используются значения согласно
табл
ице кодировки URL).
mrch_transaction_id
О
225 (латиницей)
О
писание платеж (кодировка
–
UTF 8).
Каждая русская (кириллица) буква, это два
символа. Используется для передачи доп.
сведений о заказе.
language
M
32
(латиницей, в нижнем
регистре)
И
дентификатор языка платежной страницы.
Обязателен, в случае необходимости
использования платежной страницы на
разных языках.
biller_client_id
М
49
В
ыбранный ТСП идентификатор регулярного
платежа.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
25
|
Страница
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
Запрос в Банк
, п
араметры
Http
post
:
command=e&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&client_ip_addr=ipi5p;-900;&description=desc淤s-5c;-500;&mrch
_transaction_id=mrch_tx_idm-2;r8c;-5h_;tx-;_i7; -90;&language=language-5l5; -9n;g4u-;g4;-90;&
biller_client_id=recc_pmnt_ir-3;ì-3;-5_;p4m-;!nt;_4i-;洀d
Результат
:
TRANSACTION_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE:result_coder-3;s-3;ul-4;t_c-;od;N-9;
RRN:rrnr-3;r-3n;-900;
APPROVAL_CODE:appr_cod-4ap;pr_;-12c;-5od;一e
Пример
:
Повторное списание регулярного платежа
Запрос в Банк
№ 1, п
араметры
Http
post
:
command=e&amount=12300¤cy=643&
client_ip_addr=10.0.20.30&
description=
Заказ
N123
&mrch_transaction_id=recurrent&language=ru
&biller_client_id=
recurrent
321&server_version=2.0
Результат
:
TRANSACTION_ID: XHsmi/w7RmoirHpyPDGENBzBsMY=
RESULT: OK
RESULT_CODE: 000
RRN: 332518927712
APPROVAL
_
CODE
: 598667
Подтверждение
/определение статуса
платежа
(на странице
RETURN
_
URL
)
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=
XHsmi/w7RmoirHpyPDGENBzBsMY=
&client_ip_addr=
10.0.20.30
&server_version
=2.0
Результат
:
RESULT: OK
RESULT_PS: FINISHED
RESULT_CODE: 000
3DSECURE: FAILED
RRN: 332518927712
APPROVAL_CODE: 598667
CARD_NUMBER: 5***********3361
Запрос
в
Банк
№ 2,
п
араметры
Http
post
:
command=e&amount=12300¤cy=643&client_ip_addr=10.0.20.30&description=
Заказ
N123&
mrch_transaction_id=recurrent&language=ru&biller_client_id=recurrent
321&server_version=2.0
Результат
:
TRANSACTION_ID: JZXQNHHJTyhgVk7f3ujIjCYTc5c=
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
26
|
Страница
RESULT: OK
RESULT_CODE: 000
RRN: 332518927729
APPROVAL_CODE: 505816
Подтверждение
/определение статуса
платежа
(на странице
RETURN
_
URL
)
Запрос в Банк
, п
араметры
Http
post
:
command=c&trans_id=
JZXQNHHJTyhgVk7f3ujIjCYTc5c=
&client_ip_addr=
10.0.20.30
&server_version=2.
0
Результат
:
RESULT: OK
RESULT_PS: FINISHED
RESULT_CODE: 000
3DSECURE: FAILED
RRN:
332518927729
APPROVAL_CODE: 505816
CARD
_
NUMBER
: 5***********3361
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений и 8. Расшифровка кодов ответа
Дополнительно обрТщТем ВТше внимТние нТ
Феи ствующие требовТния ПлТтежнои Системы
6)3A:
В соответствии с требованиями
Платежной Системы
VISA
на стороне Банка введен
о
ограничение
на проведение рекуррентных платежей в случае получения следующих отказов более 4 раз в
течение 16 календарных дней:
Result Code
:
100 Decline (general, no comments)
116 Decline, not sufficient funds
121 Decline, exceeds withdrawal amount limit
123
Decline, exceeds withdrawal frequency limit
Результатом п
оследующи
х
попыт
ок
оплаты буд
е
т
отказ с
кодом 103.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
27
|
Страница
Повторное проведение рекуррентного платежа становиться возможным по истечению 16
календарных дней с момента последней неуспешной попытки запроса
на проведение
рекуррентного платежа.
Аналогичное ограничение применяется при
проведение рекуррентных платежей в случае
получения следующих отказов:
Result Code
:
111 Decline, invalid card number
101 Decline, expired card
119 Decline, transaction not
permitted to cardholder
2xx
Результатом последующих попыток оплаты будет отказ с кодом 103
б
ез возможности повторного
проведения рекуррентного платежа в рамках данного
PAN
.
4.
ПереТФресТция
К
лиентТ
Переадресация
К
лиента
(на платежную страницу Банка для ввода соответствующих
реквизитов карты)
на указанный банком URL,
возможна
посредством метода
или
POST
запроса
.
Важно, чтобы во время переадресации передавалась переменная trans_id.
Данная
переменная
соде
ржит идентифик
атор подлежащей
оплате транзакции
(необходимо обратить внимание на то, что
параметр
trans_id может содержать знаки ‘+’,
‘=’ и ‘/’, которые перед отправлением идентификатора необходимо заменить на
кодировку URL (например, заменить ‘=’ на группу ‘%3D’)
)
:
+
/
!
“
#
%
&
‘
*
,
:
;
=
?
%2B
%2F
21%
22%
23%
25%
26%
27%
%2a
%2c
%3a
%3b
%3c
%3d
%3e
%3f
[
]
^
`
{
|
}
пробел
%5b
%5d
%5e
60%
%7b
%7c
%7d
20%
Внимание:
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
28
|
Страница
В случае, когда параметр trans_id преобразован некорректно, клиент будет получать ошибку:
5.
УвеФомление об успешном плТтеже
посреФств
о
м электроннои почты
Банк может предоставить Вашей Организации возможность
отправлять чек об успешном
платеже на электронн
ый
адрес Клиента
.
Отправляемый чек носит
информативный
характер и не является официальным документом.
олектронный чек будет доставлен Клиенту исключительно при условии получения статуса
«
Finished
».
Для активации сервиса, Вам необходимо направить соответствующий запрос в Банк по
адресу
ecom
@
rsb
.
ru
, по результатам сотрудник Банка сообщит Вам об активации сервиса.
ТСП на своей стороне
наст
раивает
функционал
путем добавления следующих
дополнительных деталей при инициализации платежа
(
SMS
/
DMS
)
:
ecomm_notify_
–
адрес электронной почты, на который будет направлен чек
о проведенном платеже. При необходимости чек может быть направлен н
а
несколько электронных адресов.
Н
аправляя соответствующие электронные
адреса, в качестве разделителя
,
используйте символ «,»
.
ecomm_notify_from (необязательно)
–
адрес электронной почты отправителя.
Необходимо использовать существующее доменное имя сервера, на котором расположен
почтовый ящик отправителя.
Когда
Клиент
получит чек по электронной почте, передаваемый электронный адрес будет
отображен
, как электронная почта отправителя.
Так
же существует альте
рнативный вариант
–
возможность
отправлять
ecomm
_
notify
_
from
=
noreply
@
rsb
.
ru
ecomm_notif
y_subject (опционально)
–
тема сообщения электронного письма͖
ecomm_notify_cc
(опционально)
–
электронный адрес, на который будет
направлена копия чека. При необходимости чек может быть направлен на
несколько электронных адресов,
направляя соответствующие электронные
адреса в качестве разделителя используйте символ «,».
Пример электронного чека
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
29
|
Страница
Шаблон электронного чека
возможно изменить, по запросу ТСП Банк
предоставит необходимые требования на создание шаблона
электронного чека.
6
.
Изменение мТксимТльного времени Фля
провеФения трТнзТкции клиентом
Стандартное значение времени отводимого держателю для проведения операции
составляет 10 минут.
Стандартное значение можно увеличить до 20 минут для отдельных транзакции, для этого
в запрос на проведение операции необходимо добавить параметр
ecomm_payment_
timeout=
1200 (значение указывается в секундах)
Пример
запроса
в Банк, п
араметры
Http
post
:
command=a&amount=12300¤cy=643&client_ip_addr=10.0.20.30&description=Заказ
N123&mrch_transaction_id=DMS
authorization&language=ru&ecomm_payment_timeout=1200&
server_version=2.0
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
30
|
Страница
7
.
ИнформТция о мТршруте полетТ в
ТвиТкомпТнию
–
ФлиннТя зТпись
(
Airline
itinerary
)
Функционал
Airline itinerary
(
«длинная запись»
)
используется при оплате авиабилетов,
отражает идентифи
кационные параметры пассажира
–
номер билета, и
мя пассажира,
название агентства, также данные переле
та (название аэропорта и т.д.
).
Для использования
функционала Airline itinerary,
необходимо направить запрос в Банк, по
результатам которого будут произведены необходимые настройки, что позволит ТСП
использовать данный функционал.
Приведённые ниже параметры
–
общие для всех этапов путешествия.
Деталь
«
n
_
legs
»
до
лжна обязательно прис
утствовать
и иметь значение от 1 до 4.
Переменная
Тип
поля
Формат
Количество
символов
(max)
Описание
n_legs
М
n
1
Количество этапов путешествия
М
an
15
Номер билета
carrier_name
О
an
19
Название перевозчика
travel_agency_code
О
an
8
Код
агентства
travel_agency_name
О
an
25
Название агентства
plan_nr
О
an
2
Номер плана
invoice_number
О
an
6
Номер счёта
-
фактуры
airline_orig_ccy
О
n
3
Оригинальный код валюты
passenger_name
М
ans
29
Имя пассажира
customer_ref
М
ans
20
Ссылка на клиента
original_amnt
О
n
12
Сумма оригинального счёта
-
фактуры
О
ans
16
Адрес выдачи билета
О
n
8
Дата выдачи билета
total_fare
О
n
12
Общая сумма
total_fees
О
n
12
Общая сумма пошлин
total_tax
О
n
12
Общая сумма налогов
restricted_ticket_indicator
О
ans
1
Индикатор билета ограниченного
использования
Параметры
, приведённые ниже, описывают конкретный этап путешествия.
Наименования
данных
параметров
должны иметь следующую форму:
<название_
параметра
<номер_этапа_перевозки>.
Например,
параметры
“departure_ai
rport1”, “carrier_code1” и т.д., о
писывают 1
-
ый этап
путешествия,
параметры
“departure_airport2”, “carrier_co
de2” и т.д. описывают 2
-
ой этап
путе
шествия и т.д.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
31
|
Страница
Переменная
Тип
поля
Формат
Количество
символов
(max)
Описание
departure_airportN
М
an
5
Аэропорт вылета
carrier_codeN
М
an
2
Код перевозчика
fare_bassisN
О
an
15
Код базового плана оплаты
service_classN
О
an
2
Класс перевозки
stop_over_codeN
О
an
1
Код остановки
destination_airportN
М
an
5
Аэропорт прилёта
departure_dateN
М
n
8
Дата вылета
departure_taxN
О
n
12
Сумма налога вылета
О
an
15
Номер дополнительного билета
exchange_ticketN
О
an
15
Номер билета
замены
coupon_numberN
О
ans
1
Номер купона
trip_numberN
О
ans
5
Номер полёта
departure_timeN
О
n
4
Дата вылета
arrival_timeN
О
n
4
Дата прибытия
fare_amntN
О
n
12
Сумма
fees_amntN
О
n
12
Сумма пошлин
tax_amntN
О
n
12
Сумма налогов
endorsements_restrN
О
ans
20
Дополнительные ограничения
Сокращения:
М (
Mandatory
)
–
обязательное поле
О
(
Optional
)
–
опциональное
n
–
номер
an
–
буквенно
-
цифровая строка
ans
–
строка, состоящая из бук
в, цифр и специальных символов.
Пример
:
При
DMS
схем
е
Регистрация транзакции DMS (авторизация)
Запрос в Банк
, п
араметры
Http
post
:
command=a&amount=123400¤cy=643&client_ip_addr=10.0.20.30&description=
Заказ
N123&
mrch_transaction_id=Airlineitinerary&language=ru
&msg_type=DMS
&
server_version=2
Результат
:
TRANSACTION_ID:
TEQzJ0AWm8lNChYUhpXTlrbh6Vo=
MRCH
_
TRANSACTION
_
ID
:
AIRLINE ITINE
R
ARI
Перенаправление
К
лиента на адрес платежного шлюза для проведения операции
https
://
testsecurepay
.
rsb
.
ru
/
ecomm
2/
ClientHandler
?
trans
_
id
=
TEQzJ
0
AWm
8
lNChYUhpXTlrbh
6
Vo
=
Подтверждение
/определение статуса
платежа
(на странице
RETURN
_
URL
)
Запрос в Банк
, п
араметры
Http
post
:
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
32
|
Страница
command=c&trans_id=
TEQzJ0AWm8lNChYUhpXTlrbh6Vo=
&client_ip_addr=10.0.20.30
&server_version
=2.0
Результат
:
RESULT: OK
RESULT_PS: ACTIVE
RESULT_CODE: 000
3DSECURE:
AUTHENTICATED
RRN: 330912581996
APPROVAL_CODE: 005704
CARD_NUMBER: 676196********0498
MRCH_TRANSACTION_ID:
AIRLINE ITINENARI
AUTH
_
TIME
: 20131105124227
TYPE
:
DMS
Выполнение
/
расчет
DMS
транзакции
Запрос в Банк
, п
араметры
Http
post
:
command=t&trans
_id=
TEQzJ0AWm8lNChYUhpXTlrbh6Vo=
&amount=123400¤cy=643&
client_ip_
addr=
10.0.20.30
&language=ru
&msg_type=DMS
&
r_name=VASILII PUPKIN&customer_ref=No money no
funny&departure_airport1=SVO&carrier_code1=UN&departure_date1=20140131&destination_airport1=L
ED&departure_airpor
t2=LED&carrier_code2=SU&departure_date2=20140201&destination_airport2=HE
M&
server
_version=2.0
Результат
:
RESULT: OK
RESULT_CODE: 000
RRN: 330912581996
APPROVAL_CODE: 005704
CARD_NUMBER: 676196********0498
Примечание:
Д
етализаци
я
параметров
описана
в пунктах:
7. Расшифровка значений и 8. Расшифровка кодов ответа
_
.
ВыстТвление счетТ нТ оплТту по
электроннои почте
/
нТ
мобильныи телефон
КлиентТ (
в формТте
3M3
сообщения
)
Ф
ункция
выставление счета не
требует технической интеграции
с решением
RSB
_
ECOMM
и предоставляется по запросу в банк на адрес
ecomm
@
rsb
.
ru
.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
33
|
Страница
Для настройки сервиса, в Банк необходимо сообщить
лишь
_URL
(либо сообщить о
желании использовать стандартную страницу возврата Клиента, предоставляемую
Банком)
, и указать схему подключения
–
«Выставления счета»
.
Обращаем Ваше внимание, что страница
_URL должна информировать
К
лиента о
необходимости обращения
непосредственно в ТСП в целях уточнения статуса платежа.
Функция выставление счета доступна
в системе Ecomm tortal (личный кабинет).
Схема работы описан
а
в «Инструкции пользователя
Ecomm
Portal
», пункт 3 (отправка
счета)
.
Ссылка на инструкцию:
https://testsecurepay.rsb.ru/email/ECOMM_Portal_RSB.pdf
По результатам успешной операц
ии (статус
–
«
F
inished
»
) возможно подключить
направление электронного чека на
электронную почту
Клиента
(пример чека пункт 5).
В целях подключения данной функции необходимо заблаговременно уведомить Банк.
9
.
Сервис
M
aster
0
ass.
Банк может предоставить для интернет
-
магазина дополнительный метод оплаты через
Сервис
MasterPass
от
Mastercard
(
https
://
masterpass
.
com
/
)
.
Доступ к сервису
MasterPass
предоставляется по запрос
у
на
ecom
@
rsb
.
ru
.
В ответ вам будут направлены дополнительные переменные для передачи в запросах на
регистрацию транзакции с возможностью оплаты чере
з
MasterPass
:
masterpass
_
button
–
для активации функционала
MasterPass
значение:
true
.
oauth_consumer_key
–
статичное значение, единое для всех мерчантов,
полученное от Банка, значение меняется раз в год.
checkout_identifier
-
статичное значение, уникально
е для каждого мерчанта,
полученное от Банка.
Пример запроса на регистрацию транзакции с возможностью оплаты через
MasterPass
:
command=a&amount=1000&description=testmasterpass&language=¤cy=643&
masterpass_button
=true&
oauth_consumer_key=OG4Td5hI58jozLAvS3ARpGMj65JvClVTQYqLqxdcbb5044ae!600fc0a2f6fc
4b18ba18682343eb8f130000000000000000&checkout_identifier=6453299f30e941349203b1cf9e8b8aac
&server_version=2.0&client_ip_addr=10.14.123.123
При наличии указанных переменных в за
просе на регистрацию транзакции, на платежной
странице будет доступен дополнительный метод оплаты
MasterPass
:
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
34
|
Страница
Доступен функционал автоматического редиректа держателя карты на сервис
MasterPass
со страницы
Clienthandler
. В запросе на регистрацию транзак
ции добавляется переменная
language
=
masterpass
.
Требования по брендированию на стороне интернет
-
магазина:
На официальном сайте
mastercard
:
https:
//developer.mastercard.com/documentation/masterpass
-
merchant
-
integration#branding
URL
документации:
https://developer.master
card.com/media/fa/3f/8e57e005485eb5f112954c03ecefMasterpa
ssMerchantBrandingRequirements.pdf
URL
иконки
,
кнопки
masterpass, LearnMore:
https://developer.mastercard.com/page/masterpass
-
digital
-
assets
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
35
|
Страница
10
.
Примеры реТлизТции бизнес логики
зТпросов
при условии рТзмещения
плТтежнои стрТницы нТ стороне
оргТнизТции / провТи ФерТ
(–.5
0arty
)
1
.
10
.1
КрТткое описТние функционТлТ:
1.
Держатель
карты выбирает продукт и готов заплатить за покупку.
2.
Держатель
карты
вводит реквизиты карты на платежной странице.
3.
Вы передаете нам запрос на платежный URL_1 (aerchant Handler), в котором
уходят все детали карты и детали сделки.
4.
Мы регистрируем транзакцию
у себя и отвечаем Вам параметром
–
transaction_id
5.
После этого Вы перекидываете Держателя к нам по платежному URL_2 (/lient
Handler)+transaction_id
6.
Держатель визуально ничего не видит, только серию редиректов в браузере
(передача управления к atL).
7.
Далее м
ы проводим авторизацию (при наличии 3DS Держатель переходит на
страницу A/S для прохождения аутентификации), и перенаправляем Держателя к вам на URL
-
возврата. При этом мы передаем Вам параметр transaction_id
8.
После этого вы направляете запрос статуса на URL
_1(Merchant Handler) +
transaction_id
–
возвращаем детали транзакции.
9.
В случае DaS авторизации, для платежа ТСП необходима дополнительная
транзакция.
Такая транзакция типично выполняется после доставки продукта клиенту.
SMS
транзакция не требует дополнительной операции, так как списание средств
осуществляется в рамках одной транзакции.
10.
ТСП регулярно (раз в день) отправляет серверу E/Oaa запрос на завершение
бизнес
-
дня.
10
.–
КомТнФы (иФентификТторы) используемые при
регистрТции
трТнзТкции :
I
–
SMS
транзакция
J
–
DaS авторизация
T
–
DaS транзакция/выполнение (используется при W, N)
U
–
создание шаблона
recurrent
(
SMS
транзакция)
N
–
создание шаблона
recurrent
(DaS авторизация)
E
–
выполнение/вызов шаблона
recurren
t
(
SMS
транзакция)
X
–
удаление шаблона
recurrent
K
–
возврат
1
Использование функционала возможно исключительно после предоставления в Банк сертификата
PCI
DSS
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
36
|
Страница
R
–
отмена
C
–
запрос статуса (используется при L, U, W, N)
B
–
завершение бизнес
–
дня
10
.3
ОписТние переменных:
Переменная
Тип
поля
Количество
символов (max)
Описание
trans_id
28
Идентификатор транзакции.
amount
M
12
Сумма транзакции в целых единицах,
последние два символа
–
копейки.
currency
M
3
Код валюты транзакции (LSO 4217)
–
На
территории РФ
-
643 код.
client_ip_addr
M
15
Lt адрес клиента.
cardname
M
Имя/фамилия
держателя карты.
pan
M
19
Номер карты.
expiry
M
4
Срок действия карты (в формате ГГММ).
cvc2
M
3/4
/V/2//VV2 значение.
email_client
O
100
адрес клиента
description
O
125 (латиницей)
Описание платежа, (кодировка
–
UTF 8).
Каждая русская (кириллица) буква
-
это 2
(два) символа. Нельзя использовать двойные
кавычки: ". Не рекомендуется использовать
символы: &, %, №, @, $, *,(для этих символов
используются значения согласно таблице
кодировки URL.
mrch_transaction_
id
O
225 (лат
иницей)
Описание платежа (кодировка
–
UTF 8).
Каждая русская (кириллица) буква, это два
символа. Используется для передачи доп.
сведений о заказе.
language
O
32
Идентификатор языка платежной
страницы.
Обязателен, в случае необходимости
использования
платежной страницы на
разных языках.
server_version
O
4
Если необходим возврат дополнительных
деталей, должно быть указано „2.0”. Если
параметр не указан или равен „1.0”,
дополнительные детали не возвращаются.
biller_client_id
(rec_payment_id)
M
49
Выбранный ТСП идентификатор регулярного
платежа. Окончательное значение
идентификатора регулярных платежей
формируется с помощью aerchant LD ТСП и
значения указанного rec_pmnt_id
идентификатора.
perspayee_expiry
M
4
Предельный срок действия регулярного
пл
атежа (в формате ММГГ).
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
37
|
Страница
perspayee_gen=1
M
1
Используется для генерации нового шаблона
регулярного (рекуррентного) платежа.
10
.4
АФрес плТтежного шлюзТ БТнкТ (тест):
Merchant
Handler
URL
(тестовый)
–
используется для получения
transaction
_
id
https
://
testsecurepay
.
rsb
.
ru
:9443/
ecomm
2/
MerchantHandler
Client
Handler
URL
(тестовый)
–
используется для перенаправления Клиента на платежную
страницу, для ввода
реквизитов карты
https
://
testsecurepay
.
rsb
.
ru
/
ecomm
2/
ClientHandler
?
trans
_
id
=
transaction
_
id
10
.5
3M3
трТнзТкция
Параметры LaA запроса:
public String startCardSMSTrans(String amount, String currency, String ip, String desc, String cardname
,
String pan, String expiry, String cvc2, String language, Properties properties)
public String sta
rtCardSMSTrans(String amount, String currency, String ip, String desc, String cardname,
String pan, String expiry, String cvc2, String language)
Параметры
Https post:
command=i&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&client_ip_addr=ipi5p;-900;&
email_client=email
&
description=desc-5de;s-5;-50;&cardname=cardnaml-5; rd-;na;m-2;Ḁe&pan=papa-;n00;n&expiry=expiry-5ex;-3pi;r-2;y18;&cvc2
=cvcl-1;v6c;-520;2&language=language-5l5; n-7;gu-7; g4e;-900;&msg_type=SMS(&property_namp-9;r-3o;p4er;t-13;y18_;-9na;m-2;Ḁe=property_value-5pr;oper;t-24;y18_;-9v6; -9l;ue-;瀀)*
Результат
:
TRANSACTION_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
10
.6
DM3
ТвторизТция
Параметры LaA запроса:
public String
startCardDMSAuth(String amount, String currency, String ip, String desc, String cardname,
String pan, String expiry, String cvc2, String language, Properties properties)
public String startCardDMSAuth(String amount, String currency, String ip, String desc
, String cardname,
String pan, String expiry, String cvc2, String language)
Параметры
Https post:
command=j&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&client_ip_addr=ipi5p;-900;&
email_client=email-5em;-20a;i7l5;
&
description=desc-5de;s-5;-50;&cardname=cardnaml-5; rd-;na;m-2;Ḁe&pan=papa-;n00;n&expiry=expiry-5ex;-3pi;r-2;y18;&cvc2
=cvcl-1;v6c;-520;2&language=language-5l5; n-7;gu-7; g4e;-900;&msg_type=DMS(&property_nam-5p-; r-3;op4e;rt-1;y18;_-9n;¤m-;⇠e=property_value-5pr;oper;t-24;y18_;-9v6; -9l;ue-;瀀)*
Результат
:
TRANSACTI
ON_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
38
|
Страница
10
.7
DM3
трТнзТкция/выполнение (используется при
J, .)
Параметры
IMA
запроса
:
public String makeDMSTrans(String auth_id, String amount, String currency, String ip, String desc, String
language, Properties properties)
backward compatibility
public String makeDMSTrans(String auth_id, String amount, String currency, String ip, String desc, String
language)
Параметры
Http post:
command=t&trans_id=auth_i-5au;t-1;h_4;i-6d;d&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;nn4;-17;y180;&client_ip_addr=ii-6;p000;p&
descri
ption=descm-9;s-3;-50;&language=languagel-6; n4g;u-7a;g4e-;退&msg_type=DMS(&property_nampro;p-10;rt-;y1;_-9;na4m;-21e;e=property_value-5pr;o-12;pe4r;-3t-;y1;_-9;v-5a;l-4u;-70;)*
Результа
т
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
RRN: rrr-3;r-3n;n
APPROVAL_CODE: app_cod-4ap;p-9;_-9c;-5od;一e
CARD_NUMBER pa-5pa;-7n0;n
10
._
СозФТние
шТблонТ
recurrent
(
3M3
трТнзТкция
)
Параметры
IMA
запроса
:
public String startCardSMSRecurringTrans(String amount, String currency, String
ip, String desc, String
rec_payment_id, String rec_payment_expiry, String cardname, String pan, String expiry, String cvc2 )
public String startCardSMSRecurringTrans(String amount, String currency, String ip, String desc, String
rec_payment_id, String
rec_payment_expiry, String cardname, String pan, String expiry, String cvc2,
String language )
public String startCardSMSRecurringTrans(String amount, String currency, String ip, String desc, String
rec_payment_id, String rec_payment_expiry, String cardna
me, String pan, String expiry, String cvc2,
String language, Properties properties)
Параметры
Https post:
command=u&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&client_ip_addr=client_ip_adl-5;l5i-;nn4;t_-8;i-6p;_4ad;-7dr;dr&description=
desc&biller_client_id=rec_payment_idr-3;ì-1;_p4; -21;y30m;-21e;n4t_;-8i5; -90;&perspayee_expiry=
rec_payment_expiryr-1;-;_p4; -21;y30m;-21e;n4t-;_e;x-5;p-9i;-6r-;y1;耀&cardname=cardn
ame&pan=papa-;n00;n&expiry=expirynx-;p-9;i5r-;y1;耀&cvc2=cvc2l-5;v6c-;R-9;&language=language-5l5; -9n;g4u-;g4;-90;&msg_type=SMS&perspayee
_gen=1(&property_nam-5pr;op-1;rt;-13y;_-; na4;m-21;e=property_valu-5pr;oper;t-24;y18_;-9v6; -9l;u-9;e)*
Результат
:
TRANSACTION_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
10
.9
СозФТние шТблонТ
recurrent (
DM3
ТвторизТция)
Параметры
IMA
запроса
:
public String startCardDMSRecurringAuth(String amount, String currency, String ip, String desc, String
rec_payment_id, String rec_payment_expiry, String cardname, String pan, String expiry, String cvc2 )
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
39
|
Страница
public String startCardDMS
RecurringAuth(String amount, String currency, String ip, String desc, String
rec_payment_id, String rec_payment_expiry, String cardname, String pan, String expiry, String cvc2,
String language )
public String startCardDMSRecurringAuth(String amount, Strin
g currency, String ip, String desc, String
rec_payment_id, String rec_payment_expiry, String cardname, String pan, String expiry, String cvc2,
String language, Properties properties)
Параметры
Https post:
command=n&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&
client_ip_addr=client_ip_adl-5;l5i-;nn4;t_-8;i-6p;_4ad;-7dr;dr&description=
desc&biller_client_id=rec_payment_idr-3;ì-1;_p4; -21;y30m;-21e;n4t_;-8i5; -90;&perspayee_expiry=rec_payment_expiryr-1;-;_p4; -21;y30m;-21e;n4t-;_e;x-5;p-9i;-6r-;y1;耀&cardname=cardn
ame&pan=papa-;n00;n&expiry=expirynx-;p-9;i5r-;y1;耀&cvc2=cvc2l-5;v6c-;R-9;&language=language-5l5; -9n;g4u-;g4;-90;&msg_type=DMS&perspayee
_gen=1(&property_nam-5pr;op-1;rt;-13y;_-; na4;m-21;e=property
_value)*
Результат
:
TRANSACTION_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
10
.10
Выполнение/вызов шТблонТ
recurrent (3M3
трТнзТкция)
Параметры
IMA
запроса
:
public String makeRP(String rec_payment_id, String amount, String currency,String ip, String desc,
Properties properties)
Параметры
Http post:
command=e&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;urr-;n-9;nc-1;y60;&client_ip_addr=ipi5p;-900;&description=desc淤s-5c;-500;&langu
age=language-5l5; -9n;g4u-;g4;-90;&biller_client_id=rec_payment_idr-1;-;_p4; -21;y30m;-21e;n4t-;_i;}-9;(&property_nam-5pr;oper;t-24;y18_;-9na;m-2;Ḁe=property_valupro;-12p;-9er;t-13;y18_;-9v6; -9l;u-9;e)*
Результат
:
TRANSACTION_ID: trans_idtr-;*-9;ns-3;_i7d;-900;
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE:result_coder-3;s-3;ul-4;t_c-;od;N-9;
RRN:rrnr-3;r-3n;-900;
APPROVAL_CODE:appr_cod-4ap;pr_;-12c;-5od;一e
10
.11
УФТление
шТблонТ
recurrent
Параметры LaA запроса:
Параметры
Http post:
command=x&biller_client_id=
rec_payment_id(&property_nam-5pr;oper;t-24;y18_;n-7a;m-20;e=property_value-5pr;op-1;rt;-13y;_-;!v6; -9l;ue-;瀀)*
Результат:
RESULT
:
result
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
40
|
Страница
10
.1–
ВозврТт
Параметры LaA запроса:
public Stri
ng refund(String trans_id)
public String refund(String trans_id, Properties properties)
public String refund(String trans_id, String amount, Properties properties)
Параметры
Http post:
command=k&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&amount=amoujm-; ou;nt0;nt(&property_nampro;-12p;är-;t-2;y18;_n-7; m-2;e=
property_value)*
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
REFUND_TRANS_ID: refund_transaction_idr-3;ï-8;un4d;_-7t;r-2a;n4s-;֬-;ti-;on4;_-9i;]-9;
10
.13
ОтменТ
Параметры
IMA
запроса
:
public String reverse(String trans_id)
public String reverse(String trans_id, String amount)
public
String reverse(String trans_id, String amount, String suspected_fraud)
public String reverse(String trans_id, Properties properties)
public String reverse(String trans_id, String amount, Properties properties)
public String reverse(String trans_id
, String amount, String suspected_fraud, Properties properties)
Параметры
Http post:
command=r&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&amount=amoujm-; ou;nt0;nt(&property_nampro;-12p;är-;t-2;y18;_n-7; m-2;e=property_valupro;p-10;rt-;y1;_-9;v6a-; l5u;-9e0;e)*
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
10
.14
ЗТпрос стТтусТ
(используется при
), D, J, .)
Параметры
IMA
запроса
:
public String getTransResult(String trans_id, String ip)
public String getTransResult(String trans_id, String ip, Properties properties)
Параметры
Http post:
command=c&trans_id=trans_idtr-;*-9;ns-3;_i7d;-900;&
client_ip_addr=ipi-6;p-90;(&property_nampro;p-10;rt-;y1;_-9;na4m;-21e;e=property_value-5pr;o-12;pe4r;-3t-;y1;_-9;v-5a;l-4u;-70;)*
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
41
|
Страница
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_PS: result_psr-3;s-3;u-9l;t_-;ps-;
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
3DSECURE: 3dsecc-9; s-3;ì-3;ure0;ure
RRN: rrr-3;r-3n;n
APPROVAL_CODE: app_cod-4ap;p-9;_-9c;-5od;一e
CARD_NUMBER: papa-;n00;n
AAV: aavڪ-;v-5;
RECC_PMNT_ID: rec_payment_idr-3;ì-3;_-9p; -7y;0m-;Ȟ-; nt_;-7i5; -90;
RECC_PMNT_EXPIRY: rcc_pmnt_exr-3;-5c;-5_p;m-;!nt;_4ex;-300;
MRCH_TRANSACTION_ID: mrch_tx_im-2;r-3;-5h;_4tx;-4_i;紀d
10
.15
ЗТвершение бизнес
-
Фня
Параметры LaA запроса:
public String closeDay()
public String closeDay(Properties properties)
Параметры
Http post:
command=b(&property_nampro;-12p;är-;t-2;y18;_n-7; m-2;e=
property_value)*
Результат
:
RESULT: resulr-3;s-3;ul-4;t000;t
RESULT_CODE: result_coder-3;s-3;u-9l;t_c;-14o;ൎ-;退
FLD_075: fld_075o-1;l5d;_-70;݅-;退
FLD_076: fld_076o-1;l5d;_-70;݆-;退
FLD_087: fld_087o-1;l5d;_-70;ࡇ-;退
FLD_088: fld_088o-1;l5d;_-70;ࡈ-;退
FLD_086: fld_086o-1;l5d;_-70;ࡆ-;退
FLD_087: fld_087o-1;l5d;_-70;ࡇ-;退
FLD_088: fld_088o-1;l5d;_-70;ࡈ-;退
FLD_089: fld_089o-1;l5d;_-70;ࡉ-;退
10
.16
Сервис
Master0
ass
.
Банк может предоставить для интернет
-
магазина дополнительный метод оплаты через
Сервис
MasterPass
от
Mastercard
(
https
://
masterpass
.
com
/
)
.
Доступ к сервису
MasterPass
предоставляется по запросу на
ecom
@
rsb
.
ru
.
В ответ вам будут направлены дополнительные переменные для передачи в запросах на
регистрацию тра
нзакции с возможностью оплаты через
MasterPass
:
masterpass
_
button
–
для активации функционала
MasterPass
значение:
true
.
language
–
выбор шаблона страницы для редиректа на
masterpass
, значение:
masterpass
oauth_consumer_key
–
статичное значение, единое для всех мерчантов,
полученное от Банка, значение меняется раз в год.
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
4
2
|
Страница
checkout_identifier
–
статичное значение, уникальное для каждого мерчанта,
полученное от Банка.
Для
SMS
/
DMS
оплаты команды
V
/
A
.
Пример запроса на регистрацию транзакции с возможностью оплаты через
MasterPass
:
command=a&amount=1000&description=testmasterpass&language=¤cy=643&
masterpass_button
=true&language=masterpass&oauth_consumer_key=OG4Td5hI58jozLAvS3ARpGMj65JvClVTQYqLqxdc
b
b5044ae!600fc0a2f6fc4b18ba18682343eb8f130000000000000000&checkout_identifier=6453299f30e94
1349203b1cf9e8b8aac
&server_version=2.0&client_ip_addr=10.14.123.123
Со страницы
clienthandler
осуществляется автоматический редирект на сервис
MasterPass
.
Требовани
я по брендированию на стороне интернет
-
магазина:
На официальном сайте
mastercard
:
https://developer.mastercard.com/documentation/masterpass
-
mercha
nt
-
integration#branding
URL
документации:
https://developer.mastercard.com/media/fa/3f/8e57e005485eb5f112954c03ecefMasterpa
s
sMerchantBrandingRequirements.pdf
URL
иконки
,
кнопки
masterpass, LearnMore:
https://developer.mastercard.com/page/masterpass
-
digital
-
assets
11.
ПереФТчТ
/ телефонТ клиентТ
В зТпросы нТ провеФение
SMS
трТнзТкции /
DMS
ТвторизТции необхоФимо при
нТличии возможности переФТвТть пТрТметры
email_client
,
phone
_
client
соФержТщие информТцию по ТктуТльному ТФресу электронноШ почты и телефону
плТтельщикТ.
ДТннТя информТция увеличивТет возможность получения положительного
решения нТ стороне службы риск
-
менеФжментТ БТнкТ.
1
–
.
РТсшифровкТ знТчении , фигурирующих в
ответТх БТнкТ нТ зТпросы ТСП
RESULT
С
татус результата транзакции
OK
Т
ранзакция завершена успешно
FAILED
Н
еуспешная транзакция
CREATED
Т
ранзакция зарегистрирована в системе
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
43
|
Страница
PENDING
В
ыполнение транзакции продолжается
DECLINED
Т
ранзакция отклонена системой RS._E/Oaa, так как E/L находится в
списке заблокированных
E/L (конфигурация серверной части
RSB_ECOMM)
REVERSED
Т
ранзакция отменена
AUTOREVERSED
Т
ранзакция автоматически отменена системой RS._E/Oaa
TIMEOUT
время отведенное на проведение транзакции истекло
RESULT_PS
Р
езультат транзакции в интерпретации платежного сервера
(конфигурируется, если в запросе была передана переменная
server_version=2.0)
ACTIVE
Т
ранзакция зарегистрирована, но не завершена
FINISHED
Т
ранзакция завершена успешно
CANCELLED
Т
ранзакция отменена
RETURNED
Т
ранзакция возвращена
RESULT_CODE
К
од результата транзакции (3 цифры) (см. в таблице «Расшифровка
кодов ответа сервера»)
В случае регулярного платежа коды ответа (result_code) имеют
дополнительное значение:
108
–
ТСП необходимо связаться с
клиентом͖
114
–
ТСП может повторить транзакцию позднее͖
180
–
Клиент отказался от дальнейшего сотрудничества. Регулярный
платеж был удален͖
2xx
–
Регулярный платеж был удален.
3DSECURE
С
татус 3D Secure аутентификации
AUTHENTICATED
б
спешная аутентификация 3D Secure
DECLINED
Н
еуспешная аутентификация 3D Secure
NOTPARTICIPATED
К
арта клиента не является участником схемы 3D Secure
NO_RANGE
К
арта не входит в интервал 3D Secure карт, указанных на стороне
эмитента
ATTEMPTED
Б
ыла попытка аутентификация 3D secure через A/S сервер
UNAVAILABLE
А
утентификация 3D secure не доступна
ERROR
С
ообщение об ошибки возвращено из A/S сервера
SYSERROR
3D Secure аутентификация закончилась системной ошибкой
UNKNOWNSCHEME
П
опытка выполнить 3D Secure аутентификация для неизвестного типа
карты (Dinners club, American Express)
RRN
Н
омер поисковой ссылки, возвращенный системой RS._E/Oaa
APP_CODE
К
од подтверждения, возвращенный системой RS._E/Oaa (максимум
6 знаков)
PAN
М
аскированный номер карты
TRANS_ID
И
дентификатор транзакции (28 знака в кодировке base64)
REFUND_TRANSACTION_ID
И
дентификатор транзакции (trans LD) возврата
–
применим для
получения деталей операции возврата или для отмены операции
возврат (данный функци
онал временно не доступен)
CLOSE DAY
Применимо к процедуре завершения бизнес дня
fld_075
К
оличество реверсалов (до 10 цифр), отображается
исключительно в
случае,
если result_code начинается с 5
fld_076
К
оличество операций оплата (до 10 цифр), отображается
исключительно
в случае,
если result_code начинается с 5
fld_087
О
бщая сумма реверсалов (до 16 цифр), отображается
исключительно в
случае,
если result_code начинается с 5
fld_088
О
бщая сумма операций оплата (до 16 цифр), отображается
исключительно в случае,
если result_code начинается с 5
RECURRING
Применимо при регистрации регулярного платежа
rec_pmnt_id
В
ыбранный ТСП идентификатор регулярного платежа
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
44
|
Страница
expiry
С
рок действия
регулярного платежа в формате ММГГ
Поля
RESULT
_
PS
и 3
DSECURE
,
нося
т информативный характер,
и могут не отображаться.
Поля
RRN
и
APPROVAL
_
CODE
отображаются только для успешных транзакций в целях
информации, и облегчают отслеживание транзакций в системе
Ecomm
Portal
(личный
кабинет). Основой для принятия решения об успешном или не
успешном
выполнении
транзакции должно быть только значение поля
RESULT
и
RESULT
_
CODE
.
В случае ошибки возвращаемая строка символов начинается с ‘
error
:‘.
В случае
предупреждения возвращаемая строка символов начинается с ‘
warning
:’.
1
3
.
РТсшифровкТ коФов ответТ
(2E3D,4фC/DE)
Result
Code
Description
SHORT
Description FULL
ОписТние
0
00
Approved
Approved
Одобрено
100
Decline
Decline (general, no
comments)
Отказ
101
Decline
Decline, expired card
Отказ: карта просрочена
102
Decline
Decline, suspected fraud
Отказ
103
Decline
Decline, card acceptor
contact acquirer
Отказ: свяжитесь с обслуживающим банком
104
Decline
Decline, restricted card
Отказ: карта имеет
ограничения
105
Decline
Decline, card acceptor call
acquirer's security
department
Отказ: вызовите службу безопасности банка
106
Decline
Decline, allowable PIN tries
exceeded
Отказ: превышено число попыток ввода tLN
-
кода
107
Decline
Decline, refer to
card issuer
Отказ: свяжитесь с омитентом.
108
Decline
Decline, refer to card
issuer's special conditions
Отказ: обратитесь к омитенту
109
Decline
Decline, invalid merchant
Отказ: неверный код терминала
110
Decline
Decline, invalid amount
Отказ:
неверная сумма
111
Decline
Decline, invalid card number
Отказ: неверный номер Карты
112
Decline
Decline, PIN data required
Отказ: нужен ввод tLN
-
код
113
Decline
Decline, unacceptable fee
Отказ: недопустимая комиссия
114
Decline
Decline, no account of
type
requested
Отказ: неверный номер счета
115
Decline
Decline, requested function
not supported
Отказ: запрошенная операция недопустима
для Карты
116
Decline, no
funds
Decline, not sufficient funds
Отказ: недостаточно средств
117
Decline
Decline,
incorrect PIN
Отказ: неверный tLN
-
код
118
Decline
Decline, no card record
Отказ: Карта не найдена
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
45
|
Страница
119
Decline
Decline, transaction not
permitted to cardholder
Отказ: операция не разрешена Клиенту
120
Decline
Decline, transaction not
permitted to terminal
Отказ: операция, не разрешена по данному
терминалу
121
Decline
Decline, exceeds withdrawal
amount limit
Отказ: превышен лимит
122
Decline
Decline, security violation
Отказ: по соображениям безопасности
123
Decline
Decline, exceeds withdrawal
frequency limit
Отказ: превышено число операций
124
Decline
Decline, violation of law
Отказ: запрещено законодательством
125
Decline
Decline, card not effective
Отказ: Карта неактивна
126
Decline
Decline, invalid
PIN block
Отказ: неверный tLN
-
блок
127
Decline
Decline, PIN length error
Отказ: неверная длина tLN
-
код
128
Decline
Decline, PIN kay synch error
Отказ: ошибка обработки tLN
-
код
129
Decline
Decline, suspected
counterfeit card
Отказ: возможно, поддельная
Карта
(реквизиты карты введены не верно)
180
Decline
Decline, by cardholders wish
Отказ: по желанию держателя карты
181
Decline
Decline, Card is not active
Отказ: Карта не активна
182
Decline
Decline, Card is not active
Отказ: Карта не активна
183
Decline
Decline, Card is not active
Отказ: Карта не активна
184
Decline
Decline, Card is not active
Отказ: Карта не активна
185
Decline
Decline, Card is not active
Отказ: Карта не активна
186
Decline
Decline, Card is not active
Отказ: Карта не активна
187
Decline
Decline, Card is not active
Отказ: Карта не активна
188
Decline
Decline, Card is not active
Отказ: Карта не активна
189
Decline
Decline, Card is not active
Отказ: Карта не активна
190
Decline
Decline, Card is not active
Отказ: Карта не
активна
191
Decline
Decline, Card is not active
Отказ: Карта не активна
192
Decline
Decline, Card is not active
Отказ: Карта не активна
193
Decline
Decline, Card is not active
Отказ: Карта не активна
194
Decline
Decline, Card is not active
Отказ: Карта
не активна
195
Decline
Decline, Card is not active
Отказ: Карта не активна
196
Decline
Decline, Card is not active
Отказ: Карта не активна
197
Decline
Decline, Card is not active
Отказ: Карта не активна
198
Decline
Decline, Card is not active
Отказ:
Карта не активна
199
Decline
Decline, Card is not active
Отказ: Карта не активна
200
Pick
-
up
Pick
-
up (general, no
comments)
Изъять Карту
201
Pick
-
up
Pick
-
up, expired card
Изъять Карту: Карта просрочена
202
Pick
-
up
Pick
-
up, suspected fraud
Изъять Карту: возможна мошенническая опер
ация
203
Pick
-
up
Pick
-
up, card acceptor
contact card acquirer
Изъять Карту: свяжитесь с обслуживающим
банком
204
Pick
-
up
Pick
-
up, restricted card
Изъять Карту: Карта имеет ограничения
205
Pick
-
up
Pick
-
up, card
acceptor call
acquirer's security
department
Изъять Карту: вызовите службу безопасности
обслуживающего банка
206
Pick
-
up
Pick
-
up, allowable PIN tries
exceeded
Изъять Карту: превышено число попыток
ввода tLN
-
код
207
Pick
-
up
Pick
-
up, special conditions
Изъять Карту: специальные условия
208
Pick
-
up
Pick
-
up, lost card
Изъять Карту: Карта утеряна
209
Pick
-
up
Pick
-
up, stolen card
Изъять Карту: Карта украдена
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
46
|
Страница
400
Accepted
Accepted (for reversal)
Одобрено (для отмены Авторизации)
499
Approved
Approved, no
original
message data
Одобрено, оригинальная операция не
найдена
500
Call acquirer
Status message: reconciled,
in balance
Одобрено: итоги совпали
900
Accepted
Advice acknowledged, no
financial liability accepted
Запрос авторизован, никаких финансовых
обязательств не одобрено
901
Accepted
Advice acknowledged,
finansial liability accepted
Запрос авторизован, финансовые
обязательства одобрены
902
Call acquirer
Decline reason message:
invalid transaction
Обратитесь к дежурной службе: неверная
операция
903
Call acquirer
Status message: re
-
enter
transaction
Обратитесь к дежурной службе: повторите
операцию
904
Call acquirer
Decline reason message:
format error
Обратитесь к дежурной службе: ошибка
формата данных
904
Call acquirer
Decline reason message:
format error
Обратитесь к дежурной службе: ошибка
формата данных
905
Call acquirer
Decline reason message:
acqiurer not supported by
switch
Обратитесь к дежурной службе: ошибка связи
с платежной системой
906
Call acquirer
Decline reason message:
cutover
in process
Обратитесь к дежурной службе: ошибка связи
с платежной системой
907
Call acquirer
Decline reason message:
card issuer or switch
inoperative
Обратитесь к дежурной службе: ошибка связи
с платежной системой
908
Call acquirer
Decline reason
message:
transaction destination
cannot be found for routing
Обратитесь к дежурной службе: ошибка связи
с платежной системой
909
Call acquirer
Decline reason message:
system malfunction
Обратитесь к дежурной службе: системная
ошибка
910
Call acquirer
Decline reason message:
card issuer signed off
Обратитесь к дежурной службе: ошибка связи
с платежной системой
911
Call acquirer
Decline reason message:
card issuer timed out
Обратитесь к дежурной службе: омитент
Карты недоступен
912
Call acquirer
Decline reason message:
card issuer unavailable
Обратитесь к дежурной службе: омитент
Карты недоступен
913
Call acquirer
Decline reason message:
duplicate transmission
Обратитесь к дежурной службе:
дублированная операция
914
Call acquirer
Decline reason
message: not
able to trace back to original
transaction
Обратитесь к дежурной службе: оригинальная
операция не найдена
915
Call acquirer
Decline reason message:
reconciliation cutover or
checkpoint error
Обратитесь к дежурной службе: ошибка связи
с
платежной системой
916
Call acquirer
Decline reason message:
MAC incorrect
Обратитесь к дежурной службе: ошибка aA/
917
Call acquirer
Decline reason message:
MAC key sync error
Обратитесь к дежурной службе: ошибка aA/
918
Call acquirer
Decline reason
message: no
communication keys
available for use
Обратитесь к дежурной службе: ошибка tLN
-
PAD
919
Call acquirer
Decline reason message:
encryption key sync error
Обратитесь к дежурной службе: ошибка
шифрования
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
47
|
Страница
920
Call acquirer
Decline reason message:
security software/hardware
error
-
try again
Обратитесь к дежурной службе: ошибка
шифрования
921
Call acquirer
Decline reason message:
security software/hardware
error
-
no action
Обратитесь к дежурной службе: ошибка
шифрования
922
Call acquirer
Decline
reason message:
message number out of
sequence
Обратитесь к дежурной службе: неверный
номер сообщения
923
Call acquirer
Status message: request in
progress
Обратитесь к дежурной службе: запрос
обрабатывается
950
Not accepted
Decline reason message:
violation of business
arrangement
Отказ: недопустимая операция
1001
Error
System error. Contact with
bank acquirer.
Системная ошибка. Свяжитесь с банком
-
эквайером.
XXX
Undefined
Code to be replaced by card
status code or stoplist
insertion reason code
Обратитесь к дежурной службе
1
4
.
Системные ошибки
(2E3D,4фC/DE 1
00
1)
Перечень наиболее час
т
о встречающихся Системных ошибок:
Result
Code
Description
SHORT
Description FULL
Описание
1001
Error
e
rror: unregistered merchant.
IP:
12.34.56.78
IP
-
адрес ТСП не зарегистрирован в Системе
Банка. Необходимо направить в Банк
соответствующий запрос для добавления
нового Lt
-
адреса в список разрешенных на
стороне Банка.
error: unable to process
transaction request
Потеря связи с Банком.
error: wrong transaction id
В запросе в Банк указано некорректное
значение параметра transaction id
.
error: no transaction id
В запросе в Банк
не
указано значение
параметра transaction id
.
status
Символ
«+»
в значении параметра
trans
ID
некорректно обработан на стороне ТСП.
error: total refunds amount
already exceeds original
amount
Общая сумма, подлежащая возврату
Клиенту, превышает сумму оригинальной
транзакции (покупки).
Два
возможных
варианта
:
-
Срок
действия карты, указанный Клиентом,
Инструкция
по
интеграции
и эксплуатации
платежной платформы
RSB
_
ECOMM
Версия: 2.2
.1
48
|
Страница
еrror: digest failed
предшествует сегодняшней дате.
-
Количество
символов
в
поле
«
Description
»
превышает разрешенное
error: transaction not found
бказанный
trans
_
id
не найден, из возможных
причин:
Символ
«+»
в значении параметра
trans
ID
некорректно обработан на стороне ТСП.
error = 'transaction already
reversed'
Отмена уже была проведена ранее.