Интеграционная платформа contact ng pay Technology Технология интеграции сервисов Участников с Системой contact - shikardos.ru o_O
Главная
Поиск по ключевым словам:
Похожие работы
Интеграционная платформа contact ng pay Technology Технология интеграции сервисов - страница №1/5




АКБ РУССЛАВБАНК (ЗАО)


Интеграционная платформа



CONTACT NG Pay

Technology

Технология интеграции сервисов Участников с Системой CONTACT

Версия 1.2

ОГЛАВЛЕНИЕ


Технология интеграции сервисов Участников с Системой CONTACT 1

1.Введение 4

2.Основные понятия 5

3.Процедура подключения 6

3.1.Получение документации, 7

3.2.Согласование условий взаимодействия и разработка 8

3.3.Тестирование 9

3.3.1.Тестирование шлюза 10

3.4.Организация рабочего канала связи и осуществление перехода в рабочий режим. 11

4.Порядок технологического взаимодействия 12

4.1. Основные параметры шлюза 13

4.2.Технология совершения операций 14

4.2.1.Этап первый. Оформление платежа. 15

4.2.2.Этап второй. Оплата платежа. 16

5.Описание методов 17

5.1.Общие положения 18

5.2.Проверка реквизитов платежа – метод CHECK 19

5.2.1.Формат запроса: 20

5.2.2.Описание полей запроса (тэгов). 22

5.2.3.Формат ответа: 24

5.2.4.Описание полей ответа (тэгов). 25

5.3.Оплата платежа – метод PAY 26

5.3.1.Формат запроса: 27

5.3.2.Описание полей запроса (тэгов). 29

5.3.3.Формат ответа: 31

5.3.4.Описание полей ответа (тэгов). 32

5.4.Получение информации о платеже – метод GET 33

5.4.1.Формат запроса: 34

5.4.2.Формат ответа: 35

5.5.Отмена оплаты платежа – метод CANCELPAY 36

5.5.1.Формат запроса: 37

5.5.2.Формат ответа: 38

6.Приложения 39

6.1.Коды ошибок 40

6.2.Коды валют 41

6.3.Коды стран 43

6.4.Алгоритм вычисления hash-функции 50



1.Введение


Данный документ описывает технические и технологические аспекты подключения нового участника Системы CONTACT для осуществления операций CONTACT в адрес Участника.

Участнику необходимо обеспечить реализацию приведенной в данном документе технологии и реализовать на собственном web-сервере методы, позволяющие выполнить проверку реквизитов платежа на возможность его осуществления и подтверждение факта оплаты платежа в режиме реального времени в момент совершения операций в точке обслуживания клиентов.


2.Основные понятия


Система - Система денежных переводов «CONTACT»

Операционный центр Системы (ОС) – программно-аппаратный комплекс, обеспечивающий техническое взаимодействие с Участниками системы при проведении операций.

Участник – юридическое лицо, партнер Системы, в адрес которого производятся операции.

Плательщик – физическое лицо, инициирующее операцию в адрес Участника

ППП – пункт приема платежа, Участник Системы, обслуживающий физическое лицо.

Идентифицирующая информация – атрибуты платежей, позволяющие идентифицировать платеж в системе Участника. Например Номер заказа, Номер счета и т.д.


3.Процедура подключения


Состоит из нескольких этапов:

3.1.Получение документации,


Для получения документации необходимо прислать на адрес Technology@russlavbank.com в копии курирующему менеджеру письмо с запросом на документацию CONTACN NG Pay. В письме в обязательном порядке должно быть указано наименование организации, ФИО контактного лица и его телефон и адрес электронной почты.

В ответ на это письмо на указанный электронный адрес будет выслана ссылка на интеграционный пакет, содержащий, в том числе и данный документ.


3.2.Согласование условий взаимодействия и разработка


Для полного обеспечения процесса разработки в Системе CONTACT организован тестовый стенд. Участнику выделяется тестовый код, для которого производятся все необходимые настройки.

Для получения Тестового кода необходимо прислать на адрес Technology@russlavbank.com в копии курирующему менеджеру письмо с запросом на получение тестового кода. В письме в обязательном порядке должно быть указано:



  • Полный путь к сервису, который будет вызываться системой контакт на этапе тестирования. Например http://91.144.84.91:8080/contact/contact_ng_pay.php. Указание IP адреса обязательно.

  • Наименование и формат, для всех полей идентифицирующей информации. Если предполагается, что в рабочее режиме будет несколько операций с различным набором идентифицирующей информации, выбирается один набор с набольшим количеством атрибутов.

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

В ответном письме будет предоставлен присвоенный Участнику тестовый код, который будет настроен по представленной информации с возможностью вызова сервиса по предоставленному адресу.

При возникновении вопросов в процессе организации взаимодействия и разработки вопросы необходимо высылать на адрес Technology@russlavbank.com.


3.3.Тестирование

3.3.1.Тестирование шлюза


Производится Участником самостоятельно с использованием ПО Contact NG., которое можно скачать по ссылке https://contact.russlavbank.com/progcont.nsf/ContactNGDistrRU?OpenView.

Там же находится документация.

В случает возникновения вопросов по установке или использованию CONTACT NG вопросы можно задавать технической поддержке на адрес TS@russlavbank.com.

При самостоятельном тестировании необходимо войти в CONTACT NG от имени кода AFXA с логином и паролем admin. При вводе нового платежа необходимо выбрать слева «Платежи в адрес юридических лиц» и в поле код ввести присвоенный тестовый код. И далее выполнять операцию согласно инструкции пользователя.


3.4.Организация рабочего канала связи и осуществление перехода в рабочий режим.


Данный раздел будет предоставлен в следующей версии документа.

4.Порядок технологического взаимодействия


В данном разделе описывается общая технология взаимодействия в момент осуществления платежей.

4.1. Основные параметры шлюза


Параметр

Значение параметра

Транспортный протокол

HTTP/HTTPS

Аутентификация

ЭЦП + идентификатор точки

Параметр HASH-function

Тестовый:

219AFD28-CCC2-4CD7-BBBC-9058F761B1CD

Рабочий параметр предоставляется при переходе в рабочий режим



Формат сообщений

XML

Кодировка

Win 1251

Метод передачи запроса

POST

Пакетный режим

нет

Максимальная длина запроса

10000

Таймаут на стороне OC

40 секунд

4.2.Технология совершения операций


Оплата производится Плательщиком в ППП и состоит из нескольких этапов.

4.2.1.Этап первый. Оформление платежа.


  1. Плательщик сообщает (вводит) в том числе идентифицирующие данные:

  2. В ППП формируется и отправляется ОС запрос на возможность проведения операции.

  3. В случае отсутствия ответа сервера ОС дольше 40 секунд или возврата кода ошибки Плательщик не обслуживается.

  4. ОС осуществляет контроль по правилам Системы на корректность поступившего запроса.

  5. Если контроль не пройден, ОС возвращает в ППП отказ с текстом ошибки.

  6. В случае успешного прохождения входного контроля ОС направляет на сервер Участника (далее - СУ) запрос check. Количество запросов с одинаковыми реквизитами не лимитируется.

  7. СУ возвращает результат обработки запроса check или код ошибки.

  8. В случае отсутствия ответа СУ дольше 40 секунд ОС формирует ответ в ППП о невозможности проведения операции. Плательщик не обслуживается.

  9. В случае получения отрицательного ответа ОС формирует в ППП отрицательный ответ, при этом в точку обслуживания передается текст сообщения об ошибке, переданный участником в ответе на запрос check в атрибуте ERR_TEXT.

  10. В случае успешного выполнения запроса check ОС отправляет в ППП ответ, содержащий, в том числе, содержание тэгов в ответе на запрос check:
    • - Краткое описание деталей платежа



    • - Текст для печати в случае ошибки при оплате.

  1. В случае получения от ОС успешного ответа на запрос check ППП печатает и передает Плательщику заявление на перевод, содержащее идентифицирующую информацию и Краткое описание деталей платежа, в случае необходимости.

4.2.2.Этап второй. Оплата платежа.


  1. Плательщик подтверждает намерение оплатить заказ.

  2. ППП направляет ОС запрос, подтверждающий факт оплаты.

  3. После получения от ППП запроса об осуществлении платежа ОС осуществляет входной контроль.

  4. Если контроль не пройден, ОС возвращает в ППП отказ с текстом ошибки.

  5. В случае успешного прохождения входного контроля ОС направляет на СУ запрос pay

  6. СУ возвращает ОС код результата выполнения запроса pay.

  7. В случае отсутствия ответа СУ дольше 40 секунд ОС формирует ответ в ППП о невозможности проведения операции. Плательщик не обслуживается.

  8. В случае положительного ответа СИ ОС формирует ответ в ППП ответ с подтверждением, что операция совершена и зарегистрирована системой.

  9. В ППП анализируется ответ ОС

  10. В случае отсутствия ответа Плательщику выдается документ, подтверждающий прием денег и содержащий текст, преданный в тэге запроса check.

  11. В случае отрицательного ответа операция не производится, либо, если технически отменить прием денег невозможно, Плательщику выдается чек с подтверждением приема денег и содержащий текст, переданный в тэге запроса check.

  12. В случае положительного ответа Плательщику выдается документ, подтверждающий осуществление платежа. При наличии в ответе на запрос pay Участника информации тэге PaymentInfo клиенту дополнительно распечатывается содержимое данного тэга.

5.Описание методов

5.1.Общие положения


На web-сервере Участника в качестве протокола используется HTTP/HTTPS.

HTTP может использоваться только в случае построения VPN-канала между Участником и Системой, в противном случае используется HTTPS

При этом на web-сервере Участника должен быть установлен действующий SSL-сертификат, выданный одним из доверенных центров сертификации.

Все запросы отправляются на web-сервер Участника с помощью метода POST.

Тело запроса состоит из хэш-кода и xml-запроса.

Хэш-код вычисляется по алгоритму MD5 от xml-запроса + параметра хэш-функции, известного Участнику и Системе.

Ответ на запрос Системы представляет собой так же хэш-код и xml-ответ.

XML-ответ содержит числовой результат выполнения запроса.

Запрос считается успешно обработанным, если результат равен 0.

Если результат не равен 0, то в ответе должно содержаться текстовое сообщение, которое будет передано в пункт приема платежа.

В xml-запросах каждому полю платежа соответствует один тэг.

Возможные типы значений полей:

DATE - Дата в формате YYYYMMDD

INT - целое

MONEY2 - дробное (2 знака после запятой, разделитель точка ".")

MONEY4 - дробное (4 знака после запятой, разделитель точка ".")



STRING - строковое

следующая страница >>