При проведении операции повторного списания регулярно платежа в случае получения отказов с кодами: 100 Decline (general, no comments) 116 Decline, not sufficient funds 121 Decline

Чтобы посмотреть этот 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&#x-5am;&#x-8ou;nt-;耀¤cy=currencyl-5;&#xurr-;n-9;&#xnc-1;y60;&client_ip_addr=ipi5p;&#x-900;&description=desc淤&#xs-5c;&#x-500;&mrch
_transaction_id=mrch_tx_idm-2;
r8c;&#x-5h_;tx-;_i7; -90;&language=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&msg_type=SMS&server_version=2.0&#x-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;&#xns-3;&#x_i7d;&#x-900;&client_ip_addr=ipi-6;&#xp-90;
&server_version=2.0b-9;&#x.0-8;


Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_PS: result_psr-3;s-3;&#xu-9l;t_-;ps-;　

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

3DSECURE: 3dsecc-9; s-3;ì-3;&#xure0;ure

RRN: rrr-3;&#xr-3n;n

APPROVAL_CODE: app_cod&#x-4ap;p-9;&#x_-9c;&#x-5od;一e

CARD_NUMBER: papa-;n00;n

Инструкция
по
интеграции
и эксплуатации

платежной платформы
RSB
_
ECOMM


Версия: 2.2
.1

11

|
Страница


MR
CH_TRANSACTION_ID: mrch_tx_im-2;
r-3;-5h;&#x_4tx;&#x-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;&#xurr-;n-9;&#xnc-1;y60;&client_ip_addr=ipi5p;&#x-900;&description=desc淤&#xs-5c;&#x-500;&mrch
_transaction_id=mrch_tx_idm-2;
r8c;&#x-5h_;tx-;_i7; -90;&language=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&msg_type=DMS&server_version=2.0
�


Результат
:

TRANSACTION_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-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;&#xns-3;&#x_i7d;&#x-900;&client_ip_addr=ipi-6;&#xp-90;


Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_PS:
result_ps�

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

3DSECURE: 3dsecc-9; s-3;ì-3;&#xure0;ure

RRN: rrr-3;&#xr-3n;n

APPROVAL_CODE: app_cod&#x-4ap;p-9;&#x_-9c;&#x-5od;一e

CARD_NUMBER: papa-;n00;n

MRCH_TRANSACTION_ID: mrch_tx_im-2;
r-3;-5h;&#x_4tx;&#x-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;&#x-14a;&#x-9ns;&#x-3_i;} -;耀&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;&#xurr-;nn4;-29;&#xy180;&client_ip_addr=i

�p&description=descm-9;s-3;-50;&language=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&msg_type=DMS



Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

RRN: rrr-3;&#xr-3n;n

APPROVAL_CODE: app_cod&#x-4ap;p-9;&#x_-9c;&#x-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;&#xns-3;&#x_i7d;&#x-900;&amount=amoujm-; ou;nt0;nt

command=r&trans_id=trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-900;&amount=amoujm-; ou;nt0;nt&suspected_fraud=yes


Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-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;&#xns-3;&#x_i7d;&#x-900;&amount=amoujm-; ou;nt0;nt


Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

REFUND_TRANS_ID: refund_trans_idr-3;ï-8;&#xun4d;&#x_-7t;&#xr-2a;&#xn4s-;_-9;&#xi5d-;退



Пример
:


Запрос в Банк
, п
араметры

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
:
resul�t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

FLD_075: fld_075o-1;�l5d;&#x_-70;݅-;退

FLD_076: fld_076o-1;�l5d;&#x_-70;݆-;退

FLD_087: fld_087o-1;�l5d;&#x_-70;ࡇ-;退

FLD_088: fld_088o-1;�l5d;&#x_-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.
pdf



Примечание:

Д
етализаци
я

параметров
описана

в пунктах:

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&#x-5am;&#x-8ou;nt-;耀¤cy=currencyl-5;&#xurr-;n-9;&#xnc-1;y60;&clien
t_ip_addr=ipi5p;&#x-900;&description=des
�c
&mrch
_transaction_id=mrch_tx_idm-2;
r8c;&#x-5h_;tx-;_i7; -90;
&language=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&msg_type=SMS&biller_client_i
d=recc_pmnt_ir-1;׬-;<-5;&#x_p4m;&#x-21n;&#xt_4i;崀d
&
perspayee_expi
ry=expiry
�&perspayee_gen=1


Инструкция
по
интеграции
и эксплуатации

платежной платформы
RSB
_
ECOMM


Версия: 2.2
.1

22

|
Страница


Результат
:

TRANSACTION_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-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;&#xns-3;&#x_i7d;&#x-900;&client_ip_addr=ipi-6;&#xp-90;


Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_PS: result_psr-3;s-3;&#xu-9l;t_-;ps-;　

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

3DSECURE: 3dsecc-9; s-3;ì-3;&#xure0;ure

RRN: rrr-3;&#xr-3n;n

APPROVAL_CODE: app_cod&#x-4ap;p-9;&#x_-9c;&#x-5od;一e

CARD_NUMBER: papa-;n00;n

RECC_PMNT_ID: rcc_pmnt_ir-3;-5c;&#x-5_p;m-9;&#xnt_4;&#xi-6d;d

RECC_PMNT_EXPIRY: rcc_pmnt_exr-3;-5c;&#x-5_p;m-;!nt;&#x_4ex;&#x-300;

MRCH_TRANSACTION_ID: mrch_tx_im-2;
r-3;-5h;&#x_4tx;&#x-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;&#xurr-;n-9;&#xnc-1;y60;&client_ip_addr=ipi5p;&#x-900;&description=desc淤&#xs-5c;&#x-500;&mrch
_transaction_id=mrch_tx_idm-2;
r8c;&#x-5h_;tx-;_i7; -90;&language=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&
biller_client_id=recc_pmnt_ir-3;ì-3;-5_;&#xp4m-;!nt;&#x_4i-;洀d


Результат
:

TRANSACTION_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-900;

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE:result_coder-3;s-3;&#xul-4;&#xt_c-;od;N-9;

RRN:rrnr-3;&#xr-3n;&#x-900;

APPROVAL_CODE:appr_cod&#x-4ap;pr_;&#x-12c;&#x-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_
email
–

адрес электронной почты, на который будет направлен чек
о проведенном платеже. При необходимости чек может быть направлен н
а
несколько электронных адресов.

Н
аправляя соответствующие электронные
адреса, в качестве разделителя
,

используйте символ «,»
.



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

Email
адрес клиента

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;&#xurr-;n-9;&#xnc-1;y60;&client_ip_addr=ipi5p;&#x-900;&

email_client=email
�
&
description=desc&#x-5de;s-5;-50;&cardname=cardnaml-5; rd-;na;m-2;Ḁe&pan=papa-;n00;n&expiry=expiry&#x-5ex;&#x-3pi;r-2;y18;&cvc2
=cvcl-1;v6c;&#x-520;2&language=language&#x-5l5; n-7;&#xgu-7; g4e;&#x-900;&msg_type=SMS(&property_namp-9;&#xr-3o;&#xp4er;&#xt-13;&#xy18_;&#x-9na;m-2;Ḁe=property_value&#x-5pr;&#xoper;&#xt-24;&#xy18_;&#x-9v6; -9l;ue-;瀀)*


Результат
:


TRANSACTION_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-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;&#xurr-;n-9;&#xnc-1;y60;&client_ip_addr=ipi5p;&#x-900;&

email_client=email&#x-5em;&#x-20a;&#xi7l5;
&
description=desc&#x-5de;s-5;-50;&cardname=cardnaml-5; rd-;na;m-2;Ḁe&pan=papa-;n00;n&expiry=expiry&#x-5ex;&#x-3pi;r-2;y18;&cvc2
=cvcl-1;v6c;&#x-520;2&language=language&#x-5l5; n-7;&#xgu-7; g4e;&#x-900;&msg_type=DMS(&property_nam&#x-5p-; r-3;&#xop4e;&#xrt-1;y18;&#x_-9n;¤m-;⇠e=property_value&#x-5pr;&#xoper;&#xt-24;&#xy18_;&#x-9v6; -9l;ue-;瀀)*


Результат
:

TRANSACTI
ON_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-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&#x-5au;t-1;�h_4;&#xi-6d;d&amount=amountjm-; ou;nt-;耀¤cy=currencyl-5;&#xurr-;nn4;-17;&#xy180;&client_ip_addr=ii-6;&#xp000;p&
descri
ption=descm-9;s-3;-50;&language=languagel-6; n4g;&#xu-7a;&#xg4e-;退&msg_type=DMS(&property_nampro;&#xp-10;rt-;y1;_-9;&#xna4m;&#x-21e;e=property_value&#x-5pr;&#xo-12;&#xpe4r;&#x-3t-;y1;_-9;&#xv-5a;&#xl-4u;-70;)*

Результа
т
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

RRN: rrr-3;&#xr-3n;n

APPROVAL_CODE: app_cod&#x-4ap;p-9;&#x_-9c;&#x-5od;一e

CARD_NUMBER pa&#x-5pa;&#x-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;&#xurr-;n-9;&#xnc-1;y60;&client_ip_addr=client_ip_adl-5;&#xl5i-;nn4;&#xt_-8;&#xi-6p;&#x_4ad;&#x-7dr;dr&description=
desc�&biller_client_id=rec_payment_idr-3;ì-1;_p4; -21;&#xy30m;&#x-21e;&#xn4t_;&#x-8i5; -90;&perspayee_expiry=
rec_payment_expiryr-1;׬-;_p4; -21;&#xy30m;&#x-21e;&#xn4t-;_e;x-5;&#xp-9i;&#x-6r-;y1;耀&cardname=cardn
am�e&pan=papa-;n00;n&expiry=expirynx-;p-9;&#xi5r-;y1;耀&cvc2=cvc2l-5;&#xv6c-;R-9;&language=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&msg_type=SMS&perspayee
_gen=1(&property_nam&#x-5pr;&#xop-1;rt;&#x-13y;_-; na4;&#xm-21;e=property_valu&#x-5pr;&#xoper;&#xt-24;&#xy18_;&#x-9v6; -9l;u-9;e)*


Результат
:

TRANSACTION_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-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;&#xurr-;n-9;&#xnc-1;y60;&
client_ip_addr=client_ip_adl-5;&#xl5i-;nn4;&#xt_-8;&#xi-6p;&#x_4ad;&#x-7dr;dr&description=
desc�&biller_client_id=rec_payment_idr-3;ì-1;_p4; -21;&#xy30m;&#x-21e;&#xn4t_;&#x-8i5; -90;&perspayee_expiry=rec_payment_expiryr-1;׬-;_p4; -21;&#xy30m;&#x-21e;&#xn4t-;_e;x-5;&#xp-9i;&#x-6r-;y1;耀&cardname=cardn
am�e&pan=papa-;n00;n&expiry=expirynx-;p-9;&#xi5r-;y1;耀&cvc2=cvc2l-5;&#xv6c-;R-9;&language=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&msg_type=DMS&perspayee
_gen=1(&property_nam&#x-5pr;&#xop-1;rt;&#x-13y;_-; na4;&#xm-21;e=property
_valu�e)*


Результат
:

TRANSACTION_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-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;&#xurr-;n-9;&#xnc-1;y60;&client_ip_addr=ipi5p;&#x-900;&description=desc淤&#xs-5c;&#x-500;&langu
age=language&#x-5l5; -9n;&#xg4u-;šg4;-90;&biller_client_id=rec_payment_idr-1;׬-;_p4; -21;&#xy30m;&#x-21e;&#xn4t-;_i;}-9;(&property_nam&#x-5pr;&#xoper;&#xt-24;&#xy18_;&#x-9na;m-2;Ḁe=property_valupro;&#x-12p;&#x-9er;&#xt-13;&#xy18_;&#x-9v6; -9l;u-9;e)*


Результат
:

TRANSACTION_ID: trans_idtr-;*-9;&#xns-3;&#x_i7d;&#x-900;

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE:result_coder-3;s-3;&#xul-4;&#xt_c-;od;N-9;

RRN:rrnr-3;&#xr-3n;&#x-900;

APPROVAL_CODE:appr_cod&#x-4ap;pr_;&#x-12c;&#x-5od;一e



10
.11
УФТление

шТблонТ

recurrent

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



Параметры

Http post:

command=x&biller_client_id=
rec_payment_i�d(&property_nam&#x-5pr;&#xoper;&#xt-24;&#xy18_;&#xn-7a;&#xm-20;e=property_value&#x-5pr;&#xop-1;rt;&#x-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;&#xns-3;&#x_i7d;&#x-900;&amount=amoujm-; ou;nt0;nt(&property_nampro;&#x-12p;är-;t-2;y18;&#x_n-7; m-2;฀e=
property_valu�e)*


Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

REFUND_TRANS_ID: refund_transaction_idr-3;ï-8;&#xun4d;&#x_-7t;&#xr-2a;&#xn4s-;֬-;ti-;on4;&#x_-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;&#xns-3;&#x_i7d;&#x-900;&amount=amoujm-; ou;nt0;nt(&property_nampro;&#x-12p;är-;t-2;y18;&#x_n-7; m-2;฀e=property_valupro;&#xp-10;rt-;y1;_-9;&#xv6a-; l5u;&#x-9e0;e)*



Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-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;&#xns-3;&#x_i7d;&#x-900;&
client_ip_addr=ipi-6;&#xp-90;(&property_nampro;&#xp-10;rt-;y1;_-9;&#xna4m;&#x-21e;e=property_value&#x-5pr;&#xo-12;&#xpe4r;&#x-3t-;y1;_-9;&#xv-5a;&#xl-4u;-70;)*


Инструкция
по
интеграции
и эксплуатации

платежной платформы
RSB
_
ECOMM


Версия: 2.2
.1

41

|
Страница


Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_PS: result_psr-3;s-3;&#xu-9l;t_-;ps-;　

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

3DSECURE: 3dsecc-9; s-3;ì-3;&#xure0;ure

RRN: rrr-3;&#xr-3n;n

APPROVAL_CODE: app_cod&#x-4ap;p-9;&#x_-9c;&#x-5od;一e

CARD_NUMBER: papa-;n00;n

AAV: aavڪ-;v-5;

RECC_PMNT_ID: rec_payment_idr-3;ì-3;&#x_-9p; -7y;0m-;Ȟ-; nt_;&#x-7i5; -90;

RECC_PMNT_EXPIRY: rcc_pmnt_exr-3;-5c;&#x-5_p;m-;!nt;&#x_4ex;&#x-300;

MRCH_TRANSACTION_ID: mrch_tx_im-2;
r-3;-5h;&#x_4tx;&#x-4_i;紀d



10
.15
ЗТвершение бизнес
-

Фня

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

public String closeDay()


public String closeDay(Properties properties)


Параметры

Http post:

command=b(&property_nampro;&#x-12p;är-;t-2;y18;&#x_n-7; m-2;฀e=
property_value�)*

Результат
:

RESULT: resulr-3;s-3;&#xul-4;&#xt000;t

RESULT_CODE: result_coder-3;s-3;&#xu-9l;t_c;&#x-14o;ൎ-;退

FLD_075: fld_075o-1;�l5d;&#x_-70;݅-;退

FLD_076: fld_076o-1;�l5d;&#x_-70;݆-;退

FLD_087: fld_087o-1;�l5d;&#x_-70;ࡇ-;退

FLD_088: fld_088o-1;�l5d;&#x_-70;ࡈ-;退

FLD_086: fld_086o-1;�l5d;&#x_-70;ࡆ-;退

FLD_087: fld_087o-1;�l5d;&#x_-70;ࡇ-;退

FLD_088: fld_088o-1;�l5d;&#x_-70;ࡈ-;退

FLD_089: fld_089o-1;�l5d;&#x_-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.

ПереФТчТ
email

/ телефонТ клиентТ

В зТпросы нТ провеФение
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'

Отмена уже была проведена ранее.