Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- reminder [2024/02/26 16:50] – [Зняття оплати за сервіс нагадувань при ввімкненому сервісі PBI] bobr
+++ reminder [2026/07/04 18:05] (поточний) – [alter.ini опції, що регулюють роботу PBI-інтеграції] bobr
@@ Рядок 94: / Рядок 94: @@
 ====== PrivatBank Invoices ======
-Починаючи з релізу 1.4.4 в Ubilling доступна інтеграція з сервісом "PrivatBank Invoices"(PBI) від ПриватБанку, яка дозволяє відправляти інвойси нашим користувачам і клієнтам ПриватБанку за сумісництвом. Цей сервіс вигідно відрізняється від СМС своєю **безкоштовністю**(принаймі, станом на 1й квартал 2024го). Варто зазначити, що відтепер Ubilling надає як мінімум 3 опції щодо відправлення нагадувань користувачам стосовно **низького балансу**:
+Починаючи з релізу 1.4.4 в Ubilling доступна інтеграція з сервісом "PrivatBank Invoices"(PBI) від ПриватБанку, яка дозволяє відправляти інвойси нашим користувачам і клієнтам ПриватБанку за сумісництвом. Цей сервіс вигідно відрізняється від СМС своєю **безкоштовністю**(принаймі, станом на 1й квартал 2024го). Варто зазначити, що відтепер Ubilling надає як мінімум 3 опції щодо відправлення нагадувань користувачам стосовно **низького балансу**(тобто - за основною послугою):
   * тільки СМС
   * тільки інвойс
@@ Рядок 101: / Рядок 101: @@
 Останні два варіанти реалізовуються за допомогою відповідних, дуже self-explanatory, опцій alter.ini **REMINDER_PBI_ONLY_TAG_ID** та **REMINDER_PBI_AND_SMS_TAG_ID**. \\
 І тут все доволі просто:
-  * якщо користувачу не присвоєний жодний з двох тегів, регламентованих опціями **REMINDER_PBI_ONLY_TAG_ID** та **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлено звичайне СМС
+  * якщо користувачу не присвоєний жодний з двох тегів, регламентованих опціями **REMINDER_PBI_ONLY_TAG_ID** та **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлятися звичайне СМС
-  * якщо користувачу присвоєний тег **REMINDER_PBI_ONLY_TAG_ID** - йому буде відправлено лише інвойс
+  * якщо користувачу присвоєний тег **REMINDER_PBI_ONLY_TAG_ID** - йому буде відправлятися лише інвойс
-  * якщо користувачу присвоєний тег **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлено як інвойс, так і СМС
+  * якщо користувачу присвоєний тег **REMINDER_PBI_AND_SMS_TAG_ID** - йому буде відправлятися як інвойс, так і СМС
 ===== alter.ini опції, що регулюють роботу PBI-інтеграції =====
@@ Рядок 114: / Рядок 114: @@
 REMINDER_PBI_ONLY_TAG_ID=101
 REMINDER_PBI_AND_SMS_TAG_ID=111
+REMINDER_PBI_USE_MONEYLACK=0
+REMINDER_PBI_CONSIDER_VSERVICES_PRICE=0
 REMINDER_PBI_USER_FILTER_PAYSYS_LIST=""
+REMINDER_PBI_PAYMENTID_AS_BILLIDENTIFIER=0
 </code>
-Оскільки майже всі опції вище доволі self-explanatory - детально варто зупинитись, мабуть шо, тільки на останній з них. \\
+Оскільки майже всі опції вище доволі self-explanatory - детально варто зупинитись, мабуть шо, тільки на двох останніх з них. \\
-Отож, опція REMINDER_PBI_USER_FILTER_PAYSYS_LIST задумувалась як така собі відповідь на питання: "А як зрозуміти, хто з наших користувачів є клієнтом ПриватБанку, а хто ні?", і якось нічого кращого не придумалось, як дивитись чи не приходили від конкретно взятого користувача оплати з певних платіжних систем. І, якщо приходили - вважати такого користувача "умовно підходящим" кандидатом на клієнти ПриватБанку. Чому умовно? - ну, тому що не обов'язково бути клієнтом ПриватБанку, або оплатити послугу через термінал ПриватБанку. Отака механіка. Користуватись нею чи ні - кожний вирішить для себе сам. \\
+Отож, опція **REMINDER_PBI_USER_FILTER_PAYSYS_LIST** задумувалась як така собі відповідь на питання: "А як зрозуміти, хто з наших користувачів є клієнтом ПриватБанку, а хто ні?", і якось нічого кращого не придумалось, як дивитись чи не приходили від конкретно взятого користувача оплати з певних платіжних систем. І, якщо приходили - вважати такого користувача "умовно підходящим" кандидатом на клієнти ПриватБанку. Чому умовно? - ну, тому що не обов'язково бути клієнтом ПриватБанку, або оплатити послугу через термінал ПриватБанку. Отака механіка. Користуватись нею чи ні - кожний вирішить для себе сам. \\
 Єдине, що ще варто зазначити: ця опція має містити список платіжних **фронтендів**, які на зараз є активними у вашому біллінгу. Назви платіжних систем мають бути точно такі ж, як і в модулі "OpenPayz"(ага, як правило ще й КАПСОМ), мають розділятися комами і НЕ містити пробілів. \\
-Якщо ж лишаємо цю опцію пустою - ніяких фільтрацій користувачів по платіжним системам відбуватись не буде.
+Якщо ж лишаємо цю опцію пустою - ніяких фільтрацій користувачів по платіжним системам відбуватись не буде. \\
+Опція **REMINDER_PBI_PAYMENTID_AS_BILLIDENTIFIER** дозволяє використовувати платіжний ID користувача як "bill_identifier" в інвойсі, замість стандартно використовуваної угоди користувача. Може приймати 3 значення:
+  * 0 - завжди використовувати поле "Contract"(угода користувача) як "bill_identifier"
+  * 1 - завжди використовувати OPAYZ PaymentID(платіжний ID користувача) як "bill_identifier"
+  * 2 - використовувати PaymentID як "bill_identifier" лише в тому випадку, якщо поле "Contract" для певного користувача порожнє
 ===== ОБОВ'ЯЗКОВІ додаткові налаштування =====
 Ще раз робимо акцент на тому, що PBI-інтеграція таки працює на базі модулю "Reminder" - тобто у вас, як мінімум має бути включеним і налаштованим функціонал нагадувань(просто читаємо цю статтю від початку до кінця). Так, як мінімум має буть **REMINDER_ENABLED=1**, а також вказаний **REMINDER_TAGID** та **REMINDER_DAYS_THRESHOLD**. \\
@@ Рядок 159: / Рядок 166: @@
 </code>
 </hidden>
 \\
 ===== Зняття оплати за сервіс нагадувань при ввімкненому сервісі PBI =====