> 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="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2Fh7UHga6WHTwzEkhADqy3%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%C2%A0%E2%80%94%202026-05-11%20%D0%B2%C2%A023.44.04.png?alt=media&amp;token=97ee4348-e816-4a9d-87a3-ca6ca91f97f2" 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="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FIgtSgVv3ryvv8FHv4jZF%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%C2%A0%E2%80%94%202026-05-11%20%D0%B2%C2%A023.51.02.png?alt=media&amp;token=7a138557-66e5-4eb0-85c4-5bdc417b272b" 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="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2Fc8p6TQDFNcptNo2EDeiM%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%C2%A0%E2%80%94%202026-05-11%20%D0%B2%C2%A023.54.35.png?alt=media&amp;token=c3bb81c8-ecf4-4b6b-bd8a-a2812578a3c2" 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="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FMkVbq7wpGgvPsmJgNayo%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%C2%A0%E2%80%94%202026-05-11%20%D0%B2%C2%A023.57.14.png?alt=media&amp;token=2a8ff21f-5e8d-48a4-a012-2fe460ecbebb" 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="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2F1IvAhu1pFYFQvaM8Uom8%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%C2%A0%E2%80%94%202026-05-11%20%D0%B2%C2%A023.58.38.png?alt=media&amp;token=45eba994-1187-4911-9be0-8f364ce43dfd" alt=""><figcaption><p>Подключение способа оплаты Альфа Банк.</p></figcaption></figure>

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