> 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/prestashop/funkcional.md).

# Функціонал

## Список усіх замовлень

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FZQTkrqVEAgoEiYMnUSva%2Fimage.png?alt=media&amp;token=5f5ff811-0251-42a7-91a0-0617080d9cee" alt=""><figcaption></figcaption></figure>

## Отримати додаткову інформацію по платежу&#x20;

Потрібно перейти в деталі замовлення та натиснути на клавішу "Update from Alliance API"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FOfI0xj25Z7hKJaQ2i2XW%2Fimage.png?alt=media&amp;token=e059c080-4988-4ad2-8c4c-6b07160b600e" 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%2FC3QcUANBnzu2T2SI5Aoo%2Fimage.png?alt=media&amp;token=c4dbb9d4-6fbc-458b-a710-72593f36b82a" alt=""><figcaption></figcaption></figure>

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

Потрібно перейти в деталі замовлення та натиснути клавішу "Часткове повернення коштів"&#x20;

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2F2OWQd0Ju2PHqjSYJWPfK%2Fimage.png?alt=media&amp;token=52aaf46b-98fe-4aae-b7d6-2b4ab96bee11" alt=""><figcaption></figcaption></figure>

Після натискання відкривається вікно, де можна виконати **повне** або **часткове** **повернення**.&#x20;

## Часткове повернення &#x20;

У відкритому вікні можна обрати кількість товарів, або суму за товари, що буде повернена

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FewWiCRdM2onqmSKYB8ZF%2Fimage.png?alt=media&amp;token=744cfc32-b3e5-4bd9-9cb3-66c5b3910ecc" 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%2F0E2knTZTSxocYhIEGNDL%2Fimage.png?alt=media&amp;token=5210a92c-0c2f-4c6b-960c-f4e4968496f1" alt=""><figcaption></figcaption></figure>

Та при натисканні на клавішу "Часткове поверення коштів" буде відображитись лише залишок по кількісті та сумі можливого повернення

&#x20;&#x20;

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FEOgixEuIgVandaXTieaD%2Fimage.png?alt=media&amp;token=ac85f14c-9469-45e4-a0c6-4d15ca189ce5" 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%2FBZPYMHPzIBZOV9yxufB6%2Fimage.png?alt=media&amp;token=1fb31bd2-94e7-4a6c-a6dc-91eaafe76ef2" 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%2FDVq01P32RBpEIYhBA9K9%2Fimage.png?alt=media&amp;token=188c8b1a-dbd7-4881-a19d-e4f9596d9535" alt=""><figcaption></figcaption></figure>

Після вибору способу повернення, потрібно натиснути клавішу "Часткове повернення коштів"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FF46y4sXoOVWmDvcfQMOS%2Fimage.png?alt=media&amp;token=64c793b7-7f05-42c6-ba1c-b92ba8cbe3fc" alt=""><figcaption></figcaption></figure>

## Сторінка оплати&#x20;

На чекауті з'явиться вибір оплати **AlliancePay**

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2F7L4NmeG81N7Ai3FP0xN3%2Fimage.png?alt=media&amp;token=2aa13a06-1fd6-49fe-ac20-e0687f640b21" 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%2FbYb6Z6P30xDMpHOyCJeJ%2Fimage.png?alt=media&amp;token=d8652fca-4ab6-4c1d-a26a-1ff16a18188e" alt=""><figcaption></figcaption></figure>

## Процес Completion для режиму PREAUTH <a href="#proces-completion-dlya-rezhimu-preauth" id="proces-completion-dlya-rezhimu-preauth"></a>

У режимі `PREAUTH` під час першого етапу платежу банк лише авторизує операцію та тимчасово блокує кошти на картці клієнта. Щоб завершити платіж і фактично списати кошти, необхідно виконати окрему операцію `Completion`.

**Послідовність виконання**

1. Покупець завершує оплату через HPP, а модуль отримує успішний результат операції `PREAUTH`.
2. Замовлення переводиться у статус, налаштований у полі **PreAuth order state** (наприклад, *Очікується оплата банківським переказом*).
3. Після підтвердження замовлення або готовності товару адміністратор переводить його у статус, налаштований у полі **Completion trigger order state** (наприклад, *Оплату прийнято*).
4. Модуль використовує збережені дані авторизованої операції та надсилає до API запит `Completion` на списання коштів.
5. Після успішної відповіді API замовлення залишається або переводиться у статус **Оплату прийнято**. Клієнту можна відправити підтвердження оплати та розпочати обробку замовлення.

**Важливі умови**

* Операцію `Completion` потрібно виконати до завершення періоду, заданого в **PreAuth expiration period** (у прикладі — `2h`).
* Не слід виконувати `Completion` повторно для вже завершеної операції: повторний запит може бути відхилений банком.
* Якщо авторизація прострочена, скасована або запит `Completion` завершився помилкою, кошти не списуються. Перевірте відповідь API та налаштування статусу помилки.
* Суму до списання та ідентифікатор початкової авторизації необхідно брати із замовлення й даних платежу, збережених модулем; не вводьте їх вручну без перевірки.

{% hint style="warning" %}
**Увага:** переведення замовлення у статус *Completion trigger order state* запускає завершення PREAUTH лише якщо така автоматизація реалізована та увімкнена у поточній версії модуля. Перед використанням у production перевірте сценарій у тестовому середовищі.
{% endhint %}
