Различия

Здесь показаны различия между двумя версиями данной страницы.

--- abills:docs:modules:paysys:privatbank [2014/08/11 14:33]
sinner создано
+++ abills:docs:modules:paysys:privatbank [2017/09/26 16:59] (текущий)
andriy [Privat Bank - Privat 24]
@@ Строка 1: / Строка 1: @@
+=====Приват банк======
+**Типы пополнения:** терминалы оплаты\\
+{{:abills:docs:modules:paysys:privat_bank_-_privat_24-logo.png?200|}}
+[[http://privatbank.ua/]]\\
+Основаный в 1992 году, коммерческий банк ПриватБанк является одним из наиболее динамично развивающихся банков Украины и занимает лидирующие позиции банковского рейтинга страны. В 2007-м году Global Finance четвертый год подряд признает ПриватБанк лучшим банком
+В ходе исследования рынка банковских услуг, проведенного компанией GFK Ukraine, 23,3% опрошенных жителей Украины назвали ПриватБанк наиболее привлекательным для себя украинским банком. ПриватБанк также имеет наиболее высокий уровень узнаваемости среди населения без подсказки: 64%. ПриватБанк также является лидером среди украинских коммерческих банков по количеству клиентов: его услугами пользуется свыше 23% населения Украины.
+Внедряя новые виды банковских услуг и постоянно совершенствуя комплекс банковского обслуживания, на начало 2008 года банк обслуживал 260 тысяч корпоративных клиентов, частных предпринимателей - 245 тысяч и свыше 15 миллионов счетов физических лиц. Объем привлеченных банком средств юридических лиц на 1 января 2008 года составляет 10,2 млрд. грн. Объем средств физических лиц, привлеченных ПриватБанком на 1 января 2008 года составляет 23 млрд. грн. (наибольший показатель среди всех украинских банков), в том числе депозитный портфель физлиц - 17,66 млрд. грн.\\
+**Установка**\\
+Для работы системы нужен модуль [[abills:docs:manual:soft:JSON|Perl JSON]]\\
+**Настройка личного кабинета ПриватБанк**\\
+В поля:
+  * Redirect успешной оплаты,
+  * Redirect неуспешной оплаты,
+  * Redirect при ошибке,
+  * Request API успешный,
+  * Request API неуспешный
+вводим адрес **[[https://АДРЕС_СЕРВЕРА:ПОРТ/paysys_check.cgi]]**\\
+{{ :abills:docs:modules:paysys:json_pay.png?600 |}}
+\\
+**Коды ошибок**\\
+, ок
+, Неизвестный тип запроса
+, Абонент не найден
+, Неверная сумма платежа
+, Неверное значение номера платежа
+, Внутренняя ошибка Поставщика
+, Платеж с таким номером не найден
+, Дублирование платежа
+**API**\\
+\\
+**Процедура проверки - запрос CHECK**\\
+Необходимые данные:\\
+  action -- всегда "check"
+  user_id -- номер договора пользователя
+  amount -- сумма от 5 до 5000 грн
+\\
+Пример:\\
+  {"action": "check", "user_id": 1234, "amount": 5.25}
+\\
+Ответ в случае успеха:\\
+  {"error": 0, "message": "Сообщение об успешной операции"}
+\\
+Ответ в случае провала:\\
+  {"error": x, "message": "Сообщение об возникновении ошибки" }, где x код ошибки.
+\\
+**Процедура оплаты - запрос PAY**\\
+Необходимые данные:\\
+  action -- всегда "pay"
+  user_id -- номер договора пользователя
+  amount -- сумма от 5 до 5000 грн
+  txn_id -- уникальный id транзацкции в системе ПриватБанка
+\\
+Пример:
+  {"action": "pay", "user_id": 1234, "amount": 5.25, "txn_id": "24321343214"}
+\\
+Ответ в случае успеха:\\
+  {"error": 0, "result_txn_id": 32132, "message": 'Сообщение об успешной операции'}
+  result_txn_id -- id транзацкции в системе Клиента
+\\
+Ответ в случае провала:\\
+  {"error": x, "message": "Сообщение об возникновении ошибки"}, где x код ошибки
+\\
+Ответ в случае дублирования платежа:\\
+  {"error": 7, "result_txn_id": 12343, "txn_id": 4343, "message": "Сообщение об возникшей ошибке"}
+  txn_id -- уникальный id транзацкции в системе ПриватБанка
+  result_txn_id -- id транзацкции в системе Клиента
+\\
+**config.pl**
+^$conf{PAYSYS_PRIVATE_JSON_ACCOUNT_KEY}='UID'; | Поле для идентификации пользователя по параметру PAY_ACCOUNT терминальной системы Приват банка. В качестве поля для идентификации может использоваться любое поле персональной информации о пользователе. Если поле меньше шести символов, его нужно дополнить спереди нулями при в воде в терминал. По умолчанию используется UID как идентификатор пользователя.  |
 =====Privat Bank (Master/Visa Cards)=====
 **Типы пополнения:** веб портал абонента\\
@@ Строка 18: / Строка 111: @@
   * Пополнение личного счёта с личного кабинета
   * Контроль счёта(ов) провайдера через биллинг. Получение выписок и зачисление их на счёт.
+  * [[abills:docs:manual:admin:paysys:paysys_p24|Интерфейс работы с оплатами через Privat24 API]]
-**Настройка** \\
+===Настройка===
 В кабинете Приват 24 нужно настроить мерчанта\\
@@ Строка 38: / Строка 132: @@
 ^ $conf{PAYSYS_P24_EXPR}='CONTRACT_ID:.+договор № (\d+).+'; | Выражение для автоматического определение плательщика. Первый параметры **CONTRACT_ID:** поле в билинге, данные после двоеточия само выражение. Данный параметр используется в случае когда провайдер хочет получить выгрузку оплат и по ней сформировать платежи |
 ^$conf{PAYSYS_P24_COMMISSION}='1.0'; | Сума дополнительной комиссии которая снимается с абонента при оплате этой системой. Сума может указываться как в денежных единицах так и в процентном соотношении сумы оплаты. При указании процентного соотношения обязательно в конце указывать знак процента % |
+^$conf{PAYSYS_P24_SKIP_PORTAL}=1 | Отключает отображение функции в клиентском кабинете. Работа с выписками будет работать.|
+=====Privat Bank - Платежи  онлайн (Privat terminal)=====
-=====Privat Bank - Платежи  онлайн=====
 **Тип пополнения: терминалы, касса**
@@ Строка 48: / Строка 141: @@
 Для работы понадобиться модуль:
-  * [[http://search.cpan.org/dist/XML-Simple/|XML::Simple]] ([[abills:docs:manual:soft:xml|установка]]).
+  * [[abills:docs:manual:soft:JSON|XML::Simple]].
@@ Строка 57: / Строка 150: @@
 |$conf{PAYSYS_PRIVAT_TERMINAL_NAME}='Name';| Название организации |
 |$conf{PAYSYS_PRIVAT_TERMINAL_ACCOUNT}='11';| Номер банковского счета |
+|$conf{PAYSYS_PRIVAT_TERMINAL_SERVICE_CODE}='101'; | Номер услуги. В ответе параметр ''serviceCode="101"'' |
+|$conf{PAYSYS_PRIVAT_TERMINAL_FAST_PAY}='link' | URL страницы для быстрой оплаты |
+=== Оплата через клиентский кабинет с помощью модуля Privat terminal ===
+|$conf{PAYSYS_PRIVAT_TERMINAL_FAST_PAY}='link' | URL страницы для быстрой оплаты |
+Этот URL можно получить по этим контактам:  bmp@privatbank.ua, тел (056)716-38-48, чат: privatbank.ua/bmp
 **Идентификатор аккаунта абонента //bill_identifier//**
@@ Строка 77: / Строка 178: @@
   Check
   Cancel
+  Upload
+  Presearch
-\\
+====Разделение реквизитов по группам====
+Для каждой группы абонентов можно создать свои реквизиты для работы с платёжной системой, для этого нужно указать параметры платёжной системы с суффиксом в виде номера группы. Если для группы не задан параметр используется группа по умолчанию. Обязательно создайте группу по умолчанию.
+**Пример** \\
+для группы 3
+  $conf{PAYSYS_PRIVAT_TERMINAL_MFO_3}='234234234234';
+  $conf{PAYSYS_PRIVAT_TERMINAL_NAME_3}='Company name';
+==== Хосты системы ====
+| 75.101.163.115  |
+| 107.22.173.15  |
+| 107.22.173.86  |
+| 54.229.105.178 |
+| 54.229.105.179 |
+==== Пример заполнение анкеты от Privatbank ====
+{{ :abills:docs:modules:paysys:index.docx | Пример}}
+**4й и 5й пункты не обязательны. 7й пункт должен заполнить провайдер.**