# Settings and authorization

{% stepper %}
{% step %}

### Transition in module settings

To configure the payment module "Alliance Payment"

To do this, you need to:

* Go to the Magento 2 admin panel
* Go to the path\
  `Stores → Configuration → Sales → Payment Methods → Alliance Payment`

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

{% endstep %}

{% step %}

### Initial settings

Window displaying all settings

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

Description and values ​​of the fields:

|                                 |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enabled                         | Yes No                                                                               | Enable and disable the module.                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Title                           | text field                                                                           | Name of the payment method that will be displayed on the payment page (checkout payment step)                                                                                                                                                                                                                                                                                                                                                            |
| Payment Type                    | <p>STATUS\_TIMER\_PAGE</p><p>STATUS\_REDIRECT\_MERCHANT\_PAGE</p><p>STATUS\_PAGE</p> | <ul><li><strong>STATUS\_TIMER\_PAGE</strong> - default page, if the merchant has not selected the desired type, the redirect timer automatically 1 minute displays the status page with automatic redirection of the user to the merchant's site (redirect URL)</li><li><strong>STATUS\_REDIRECT\_MERCHANT\_PAGE</strong> - immediate redirection to the merchant's URL</li><li><strong>STATUS\_PAGE</strong> - redirection to our status page</li></ul> |
| API URL                         | text field                                                                           | Alliance Bank API URL provided by the bank. <https://api-ecom-prod.bankalliance.ua/>                                                                                                                                                                                                                                                                                                                                                                     |
| Service Code                    | text field                                                                           | Service code provided by Alliance Bank.                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Marchant Id                     | text field                                                                           | Merchant ID provided by Alliance Bank.                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Authorization key               | text field                                                                           | Generated on the merchant side according to instructions Authentication \| AlliancePay                                                                                                                                                                                                                                                                                                                                                                   |
| Device Id                       | text field (not active)                                                              | Automatically filled after authorization                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Refresh Token                   | text field (not active)                                                              | Automatically filled after authorization                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Successful Payment Order Status | Dropdown with the ability to select the display of the successful order status       | The status to which the order automatically switches after payment                                                                                                                                                                                                                                                                                                                                                                                       |
| Failed Payment Order Status     | Dropdown with the ability to select the display of the unsuccessful order status     | The status to which the order automatically switches after a payment error                                                                                                                                                                                                                                                                                                                                                                               |
| Successful Refund Order Status  | Dropdown with the ability to select the display of the successful refund status      | The status to which the order automatically switches after a refund                                                                                                                                                                                                                                                                                                                                                                                      |
| Failed Refund Order Status      | Dropdown with the ability to select the display of the unsuccessful refund status    | The status to which the order automatically switches after a refund error                                                                                                                                                                                                                                                                                                                                                                                |
| Enable Payment Logs             | Yes No                                                                               | Enable and disable additional error and data logging in \<MAGENTO\_ROOT>/var/log/alliance\_payment.log                                                                                                                                                                                                                                                                                                                                                   |
| {% endstep %}                   |                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

{% step %}

### Authorization

After all fields have been filled in, you need to save the settings and perform authorization so that the `Device Id` and `Refresh Token` fields appear.

<figure><img src="/files/KYxQFhFEuAwWnyObEjUZ" 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/magento-2/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.