Типы пополнения: терминалы оплаты
Основаный в 1992 году, коммерческий банк ПриватБанк является одним из наиболее динамично развивающихся банков Украины и занимает лидирующие позиции банковского рейтинга страны. В 2007-м году Global Finance четвертый год подряд признает ПриватБанк лучшим банком
В ходе исследования рынка банковских услуг, проведенного компанией GFK Ukraine, 23,3% опрошенных жителей Украины назвали ПриватБанк наиболее привлекательным для себя украинским банком. ПриватБанк также имеет наиболее высокий уровень узнаваемости среди населения без подсказки: 64%. ПриватБанк также является лидером среди украинских коммерческих банков по количеству клиентов: его услугами пользуется свыше 23% населения Украины.
Внедряя новые виды банковских услуг и постоянно совершенствуя комплекс банковского обслуживания, на начало 2008 года банк обслуживал 260 тысяч корпоративных клиентов, частных предпринимателей - 245 тысяч и свыше 15 миллионов счетов физических лиц. Объем привлеченных банком средств юридических лиц на 1 января 2008 года составляет 10,2 млрд. грн. Объем средств физических лиц, привлеченных ПриватБанком на 1 января 2008 года составляет 23 млрд. грн. (наибольший показатель среди всех украинских банков), в том числе депозитный портфель физлиц - 17,66 млрд. грн.
Установка
Для работы системы нужен модуль Perl JSON
Настройка личного кабинета ПриватБанк
В поля:
вводим адрес https://АДРЕС_СЕРВЕРА:ПОРТ/paysys_check.cgi
Коды ошибок
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 как идентификатор пользователя. |
---|
Типы пополнения: веб портал абонента
Пополнение счёта используя Master/Visa Cards.
$conf{PAYSYS_PB_MERID} | Выданный вам банком ID предприятия |
---|---|
$conf{PAYSYS_PB_PW} | Пароль на транзакцию |
Типы пополнения: веб портал абонента
Возможности:
В кабинете Приват 24 нужно настроить мерчанта
шаг 1. Укажите IP адрес Вашей билинг сервера
шаг 2.
шаг 3.
Для работы системы Privat24 в режимео получения выписок установить программу 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 | Отключает отображение функции в клиентском кабинете. Работа с выписками будет работать. |
Тип пополнения: терминалы, касса
Для работы понадобиться модуль:
$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 страницы для быстрой оплаты |
$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 |
4й и 5й пункты не обязательны. 7й пункт должен заполнить провайдер.