> 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/joomla-+-virtuemart/nalashtuvannya-ta-avtorizaciya.md).

# Налаштування та авторизація

{% stepper %}
{% step %}

### Переходимо у налаштування модуля 

За шляхом "Компоненти" -> "Payment Methods"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FhwyRFNfpXGuXPzvGri9a%2Fimage.png?alt=media&amp;token=81bf8ed4-584c-4c6d-a6ab-655e219e7513" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Створюємо платіжний метод&#x20;

Натискаємо на клавішу "Створити"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FBzjpY6uJtU2cRIVEmazi%2Fimage.png?alt=media&amp;token=49ef9cd0-d188-4c80-b87f-5486b46cdf9a" alt=""><figcaption></figcaption></figure>

Після у новому вікні, потрібно заповнити поля `Payment Name`, `Sef Alias` та обрати `Payment Method == VM - Alliance Pay`&#x20;

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FSLdET6eow5Xp8aiq7SUn%2Fimage.png?alt=media&amp;token=fc2759ed-23c8-4b07-b21f-ff1ec1e8a21b" alt=""><figcaption></figcaption></figure>

Після чого потрібно натиснути клавішу "Зберегти", щоб вікрилась можливість налаштовувати вкладку Configuration
{% endstep %}

{% step %}

### Налаштування конфігурації, платіжного методу

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

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FZpprWK4x4ymaK3SpeZad%2Fimage.png?alt=media&amp;token=04ae6d14-646e-4445-8bcc-1a0073df4874" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Обов'язково, всі поля повинні бути заповненні
{% endhint %}

#### &#x20;**Опис полів:**

<table><thead><tr><th>Назва</th><th>Опис</th><th>Приклад</th></tr></thead><tbody><tr><td>Тип сторінки статусу</td><td>Визначає як буде виглядати сторінка після виконання оплати</td><td><p></p><p>Можливі значення : <br></p><ul><li><code>STATUS_TIMER_PAGE</code> - сторінка за замовчуванням, якщо мерчант не обрав бажаний тип, таймер редірект автоматично 1 хвилина відображення статус сторінки з автоматичним редіректом юзера на сайт мерчанта (редірект урл)</li><li><code>STATUS_REDIRECT_MERCHANT_PAGE</code> - одразу редірект на урл мерчанта</li><li><code>STATUS_PAGE</code> - редірект, на нашу статус сторіншку (завантажити квитанцію …)</li></ul></td></tr><tr><td>Тип платежу</td><td>Тип платежу<br>При роботі зі звичайною платіжною сторінкою потрібно обирати "PURCHASE"<br>При роботі з переказом між рахунками потрібьно обирати "A2A"<br>При резервування коштів та фактичного списання зарезервованої суми "PREAUTH"</td><td>Можливі значення : <br>- PURCHASE<br>- A2A<br>- PREAUTH</td></tr><tr><td>Термін дії передавторизації</td><td>Період, протягом якого успішна PREAUTH-операція залишається активною та може бути завершена за допомогою Completion.</td><td>Період може становити від <strong>2 годин до 28 днів</strong>. Completion необхідно виконати до завершення встановленого періоду PREAUTH.</td></tr><tr><td>API URL</td><td>URL на який будуть надходити API запити </td><td>Потрібно вказати : <br><a href="https://api-ecom-prod.bankalliance.ua"><code>https://api-ecom-prod.bankalliance.ua</code></a></td></tr><tr><td>Service Code</td><td>Унікальний ідентифікатор для авторизації</td><td>d86a0f72-0dfe-4102-ace7-78997d042b7f</td></tr><tr><td>Merchant ID</td><td>Унікальний ідентифікатор мерчанта</td><td>9a337b2b-4d97-4abe-9f95-cde229f9bd83</td></tr><tr><td>Private JWK</td><td>Приватний ключ, потрібен для виконання авторизації</td><td><p>Його потрібно згенерувати самостійно за <a href="https://docs.merchant.alb.ua/autentifikaciya#proces-generaciyi-komunikaciinikh-jwk-klyuchiv-kliyenta">інструкцією</a> та надати співробітнику банку</p><p>Приклад : </p><pre class="language-json"><code class="lang-json">{
    "kty": "EC",
    "d": "nmxbG1KJ9zmekBZfJWPwG8ZJLmhKHJVsXfXIFrHkRM_Uy9z7E7ppvpvfDF62_mx8",
    "use": "enc",
    "crv": "P-384",
    "x": "dTV0I2RU5DZHVfaIQPp3svUb-Vaxwfn1WDeNUY11L3ch4vZtbdbcBc7fvK76QsDn",
    "y": "qL9X0zvaXtQx_KyBZHg16qiol9lahscW-k7FBwmAf-bpYdE7-fruH9wUQWpKw14X",
    "alg": "ECDH-ES+A256KW"
}
</code></pre></td></tr><tr><td>Статуси змовлень</td><td>Потрібно самостійно вказати, яка логіка буде відбуватись при конкретному статусі платежа</td><td></td></tr></tbody></table>

{% hint style="warning" %}
Для кожного типу платежу реєструється унікальний термінал, що призначений для виконання конкретних операції \
Тому для A2A будуть інші значення `Merchant ID` та `Service Code`
{% endhint %}

{% hint style="info" %}
Для режиму `PREAUTH` необхідно узгодити з платіжним провайдером максимальний строк авторизації та налаштувати процес її завершення. Поле **Completion Trigger Status** визначає статус замовлення VirtueMart, після переходу до якого може запускатися завершення авторизованого платежу.
{% endhint %}

{% hint style="warning" %}
Після налаштуванню усіх полів, обов'язково потрібно натиснути клавішу "Зберегти" і тільки після цього натиснути клавішу "Авторизуватись"
{% endhint %}
{% endstep %}

{% step %}

### Авторизація

Як тільки була натиснута клавіша "Авторизуватись", під клавішою повинен з'явитись надпис "Success!"

<figure><img src="https://1348498792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdjW26z83WQoOq0ZjunWw%2Fuploads%2FS0s3CX1nwg6Ys7P2dDQt%2Fimage.png?alt=media&amp;token=f2c3dafd-85aa-4397-a81b-060ad11edebe" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}