> For the complete documentation index, see [llms.txt](https://docs.merchant.alb.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.merchant.alb.ua/platizhni-vidzheti-dlya-cms/whmcs/funkcional.md).

# Функціонал

## #Виконання оплати :

На сайті після того, як були обрані товари, та перейшли на етап оплати, можна обрати метод оплати "AllaincePay Bank"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FPXBHH7bRed5frSR7TsdM%2Fimage.png?alt=media&amp;token=2b9d64bc-1552-47a5-a306-71d75fcafef3" alt=""><figcaption></figcaption></figure>

Платіжна сторінка матиме вигляд :&#x20;

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2F8PZ0aHTWRSRx1VjB7Bx2%2Fimage.png?alt=media&amp;token=31d39d31-835c-494c-aa76-446bb2e734d3" alt=""><figcaption></figcaption></figure>

## Перегляд замовлень&#x20;

У вкладці "Orders" потрібно обрати розділ "List All Orders"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2Faw3T8SeXdU6g2g7vZvcf%2Fimage.png?alt=media&amp;token=96779634-7373-4c61-ab1a-c27e72cefafc" alt=""><figcaption></figcaption></figure>

Для переходу в деталі замовлення потрібно натиснути на відповідний номер в колонці "ID"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FZ1B3WPyHQNEbcS7rd9Nq%2Fimage.png?alt=media&amp;token=afdc0693-a0de-4411-b22d-3a9af636ce71" alt=""><figcaption></figcaption></figure>

## Перегляд транзакції

У вкладці "Billing" потрібно обрати розділ "Transaction List"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FG8Aqm1ptrusIjImjzQJB%2Fimage.png?alt=media&amp;token=24eade5b-1ce6-4dd2-a6af-0ad4cdc57df9" alt=""><figcaption></figcaption></figure>

Для перегляду статусу транзакції, потрібно натиснути "Check Order"

Після чого відкриється нове вікно в браузері з деталями транзакції

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FJz4sruzKc0Pa8NkVagpG%2Fimage.png?alt=media&amp;token=80a49923-86ff-43e4-87a8-7d7c07524d2f" alt=""><figcaption></figcaption></figure>

## Виконання повернення

В деталях замовлення, потрібно натиснути кнопку "Cancel & Refund"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FuTAGSjcK2HZhhLN8Y2Cj%2Fimage.png?alt=media&amp;token=5f687b6d-8a93-46db-91ce-1407fcaf565f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FflIqx5cJCBbMg3K2NzZs%2Fimage.png?alt=media&amp;token=779a310d-994f-4fed-8358-cdf29a132445" alt=""><figcaption></figcaption></figure>

В деталях транзакції, з'явиться новий запис про виконане повернення&#x20;

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FLdW4runyHHuZYHwMCtlr%2Fimage.png?alt=media&amp;token=d008b6e2-2f63-4479-8be4-3ab9af71f03d" alt=""><figcaption></figcaption></figure>

## Виконання PreAuth платежу

Режим **PREAUTH** використовується для резервування (холдування) коштів на картці клієнта без їх негайного списання. Остаточне списання виконується окремою операцією **Completion** після підтвердження інвойсу в адміністративній панелі.

#### Налаштування PREAUTH <a href="#nalashtuvannya-preauth" id="nalashtuvannya-preauth"></a>

У налаштуваннях платіжного методу **AlliancePay Bank** виберіть:

* **Payment Type** — `PREAUTH`.
* **Pre-Auth Expiration Period** — строк, протягом якого кошти залишаються зарезервованими. Доступні значення: `2h`, `4h`, `6h`, `12h`, `1d`, `2d`, `7d`, `14d` або `28d`.
* **API Base URL**, **Merchant ID**, **Service Code** та **Authentication Key** — значення, надані Alliance Bank.

Після завершення строку **Pre-Auth Expiration Period** резервування може бути автоматично скасоване банком. Тому підтвердити списання потрібно до закінчення цього строку.

#### Процес оплати клієнтом <a href="#proces-oplati-kliyentom" id="proces-oplati-kliyentom"></a>

1. Клієнт оформлює замовлення та переходить на Hosted Payment Page (HPP).
2. Після успішної автентифікації банк резервує суму замовлення на рахунку клієнта.
3. Магазин отримує результат операції PREAUTH. На цьому етапі кошти ще **не списані**, а лише заблоковані.
4. Для завершення платежу адміністратор має підтвердити списання в інвойсі.

#### Підтвердження списання коштів <a href="#pidtverdzhennya-spisannya-koshtiv" id="pidtverdzhennya-spisannya-koshtiv"></a>

Підтвердження виконується в адміністративній панелі платіжної системи:

1. Відкрийте **Billing → Invoices**.\
   ![](https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FJB6p1jhIGBUiuhLAcYQg%2Fimage.png?alt=media\&token=149fa5e7-7a7b-454c-b672-e030368ff735)
2. Знайдіть інвойс, пов’язаний із платежем PREAUTH, і відкрийте його.
3. Перейдіть до **Manage invoice**.
4. Переконайтеся, що інвойс має статус **UNPAID**, а в інформаційному блоці зазначено, що кошти зарезервовано та не списано.
5. Натисніть **Підтвердити списання (Completion)**.
6. Дочекайтеся відповіді банку та перевірте результат операції в блоці **Transactions**.

Кнопка **Підтвердити списання (Completion)** виконує фінальне списання саме зарезервованої суми. Не натискайте її повторно, якщо попередній запит уже успішно виконано.

#### Результат операції <a href="#rezultat-operaciyi" id="rezultat-operaciyi"></a>

Після успішного Completion платіж переходить із PREAUTH у фінальний стан списання. В інвойсі оновлюється баланс і статус оплати, а в розділі **Transactions** з’являється запис про операцію **COMPLETION** із відповідним ідентифікатором транзакції.

Якщо операція не виконана, перевірте повідомлення про помилку, строк дії резервування та доступність суми. До отримання успішної відповіді банку не вважайте платіж остаточно списаним.