> For the complete documentation index, see [llms.txt](https://help.zenky.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zenky.io/pay/alfa-bank.md).

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

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

Для подключения эквайринга от Альфа Банка вам нужно подать заявку на <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>

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