> 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="https://1350325132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EENJ3cuuKcQmuXu1GzQ%2Fuploads%2FpRCcIavvZOtn1jNfUKY4%2Fimage.png?alt=media&amp;token=0fa9d3c8-63bd-4ad1-883c-c937d446d559" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Creating a payment method

Click on the "Create" button.

<figure><img src="https://1350325132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EENJ3cuuKcQmuXu1GzQ%2Fuploads%2FLtItA7pf2ehwQpsilQC4%2Fimage.png?alt=media&amp;token=a55d42b9-b891-4dfb-8313-e0afc8aca46c" 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="https://1350325132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EENJ3cuuKcQmuXu1GzQ%2Fuploads%2FICBnYSfZBZ2WpBtrl2sV%2Fimage.png?alt=media&amp;token=8639511d-5f24-4424-8e3a-29b5bc6388e2" 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="https://1350325132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EENJ3cuuKcQmuXu1GzQ%2Fuploads%2FQPYLoJcHkky9M3JkFhNC%2Fimage.png?alt=media&amp;token=47ace475-efe6-4b26-8212-de6d8594e01b" 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="https://1350325132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EENJ3cuuKcQmuXu1GzQ%2Fuploads%2FDEyeuRCfLCwmgeoPMAxw%2Fimage.png?alt=media&amp;token=dd942593-c6d5-480b-883d-fb39bd1308dc" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}
