=====Приват банк====== **Типы пополнения:** терминалы оплаты\\ {{: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 |}} \\ **Коды ошибок**\\ 0, ок 1, Неизвестный тип запроса 2, Абонент не найден 3, Неверная сумма платежа 4, Неверное значение номера платежа 5, Внутренняя ошибка Поставщика 6, Платеж с таким номером не найден 7, Дублирование платежа **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)===== **Типы пополнения:** веб портал абонента\\ [[http://privatbank.ua|Privatbank]] Пополнение счёта используя Master/Visa Cards. ^ $conf{PAYSYS_PB_MERID} | Выданный вам банком ID предприятия | ^ $conf{PAYSYS_PB_PW} | Пароль на транзакцию | =====Privat Bank - Privat 24===== **Типы пополнения:** веб портал абонента\\ **Возможности:**\\ * Пополнение личного счёта с личного кабинета * Контроль счёта(ов) провайдера через биллинг. Получение выписок и зачисление их на счёт. * [[abills:docs:manual:admin:paysys:paysys_p24|Интерфейс работы с оплатами через Privat24 API]] ===Настройка=== В кабинете Приват 24 нужно настроить мерчанта\\ шаг 1. Укажите IP адрес Вашей билинг сервера {{:abills:docs:modules:paysys:1.gif|}}\\ шаг 2. {{:abills:docs:modules:paysys:2.gif|}}\\ шаг 3. {{:abills:docs:modules:paysys:3.gif|}} Для работы системы Privat24 в режимео получения выписок установить программу [[abills:docs:manual:soft:curl:ru|curl]] Параметры конфигурации ^ $conf{PAYSYS_P24_MERCHANT_ID}='23423'; | Номер мерчанта. Задаётся на шаге 3, поле **ID** | ^ $conf{PAYSYS_P24_MERCHANT_PASS}='pass'; | Пароль для мерчанта. Задаётся на шаге 3. | ^ $conf{PAYSYS_P24_MERCHANT_CURRENCY}='USD'; | Валюта платежей ( по умолчанию USD) | ^ $conf{PAYSYS_P24_CARDNUM}='111121211211328'; | Номер кредитной карты мерчанта | ^ $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)===== **Тип пополнения: терминалы, касса** Для работы понадобиться модуль: * [[abills:docs:manual:soft:JSON|XML::Simple]]. |$conf{PAYSYS_PRIVAT_TERMINAL_ACCOUNT_KEY}='UID';|Тип идентификатора абонента. UID, LOGIN, FIO, PHONE | |$conf{PAYSYS_PRIVAT_TERMINAL_MFO}='11'; | МФО организации | |$conf{PAYSYS_PRIVAT_TERMINAL_OKPO}='11';| ОКПО организации | |$conf{PAYSYS_PRIVAT_TERMINAL_CODE}='11';| Код оператора связи. По умолчанию можно использовать Ваш код ОКПО | |$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//** \\ **Заполнение анкеты приват банка** \\ ^2. Адрес Шлюза, используемый для приема on-line запросов | https:/хост:9443/paysys_check.cgi | ^3. Клиентский SSL сертификат X.509 [1] | не нужно | ^4. Пароль к SSL сертификату[6] | нет | ^5. Тестовый идентификатор [2] | логин для проведения тестовой оплаты или другой иной идентификатор по которому будет определяться абонент. Тип параметра по которому определяется абонент указывается в этой переменной **$conf{PAYSYS_PRIVAT_TERMINAL_ACCOUNT_KEY}** | Тестовые действия Search Pay 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й пункт должен заполнить провайдер.**