====== Терминалы CityPay======

[[billing:preferences:payment_system:payment_system|Вернуться на уровень выше]]


{{:billing:preferences:payment_system:citypay.jpg?nolink&|}}

[[http://city-pay.com.ua/|Сайт сети терминалов CityPay]]

===== Пример заявки на подключение провайдера =====

|Полное название протокола, по которому ведется работа:| Protocol_City-Pay_v.3.03.02|
|URL на который будут посылаться запросы (обязательно https) :| https://admin.ispnet.demo/ajax/index/citypay |
|Тестовый аккаунт:|указать тестовый uid и логин |
|Минимальная сумма платежа:| 1 |
|Максимальная сумма платежа:| 100000 |
|Формат ввода аккаунта: ||
|Кол-во символов (от-до)| 2-32|
|Какие символы допускаются (цифры, буквы, все символы)|все символы|
|Что значит аккаунт (№ договора, ID, ИНН)|UID или Логин |
|Использование сертификата (да или нет):| Да|
|Поддержка механизма отмены платежей (да или нет):| нет|
|Поддержка механизма автоматической сверки (да или нет):| нет|
|Логин для базовой аутентификации (опционально):| нет|
|Пароль для базовой аутентификации (опционально):| нет|
|Дополнительные данные от провайдера (опционально):| |

| URL|вида https://admin.ispnet.demo/ajax/index/citypay |
Пояснение
<note important>"Server URL" Обязательно должен быть внешним доменом!</note>
<note tip>Не забываем заменить "admin.ispnet.demo" на свой Внешний домен, который доступен из интернет.</note>
<note warning>http или https несущественно, главное чтобы по этой ссылке(https://admin.ispnet.demo) вы могли попадать в админку из интернета.</note>

===== Услуги (с 2.7.23) =====

Услуга, для пополнения счета, может быть 3-х видов:
  * пополнение по номеру UID абонента
  * по логину абонента
  * по № договора абонента

В данной платёжной системе реализована система алгоритмического поиска абонентов, с которой рекомендуем ознакомиться по ссылке ниже:
\\ [[mikbill:настройки:алгоритм_поиска_абонентов|]]

Поиск и оплата происходит для основных групп пользователей: обычный (базовый) и замороженный. 

В зависимости от того в каком виде будет получен запрос, сервер MikBill автоматически его обработает, настроек не требует.


===== Отображение данных на терминале =====

В ответ на check запрос в случае обнаружения абонента будут отправлены следующие "дополнительные" поля:
<code XML><Response>
.....
<Fields>
<field1 name="fio">Иванов И.И.</field1>
<field2 name="deposit">32.88</field2>
<field3 name="pay_recomend">22.12</field3>
</Fields>
.....
</Response></code>

^ Поле ^ Значение ^
| fio | ФИО найденного абонента |
| deposit | депозит абонента |
| pay_recomend | рекомендованная сумма к оплате |


===== Настройка MikBill =====


{{:billing:preferences:payment_system:citypay_sysopt.png?direct&400|}}

<note tip>Не забываем отметить "Разрешить".</note>


Указываем Подсети.
<note tip>В примере указаны подсети которые были актуальны на момент написания поддержки данной системы:
\\ 1) 78.30.232.14/32 - это тестовый
\\ 2) 91.105.201.38/32 - это рабочий
\\ 3) 77.120.96.58/32 - резервный сервер</note>
<note important>Не оставляйте поля подсети пустыми - укажите  2 одинаковых значения если вдруг дадут всего 1 IP</note>

<note warning>IP адрес и подсеть - разные вещи. Отличаются, с виду, они наличием маски. 
\\ IP адрес: 1.1.1.1, подсеть - 1.1.1.1/24.
\\ Не забывайте ставить маску.</note>

Укажите % отчислений - необходимо для отчетности.



Все настройка закончена.

====== Настройки для субпровайдера ======
[[billing:preferences:payment_system:sub_provider|Подробней тут]]