===== Privat работа с выписками =====

===Схема подключения===
1) По ссылке https://link.privatbank.ua/console/auth/start проходите авторизацию, после чего создаете "Приложение" и получаете ClientID + ClientSecret.

После авторизации видим свой кабинет:

{{:abills:docs:modules:paysys:p24_api_autorization.png|}}

Нажимаем кнопку Добавить справа и переходим на страницу создания приложения:

{{:abills:docs:modules:paysys:p24_api_payment_app.png|}}

Добавляем. Оно появится на главной странице справа. Перейдем на него и увидим нужные нам данные: ClientID и ClientSecret: 

{{:abills:docs:modules:paysys:p24_api_app_data.png|}}


2) В файле ''/urs/abills/libexec/config.pl'' прописываем нужные нам настройки:
^ $conf{PAYSYS_P24_API_CLIENT_ID}='6ba20fc9-1470-45e3-bd3a-48c2c6aa8a88'; | Обязательный параметр. ClientID с созданного приложения|
^ $conf{PAYSYS_P24_API_SECRET}='37f74a6170bfa3dddf428b0033961f4a'; | Обязательный параметр. ClientSecret с созданного приложения |
^ $conf{PAYSYS_P24_API_ACCOUNT_KEY}='CONTRACT_ID'; | Не обязательный параметр. Ключ по которому будет проводиться оплата. По умолчанию UID |
^ $conf{PAYSYS_P24_API_PARSE}='\: (\d+)\.$';| Не обязательный параметр. Поможет вытянуть из назначения платежа идентификатор абонента. Нужно лишь задать верное регулярное выражение. |
^ $conf{PAYSYS_P24_API_FILTER}='Liqpay\:'; | Не обязательный параметр. Фильтрует выписки по регулярному выражению, проверяется коментарий к оплате.|
^ $conf{PAYSYS_P24_API_DEBUG_FILE}='/usr/abills/xml_p.xml'; | Не обязательный параметр. Можно подгрузить данные с файла для дебага. |
^ $conf{PAYSYS_P24_API_NEW_SCHEME_DATE}='2018-01-10'; | Не обязательный параметр. Только для старых пользователей которые уже были подключены. Переход на новую схему оплаты, через 'refp', а не через 'TRAN_ID'. |

3) Файл модуля **P24_api.pm** копируем в папку ''/usr/abills/Abills/modules/Paysys/systems/''.

4) После этого в меню ///Отчет/Paysys/// появится новый пункт меню **P24 Application** в котором и происходит работа с выписками.

==== Работа с выписками ====
Заходим в меню ''/Отчет/Paysys/P24 Appilication''

Мы увидим шаблон авторизации, где вводим логин и пароль.

{{:abills:docs:modules:paysys:p24_api_login.png|}}

Нажимаем кнопку **Отправить**.

Далее могут быть следующие шаги:

1) Если больше, чем один номер телефона, то нужно выбрать с помощью которого производить вход.(Необязательный шаг)

2) Нужно подтвердить вход отправкой ОТП кода.(Необязательный шаг)

3) Увидим таблицу со списком выписок.
 

----


=== Первый шаг===


=== Второй шаг ===

=== Третий шаг ===
Работа с выписками.

{{:abills:docs:modules:paysys:p24_api_table.png|}}


====== Автоматический импорт выписок ======
Добавлена возможность проводить периодический импорт выписок в биллинг с P24 для юридических лиц. Для этого должен быть подключен сам модуль выписок.

Дополнительные параметры для ''config.pl''

^ $conf{PAYSYS_P24_API_PERIODIC}=1;| Включение опции переодического импрта |
^ $conf{PAYSYS_P24_API_PERIODIC_INFO}='SCHET:ID:TOKEN;SCHET:ID:TOKEN,'; | Данные приложения созданного в привате. |

Запуск скрипта автоимпортирования выписок в биллинг:
  /usr/abills/libexec/periodic daily MODULES=Paysys
  
[[https://docs.google.com/document/d/e/2PACX-1vTtKvGa3P4E-lDqLg3bHRF6Wi9S7GIjSMFEFxII5qQZBGxuTXs25hQNiUU1hMZQhOyx6BNvIZ1bVKSr/pub|Документация на 14.06.2018]]