# Подключение эквайринга от Альфа Банка

## Подготовка к подключению

Для подключения эквайринга от Альфа Банка вам нужно подать заявку на <https://alfabank.ru/sme/payservice/internet-acquiring/> и получить одобрение заявки.

Для успешного прохождения заявки вам может потребоваться заполнить правовые документы в разделе [**«Магазин» – «Реквизиты и документы»**](https://my.zenky.io/dashboard/store/profile/legal) в панели управления магазином Zenky. Эти документы, а также страницу с реквизитами можно включить в конструкторе сайта, чтобы сотрудники Альфа Банка смогли увидеть ссылки и изучить информацию о вашей компании.

{% hint style="danger" %}
**Оплата через Альфа Банк может быть недоступна в мобильных приложениях**

Если ваш магазин в Zenky имеет опубликованное мобильное приложение в App Store и Google Play, онлайн-оплата заказов через Альфа Банк в ваших приложениях может быть недоступна.

Для подключения оплаты через Альфа Банк потребуется выпустить обновление для вашего приложения. Пожалуйста, свяжитесь с вашим менеджером или напишите в чат техподдержки, чтобы сделать запрос на подключение Альфа Банка в вашем мобильном приложении.

Оплата через Альфа Банк для вашего сайта, работающего на Zenky, будет доступна без дополнительных обновлений.
{% endhint %}

### Параметры подключения

После того, как ваша заявка на подключение интернет-эквайринга от Альфа Банк будет одобрена, сотрудники банка отправят на вашу почту письмо с параметрами подключения (имена пользователей и пароли).

<figure><img src="/files/h5Yy1ZyHWMRnL3Ts0AK9" alt=""><figcaption><p>Пример письма от Альфа Банка с параметрами подключения.</p></figcaption></figure>

Обратите внимание на формат логинов – данные в формате **r-XXX-operator** используются для работы в личном кабинете. Логин в формате **r-XXX-api** используется для интеграции с эквайрингом – именно он вам и понадобится. Далее мы будем называть его **R-логином для API**.

{% hint style="warning" %}
Обратите внимание

Прежде чем вы сможете принимать платежи через Альфа Банк, вам нужно будет войти в личный кабинет по ссылке из письма от Альфа Банка и изменить пароли как для **r-XXX-operator** логина, так и для **R-логина для API**.

Если этого не сделать, попытки оплатить заказ в Zenky будут завершаться с ошибкой.

Не забудьте сохранить новый пароль. Используйте разные пароли для разных учётных записей!
{% endhint %}

## Настройка эквайринга в Zenky

После того, как вы получили одобрение заявки и изменили пароли для своих аккаунтов, перейдите в раздел [**«Магазин» – «Онлайн-оплата»**](https://my.zenky.io/dashboard/store/profile/settings/payments) панели управления магазином Zenky в качестве платёжного провайдера выберите опцию **«Альфа Банк»**.

<figure><img src="/files/C3LNtuhFp5ErAIPJtnFL" alt=""><figcaption><p>Выбор платёжного провайдера.</p></figcaption></figure>

После выбора **«Альфа Банк»** вам станут доступны дополнительные настройки.

#### Выбор схемы оплаты <a href="#vybor-skhemy-oplaty" id="vybor-skhemy-oplaty"></a>

Альфа Банк позволяет проводить онлайн-платежи по двум схемам:

1. **Одностадийная**. В этом случае при онлайне-оплате деньги сразу списываются с карты покупателя и запускается процесс их перевода на ваш счёт в Альфа Банке. Если после успешной оплаты вы по какой-то причине отмените заказ, деньги покупателю будут возвращены в течение нескольких рабочих дней (как правило, 1-3 рабочих дня);
2. **Двухстадийная**. В этом случае в момент оплаты Альфа Банк не списывает деньги с карты, а замораживает (холдирует) их, чтобы покупатель не смог ими распорядиться. Фактическое списание произойдёт только после того, как заказ перейдёт в статус **«Выполнен»**. Если до выполнения заказа вы отмените его, деньги вернутся покупателю практически моментально.

![](https://help.zenky.io/~gitbook/image?url=https%3A%2F%2F1480690874-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-M1B1BMwmRkGzV5C4BnU%252Fuploads%252FOyBTQNOUXhlFcXwANPWX%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-01-10%2520%25D0%25B2%252018.52.44.png%3Falt%3Dmedia%26token%3Dbb0d957e-21f0-4331-9732-9f4a332c4b91\&width=768\&dpr=3\&quality=100\&sign=7c9fe037\&sv=2)

{% hint style="danger" %}
**Будьте внимательны!**

Если вы выберите двухстадийную схему оплаты, для получения средств вам обязательно нужно будет перевести заказ в статус **«Выполнен»** (либо вручную в панели управления магазином Zenky, либо через интеграцию с Iiko или Frontpad).
{% endhint %}

В полях **«Логин магазина Альфа Банка»** и **«Пароль для API Альфа Банка»** укажите данные **R-логина для API** и пароль к нему.

<figure><img src="/files/XtL6cxYi4haghgnIJg9t" alt=""><figcaption><p>Ввод учётных данных к API Альфа Банка.</p></figcaption></figure>

Сохраните настройки. Подключение к API эквайринга Альфа Банка завершено.

### Оплата в мобильных приложениях <a href="#oplata-v-mobilnykh-prilozheniyakh" id="oplata-v-mobilnykh-prilozheniyakh"></a>

Если ваш магазин в Zenky имеет опубликованное мобильное приложение в App Store и Google Play, онлайн-оплата заказов через Альфа Банк в ваших приложениях может быть недоступна. В этом случае вы увидите такое предупреждение:

<figure><img src="/files/69BPkBmY0bvp6gZcxe3W" alt=""><figcaption><p>Предупреждение о недоступности Альфа Банка в мобильном приложении магазина.</p></figcaption></figure>

Для подключения оплаты через Альфа Банк потребуется выпустить обновление для вашего приложения. Пожалуйста, свяжитесь с вашим менеджером или напишите в чат техподдержки, чтобы сделать запрос на подключение Альфа Банка в вашем мобильном приложении.

Оплата через Альфа Банк для вашего сайта, работающего на Zenky, будет доступна без дополнительных обновлений.

### Подключение способа оплаты Альфа Банка <a href="#podklyuchenie-sposoba-oplaty-yukassa" id="podklyuchenie-sposoba-oplaty-yukassa"></a>

Финальный шаг – включить способ оплаты «Альфа Банк» в настройках заказов вашего магазина. Для этого перейдите в раздел [**«Магазин» – «Настройки заказов»** в панели управления магазином Zenky](https://my.zenky.io/dashboard/store/profile/settings/orders). Проскролльте форму до раздела **«Способы оплаты»** и найдите способ оплаты **«Картой онлайн (Альфа Банк)»**. Включите переключатель и сохраните настройки.

<figure><img src="/files/GIVz8wvCD29yC6zQqQ4i" alt=""><figcaption><p>Подключение способа оплаты Альфа Банк.</p></figcaption></figure>

Этот способ оплаты будет отображаться покупателям как **«Картой онлайн»**. Если нужно, вы можете переименовать его в поле **«Название»**.


---

# 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://help.zenky.io/pay/alfa-bank.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.
