> 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/en/payment-widgets-for-cms/joomla-+-virtuemart/settings-and-authorization.md).

# Settings and authorization

{% stepper %}
{% step %}

### Let's go to the module settings

By the path "Components" -> "Payment Methods"

<figure><img src="/files/T79M8B6lY6lord3b9DGi" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Creating a payment method

Click on the "Create" button.

<figure><img src="/files/e6OXiXjHEs69cbgUHkVC" alt=""><figcaption></figcaption></figure>

After that, in the new window, you need to fill in the `Payment Name`, `Sef Alias` ​​fields and select `Payment Method == VM - Alliance Pay`

<figure><img src="/files/guTcy6yE7Q2KvO2TX16z" alt=""><figcaption></figcaption></figure>

After that, you need to click the "Save" button to open the possibility of configuring the Configuration tab.
{% endstep %}

{% step %}

### Configuration settings, payment method

In the Configuration tab, you will need to additionally specify the values ​​that will be provided by the bank employee.

<figure><img src="/files/6S7tdEkdH6OQci04QpZt" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
It is mandatory that all fields be filled in for the payment plugin to work correctly.
{% endhint %}

Field description:

* The `Status Page Type` field has three available values:
  * Timer Page (`STATUS_TIMER_PAGE`) - default page, if the merchant has not selected the desired type, the timer redirects automatically for 1 minute displaying the status page with automatic redirection of the user to the merchant's site (redirect URL)
  * Redirect to the merchant's page (`STATUS_REDIRECT_MERCHANT_PAGE`) - immediate redirection to the merchant's URL
  * Status Page (`STATUS_PAGE`) - redirection to our status page (download receipt ...)
* The `API URL` field must be specified - <https://api-ecom-prod.bankalliance.ua>
* The `Service Code` and `Merchant Id` fields will be provided by the bank
* The `Authentication Key` field will need to be generated independently according to the documentation (<https://docs.merchant.alb.ua/autentifikaciya#proces-generaciyi-komunikaciinikh-jwk-klyuchiv-kliyenta>), where the public part will need to be transferred to the bank employee
* In the fields `Status on successful payment`, `Status on failed payment`, `Status on successful return`, `Status on failed return` - you need to choose yourself

{% hint style="warning" %}
After configuring all fields, be sure to click the "Save" button and only then click the "Authorize" button.
{% endhint %}
{% endstep %}

{% step %}

### Authorization

As soon as the "Authorize" key has been pressed, the inscription "Success!" should appear under the key.

<figure><img src="/files/P0eeh8YdsvYt9V2dfDyp" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.merchant.alb.ua/en/payment-widgets-for-cms/joomla-+-virtuemart/settings-and-authorization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
