# Settings and authorization

{% stepper %}
{% step %}

### Let's go to the module settings

You need to click "Configure"

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

{% step %}

### Initial settings

Most of the fields will be provided by the bank for filling in.

#### Сторінка налаштувань :

<figure><img src="/files/lx1Fws84FwryFxaHrjDe" 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:
  * **STATUS\_TIMER\_PAGE** - default page, if the merchant did not select the desired type, the redirect timer automatically displays the status page for 1 minute with automatic redirection of the user to the merchant's site (redirect URL)
  * **STATUS\_REDIRECT\_MERCHANT\_PAGE** - immediate redirection to the merchant's URL
  * **STATUS\_PAGE** - redirection to our status page (download receipt ...)
* The `API URL` field must be set to the value - <https://api-ecom-prod.bankalliance.ua>
* The `Service Code` and `Merchant Id` fields will be provided by the bank
* The `Authorization Key` field will need to be generated independently according to the documentation (<https://docs.merchant.alb.ua/en/authentication#process-of-generating-client-communication-jwk-keys>), where the public part will need to be transferred to a bank employee
* The `Device Id`, `Refresh token`, `Auth token` fields will appear after authorization
* In the `Successful Order Status`, `Failed Order Status`, `Successful Return Status`, `Return Error Status` fields - 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 %}

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

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


---

# Agent Instructions: 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:

```
GET https://docs.merchant.alb.ua/en/payment-widgets-for-cms/prestashop/settings-and-authorization.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
