Формування одноразових платіжних посилань для оплати рахунку через Службу Платежів

Для задоволення потреб клієнтів, які займаються онлайн-торгівлею, існує інструмент, що дозволяє приймати оплату картками через додаток службу платежів (MONOBANK, LiqPay, UPC). По замовленню продажу формуються одноразові платіжні посилання.

Одноразове платіжне посилання – разовий інвойс із даними, який можна надіслати клієнту в месенджері, електронною поштою або іншим зручним способом. Перейшовши за посиланням, покупець побачить дані замовлення, йому залишається лише ввести свої карткові дані та підтвердити операцію. В свою чергу користувач отримує підтвердження від банку, що платіж успішно виконано, і на підставі цього можна відвантажувати товар, не очікуючи рознесення банківської виписки фінансовим відділом. За необхідності існує можливість формувати та обліковувати операцію Платіж по успішній транзакції.

Налаштування

Перед використанням функціоналу одноразових платіжних посилань, треба виконати ряд налаштувань системи:

1. Створити відповідний запис в Службі платежів.

Система запропонує обрати Тип служби платежів - LiqPay Payment Service, Monobank Payment Service або UPC e-Commerce Payments service.

Назва поля	Роз'яснення
Назва, Опис	Вказати коротку назву та опис Служби платежів
Відкритий ключ (для налаштувань LiqPay)	Ідентифікатор створеної компанії в LiqPay
Приватний ключ (для налаштувань LiqPay)	Цифровий ключ для шифрування даних з налаштувань LiqPay
Ідентифікатор терміналу	Ідентифікатор терміналу для налаштувань UPC
Ідентифікатор торговця	Ідентифікатор торговця для налаштувань UPC
Токен з особистого кабінету (для налаштувань MONOBANK)	Ідентифікатор створеної компанії в MONOBANK
Включено	Виставити ознаку для того щоб Служба платежів стала доступною для використання
Завжди включати в документи	Виставити ознаку, якщо потрібно щоб ця Служба платежів завжди автоматично прописувалася в замовленнях продажу
ISO цифровий код локальної валюти	Вказати код локальної валюти в ISO
Тип оплати	Обрати Дебет, або Утримання - в залежності від того, як саме повинна списуватися сума з картки платника - списуватися одразу, чи утримуватися банком до фіналізації зі сторони користувача
Термін дії платежу (сек)	Встановити термін, протягом якого буде дійсним одноразове платіжне доручення (для UPC термін вказується в днях)
Логотип	За необхідності можна додати логотип
Назва шаблону журналу	Вказати назву шаблону Фінансового журналу, що буде використовуватися для формування платежів по успішним транзакціям
Назва розділу журналу	Вказати назву розділу Фінансового журналу, що буде використовуватися для формування платежів по успішним транзакціям

2. В Налаштуванні Модуля Продажів за необхідності виставити ознаку Створювати платежі для транзакцій в статусі Утримання - якщо ознаку встановлено - то окрема періодична операція буде формувати та обліковувати платежі і по транзакціям в статусі Утримання.
3. В Налаштуванні Модуля Продажів встановити значення поля Контролювати номер телефону по коду Країни/Регіону=ТАК
4. На сторінці Країни/Регіони заповнити поле Маска номеру телефону - для цього використовується специфічний регулярний вираз. Наприклад, для України: ^\+380\d9$

Примітка: Якщо значення поля Контролювати номер телефону по коду Країни/Регіону=ТАК в Налаштуванні Модуля Продажів, то при заповненні полів Телефон та Мобільний телефон на картці клієнта, в Замовленні продажу, Сервісному замовленні система звіряє формат введених даних з форматом, що вказаний в новому полі "Маска номеру телефону" в таблиці Країн/Регіонів. При формуванні транзакції служби платежів UPC формат автоматично змінюється на +38-0XX-XXX-XXXX.

Створення платіжного посилання та робота з транзакціями

Після того, як було виконано налаштування Служби Платежів, можна створити платіжне посилання до Замовлення продажу або Сервісного замовлення.

1. Створюється Замовлення продажу (Сервісне замовлення).
2. В Замовленні продажу обирається Служба платежів, через яку буде здійснюватися оплата.
3. Якщо необхідно, в Замовленні продажу обирається Аванс % або Фіксована Сума Передплати (SMART Платіж), який потрібно оплатити перед тим, як замовлення буде відвантажено.
4. Замовлення випускається.
5. По події Створити SMART Платіж - формується запис в таблиці транзакцій (Транзакції MonoBank, Транзакції LiqPay, Транзакції UPC). Формується посилання платіжної служби, по якому можна сплатити рахунок, на повну суму замовлення, або на відсоток від цієї суми (фіксовану суму) в залежності від налаштувань по замовленню.
6. В факт-боксі до замовлення можна побачити наступну інформацію по створеній транзакції:
   • Статус - статус платежу.
   • Сума - сума, на яку сформовано платіжне посилання.
   • Посилання на оплату - саме посилання, яке можна скопіювати, або перейти по ньому та сплатити.
   • Дата закінчення терміну дії - термін дії платіжного посилання формується на основі налаштувань API для обміну даними з платіжними сервісами.
7. З факт-боксу можна виконати наступні дії з платіжними посиланнями:
   • Показати більше інформації – перейти до сторінки з транзакціями.
   • Оновити статус – зв’язатися з платіжним сервісом та поза розкладом оновити статус та платіжну інформацію по платежу.
   • Скасувати інвойс - відмінити платіж, якщо він ще не в статусі Сплачено (Успішно або Утримання) (для UPC недоступно).
   • Фіналізувати суму – фіналізувати суму платежу, якщо вона в статусі Утримання (для UPC недоступно).
8. Після оплати статус транзакції змінюється на Успішно (або Утримання) і по Замовленню продажу можна створити відвантаження.

Примітка: для служби платежів UPC не існує можливості скасувати створений SMART Платіж з ВС, але можна відмінити транзакцію на порталі продавця. Після цього оновити статус транзакції в ВС періодичним завданням або вручну. Після оновлення статусу з'явиться можливість змінити дані в замовленні та створити новий SMART Платіж з оновленими даними.

Оновлення статусу по транзакціям Служб платежів

З періодичністю 20 хвилин періодичне завдання Управління платіжними посиланнями оновлює статус та іншу платіжну інформацію по транзакціям Служб платежів. Автоматично заповнюється поле "Дата зміни статусу" як дата, коли надійшла оплата.

До моменту, поки не буде прийнято оплату по платіжному посиланню, і воно не перейде в статус Успішно або Утримання - Облікувати або створити Складське Відвантаження по замовленню неможливо.

Для Служби платежів, в якій Тип оплати = Утримання, транзакція спершу набуває статусу Утримання. Фіналізація суми відбувається наступним чином:

• автоматично в момент Обліку замовлення продажу, або вручну по функції Фіналізувати суму з факт-боксу Замовлення продажу
• зі сторінки транзакцій служб платежів (Транзакції MonoBank, Транзакції LiqPay) по функції Фіналізувати суму.

Якщо по Замовленню продажу виставлено Аванс% або Фіксована сума передплати (SMART Платіж), то в момент заміни статусу транзакції служби платежів на Успішно або Утримання також відбувається оновлення статусу Замовлення продажу з Очікування передоплати на Випущено.

В момент коли замовлення стане доступним для подальшої обробки, значення поля Оплата прийнята (SMART Платіж) на сторінці Замовлення на продаж - список прийме значення "Так".

Формування платежів по успішним транзакціям

Операції Платежів по успішним транзакціям можуть бути сформовані за допомогою періодичної операції. Для того, щоб її запустити необхідно:

1. Відкрити Операції черги робіт.
2. Створити новий запис.
3. Обрати наступні значення.
   • Тип об'єкту, що запускається - Codeunit
   • Номер об'єкту - 70860404
   • Рядок параметра - CreateGenJnlPayments
4. Налаштувати періодичність повтору операції.

Періодична операція буде діяти наступним чином:

• Перевіряти чи існує запис в Транзакціях Служб платежів, для яких статус = Успіх та значення Платіж створено = НІ.

  Примітка: якщо в Налаштуваннях Модуля Продажів вказано ознаку Створювати платежі для транзакцій в статусі Утримання, то враховуються також і транзакції в статусі Утримання.

• Створювати для знайдених транзакції рядок фін. журналу, в шаблоні та розділі, що вказані в Налаштуваннях Служби платежів на суму транзакції.
• Дата обліку для платежу буде відповідати значенню "Дата зміни статуса" з транзакції SMART Платежу.
• Для платежів, які створюються на підставі успішних транзакцій UPC та Monobank, в рядку фін. журналу значення поля Номер зовнішнього документу заповниться значенням поля Rrn з транзакції SMART Платежу.
• Застосовувати як передплату до замовлення.
• Обліковувати рядок Фінансового журналу.

  Примітка: облік рядка фін. журналу виконується від імені користувача, який створив транзакцію SMART Платежу. Це потрібно для коректної роботи функціоналу в парі з розширенням SMART E-Receipt.