Общая информация

ПараметрЗначение
Протокол

http://demo.platezhka.com.ua:8081/InterfaceDocumentation

https://docs.google.com/document/d/1PQUiDnyZ7rMZ0wggIETbEyEF2xH3usKCuPxgZX9dPM4/

ID85
Версия модуля8.xx
Версия биллинга>0.94.xx
IPs62.149.8.166,82.207.125.57,62.149.15.210,212.42.94.154,212.42.94.131,89.184.66.69,194.183.172.218,77.120.96.58
Тип платежной системыоплата через терминалы и кабинет абонента

Настройки модуля

  1. Скопировать файл City24.pm в папку /usr/abills/Abills/modules/Paysys/Plugins/
  2. Зайти в меню Настройки>Paysys>Настройки

  3. Добавить платежную систему

ПараметрЗначениеПример
PAYSYS_CITY24_ACCOUNT_KEYПараметр по которому будет сверка идентификатора абонентаUID
PAYSYS_CITY24_LOGINЛогин который передали City24abills
PAYSYS_CITY24_PASSWORDПароль который передали City24abills_password
PAYSYS_CITY24_GID_SHOW

При включенном параметре добавляет к ответу check

<field3 name="SubProviderId">Группа абонента</field3>

1 - включить

0 - включить

PAYSYS_CITY24_SUBPROVIDER_IDID провайдера в системе City24. Будет подставлять вместо группы в тег SubProviderId.111
PAYSYS_CITY24_FAST_PAYurl перехода на страницу оплаты с портала абонента.https://city24.ua/ua/popolnit-internet/lanet
PAYSYS_CITY24_SPLIT_RULES

Настройка мерчантов, на которые необходимо производить расщепление платежей.

merchantId:percent;merchantId_2:percent_2...merchantId_X:percent_X

12:30;21:70;
PAYSYS_CITY24_DESCRIPTIONОписание абонентуоплата за інтернет послуги
PAYSYS_CITY24_CUSTOM_FIELDS

Возвращать собственные параметры в City24, отличные от ФИО, депозита и адреса.

Изменения в динамическом формате не проходят перед заполнением опции, просьба обратиться в City24, что будет изменен блок fields в ответе и какие поля будут возвращаться в новых настройках

fio:FIO;balance:DEPOSIT;address:ADDRESS_FULL;familnyj_payment_amount:RECOMENDED_PAY



Ответ от биллинга будет в формате 

  <fields>
    <field1 name="fio">C**l us*r</field1>
    <field2 name="balance">50.28</field2>
    <field3 name="address">Kyiv, Franka 15, 2</field3>
    <field4 name="familnyj_payment_amount">150.00</field4>
  </fields>


Расщепление платежей

В настройках контрагента опция:

PAYSYS_CITY24_SPLIT_RULES

Настройка мерчантов, на которые необходимо производить расщепление платежей.

merchantId:percent;merchantId_2:percent_2...merchantId_X:percent_X

Что такое merchantId?

12:30;21:70;

Как поступают платежи в биллинг?

Каждый расщепленный платеж поступает отдельно в биллинг!!!


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

Главные параметры, которые необходимо передать это URL, логин сервиса и пароль сервиса.

ПараметрЗначениеПример
URL - Обязательноhttp(s)://IP-биллинга:порт/paysys_check.cgihttps://demo.abills.net.ua:9443/paysys_check.cgi
логин - ОбязательноЛогин в системе City24, по которому будет авторизоваться в скрипте paysys_check.cgi. Любое значение, можно назва компанииabills
пароль - Обязательно

Пароль в системе City24, по которому будет авторизоваться в скрипте paysys_check.cgi. Любое значение, можно сгенерировать случайные значения

https://www.lastpass.com/features/password-generator

abills_password
ID провайдера в биллингеНеобходимо, если больше одного ФЛП или компании в биллинге, присваивается число, по Вашему выбору, оно будет только вливать на ответ биллинга куда будут начисляться средства111

Тестирование в песочнице City24

Тестирование проводить с помощью песочницы City24 - http://demo.platezhka.com.ua:8081/.

Левую часть формы Валидация заполняем необходимыми параметрами: URL, логин, пароль, UID или другой указанный параметр для сверки идентификатора абонента (заполняются два последних поля).

При успешной валидации должны получить в ответе поле result=0. В случае получения другого значения смотреть коды ошибок в протоколе.

Показать платежную систему в кабинете пользователя

Зайти в меню Настройки>Paysys>Настройки контрагента (Выбор настроек для групп в кабинете абонента)   Поставить галочку для групп, которые будут совершать оплату данной платежной системой

Подробнее можно прочитать здесь

В портале абонента появиться кнопка оплаты данной платежной системы.