---
metadata:
- name: generator
content: Diplodoc Platform v5.52.0
alternate:
- https://pay.yandex.ru/docs/ru/cms/wordpress/index.md
- href: ru/cms/wordpress/index.md
type: text/markdown
title: Markdown version
- href: ../../llms.txt
type: text/markdown
title: llms.txt
title: "Плагин Яндекс\_Пэй для WordPress\_— установка и настройка WooCommerce | Документация"
description: "Подключите Яндекс\_Пэй к интернет-магазину на WordPress. Простая интеграция с WooCommerce, настройка платежей и инструкция по установке плагина."
---
> **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt
# Интеграция с WordPress
Бесплатный модуль
Модуль **WordPress** позволяет подключить прием платежей через Яндекс Пэй и Сплит на ваш сайт, созданный на базе WordPress. Модуль предоставляет [ООО «Яндекс»](https://pay.yandex.ru/business/modules?utm_source=yandex_pay_docs) **бесплатно**.
{% note warning "Совместимость версий" %}
- WordPress версии 6.0 и выше
- Woocommerce версии 7.7.2 и выше — возможна совместимость с более низкими версиями, но мы рекомендуем использовать версию не ниже указанной
{% endnote %}
## Возможности модуля {#features}
#|
|| Прием оплаты |  ||
|| Полный возврат |  ||
|| Частичный возврат |  ||
|| Бейджи Яндекс Пэй / Сплит |  ||
|| Виджеты Яндекс Пэй / Сплит |  ||
|| Тестовый режим |  ||
|| Контроль наличия товара |  ||
|| Синхронизация статуса оплаты |  ||
|| Получение прямого QR | Неприменимо ||
|| Получение обратного QR | Неприменимо ||
|#
## Шаг 1. Регистрация в Яндекс Пэй {#registration-ya-pay}
1. [Зарегистрируйтесь](https://pay.yandex.ru/docs/ru/console/registration.md) в личном кабинете Яндекс Пэй и [подайте заявку](https://pay.yandex.ru/docs/ru/console/registration.md#application) на подключение сервиса Яндекс Пэй и Сплит в ваш магазин.
1. Дождитесь одобрения заявки и подключения сервиса.
1. В [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru) выберите в [селекторе](*selector) ваш магазин и перейдите в раздел **Настройки**.
1. В блоке **Подключение** нажмите **Выпустить ключ Merchant API**, скопируйте и сохраните значение выпущенного ключа.
{% cut "Где выпустить ключ API" %}
{.c-screenshot width=500px}
{% endcut %}
Также скопируйте и сохраните значение **Merchant ID**. Эти данные понадобятся вам при дальнейшей настройке.
{% cut "Где найти Merchant ID" %}
{.c-screenshot width=500px}
{% endcut %}
## Шаг 2. Установка плагина {#setup}
{% note warning %}
Перед установкой плагина убедитесь, что ваш сайт соответствует [системным требованиям](https://pay.yandex.ru/docs/ru/custom/web-sdk/index.md#requirements) для подключения Яндекс Пэй и Сплит.
В случае если сайт не соответствует требованиям, плагин работать не будет — вы можете воспользоваться личным кабинетом, чтобы создать [ссылку на оплату](https://pay.yandex.ru/docs/ru/console/create-link.md#console-create) вручную.
{% endnote %}
Добавить плагин в WordPress можно двумя способами: загрузить из установочного архива или установить из каталога плагинов.
{% list tabs %}
- Из архива
1. Скачайте архив с [маркетплейса WordPress](https://wordpress.org/plugins/yandex-pay-and-split/).
1. В левом меню административной панели WordPress перейдите в раздел **Plugins** и нажмите кнопку **Add New**.
{.c-screenshot}
1. В открывшемся окне нажмите кнопку **Upload Plugin** → **Выбрать файл** и выберите скачанный установочный архив.
{.c-screenshot}
1. После установки плагин отобразится в списке.
{.c-screenshot}
- Из каталога плагинов
1. В левом меню административной панели WordPress перейдите в раздел **Plugins** и нажмите кнопку **Add New**.
{.c-screenshot}
1. С помощью поисковой строки найдите плагин **Яндекс Пэй и Сплит** и нажмите кнопку **Install Now**.
{.c-screenshot}
1. После установки плагин отобразится в списке.
{.c-screenshot}
{% endlist %}
## Шаг 3. Настройка плагина {#settings}
1. В левом меню административной панели WordPress перейдите в раздел **Plugins** → **Installed Plugins**.
{.c-screenshot}
1. В списке плагинов найдите **Яндекс Пэй и Сплит** и нажмите **Активировать**.
{.c-screenshot}
{% cut "**Ошибка: Запрошенный URL-адрес не найден на этом сервере**" %}
Если возникла ошибка «Запрошенный URL-адрес не найден на этом сервере», настройте значение постоянной ссылки (Permalink), чтобы плагин работал корректно:
1. В левом меню административной панели перейдите в раздел **Настройки** → **Permalinks**.
{.c-screenshot}
1. В разделе **Common Settings** выберите любое поле отличное от **Plain**.
{.c-screenshot}
1. Прокрутите страницу с настройками вниз и сохраните изменения с помощью кнопки **Save Changes**.
{.c-screenshot}
{% endcut %}
1. Перейдите в настройки плагина одним из следующих способов:
- В административной панели слева перейдите в раздел **Plugins** → **Installed Plugins** → **Настройки**.
{.c-screenshot}
- В административной панели слева перейдите в раздел **Woocommerce** → **Яндекс Пэй и Сплит**.
{.c-screenshot}
1. Укажите параметры плагина в разделах настроек:
#|
|| **Раздел настроек** | **Параметр** | **Описание** ||
|| **Merchant** | Merchant ID[*](*required) | Укажите [Merchant ID](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-id) из личного кабинета Яндекс Пэй. ||
|| ^ | API-key / API-ключ[*](*required) | Укажите [API-ключ](../../console/settings-pay-split#merchant-api-keys) из личного кабинета Яндекс Пэй. ||
|| **Other / Другое** | Testing / Тестирование | Параметр отвечает за включение/выключение тестового окружения. ||
|| ^ | TTL / Время на оплату | Укажите время, в течение которого пользователь может воспользоваться ссылкой на форму оплаты заказа. ||
|| **Orders / Заказы** | Pending order status / Статус обрабатываемого заказа | Укажите статус заказа, который выставляется при его создании. ||
|| ^ | Success order status / Статус успешного заказа | Укажите статус заказа, который выставляется при успешной оплате. ||
|| ^ | Error order status / Статус неуспешного заказа | Укажите статус заказа, который выставляется при ошибке оплаты. ||
|| ^ | Refund order status / Статус возвращенного заказа | Укажите статус заказа, который выставляется при возврате оплаты. ||
|| ^ | Failed refund order status / Статус ошибки возврата в заказе | Статус заказа, который выставляется при ошибке возврата. ||
|| ^ | Payment purpose / Назначение платежа | Укажите назначение, которое будет выставляться для платежа в заказе. ||
|| **Button / Кнопка** | Button type / Тип кнопки | Параметр отвечает за включение/выключение возможности использовать кнопку Яндекс Пэй. ||
|| ^ | Button theme / Тема кнопки | Выберите [тему](*button-options) кнопки оплаты. ||
|| ^ | Button width / Ширина кнопки | Выберите фиксированную или адаптивную [ширину](*button-options) кнопки оплаты. ||
|| ^ | Icons theme / Тема иконки | Выберите тему иконки, которая будет отображаться на странице выбора метода оплаты рядом с методом оплаты. ||
|#
\* Обязательный параметр
1. При необходимости [настройте](#badges-widgets) бейджи и виджеты Яндекс Пэй.
1. Сохраните изменения.
1. Перейдите в раздел **Woocommerce** → **Налог** и отключите опцию **Округление суммы**.
{% note warning %}
Если опция **Округление суммы** включена, возможны ошибки расхождения сумм в заказе при оплате заказа через Яндекс Пэй и Сплит.
{% endnote %}
{% note tip "Фискализация" %}
Если вы еще не подключили в ваш магазин фискализацию чеков, вы можете подключить ее через облачную кассу АТОЛ Онлайн или CloudKassir в личном кабинете Яндекс Пэй — как это сделать, см. в разделе [{#T}](#fiscalization).
{% endnote %}
## Шаг 4. Тестирование оплаты {#testing-mode}
Чтобы проверить корректность обработки платежей c помощью Яндекс Пэй, включите тестовый режим:
1. В личном кабинете Яндекс Пэй:
1. Перейдите в раздел **Настройки** и в правом верхнем углу включите опцию **Тестовые данные**.
1. В блоке **Подключение** нажмите **Добавить Callback URL `Тестовый`** и укажите:
```
{url_адрес_сайта}/wc-api/yandex-pay-and-split
```
где `{url_адрес_сайта}` — URL вашего сайта.
{% cut "Куда добавить тестовый Callback URL" %}
{.c-screenshot width=500px}
{% endcut %}
1. Нажмите кнопку **Сохранить**.
1. В левом меню административной панели WordPress перейдите в настройки плагина **WooCommerce** → **Яндекс Пэй и Сплит** → вкладка **Общие** и включите параметр **Тестирование**.
{.c-screenshot width=750px}
1. Выполните несколько тестовых платежей и [возвратов](#refund) в вашем магазине, чтобы проверить, что плагин установлен успешно.
## Шаг 5. Переход в рабочий режим {#working-mode}
После тестирования оплаты переключите среду с тестовой на боевую:
1. В личном кабинете Яндекс Пэй:
1. Перейдите в раздел **Настройки** и отключите опцию **Тестовые данные**, чтобы скрыть тестовые настройки.
1. В блоке **Подключение** нажмите **Добавить Callback URL** и укажите:
```
{url_адрес_сайта}/wc-api/yandex-pay-and-split
```
где `{url_адрес_сайта}` — URL вашего сайта.
1. В левом меню административной панели WordPress перейдите в настройки плагина **WooCommerce** → **Яндекс Пэй и Сплит** → вкладка **Общие** и выключите параметр **Тестирование**.
{.c-screenshot width=750px}
Настройка модуля завершена. Теперь клиенты в вашем магазине могут оплачивать покупки при помощи Яндекс Пэй и Сплит.
{% note info %}
Если у вас остались вопросы по настройке плагина, обратитесь в нашу [службу поддержки](https://forms.yandex.ru/surveys/13490261.f4adc83a2c75b10abe163bf264af4e3842a535e0/).
{% endnote %}
## Дополнительно
### Включение/выключение метода оплаты {#payment-method-on}
Модуль предоставляет два метода оплаты — Яндекс Пэй и Яндекс Сплит. Чтобы включить или выключить метод оплаты:
1. В левом меню административной панели перейдите в раздел **Woocommerce** → **Настройки** → **Платежи**.
{.c-screenshot width=750px}
1. Напротив нужного метода воспользуйтесь переключателем.
{.c-screenshot width=750px}
1. Сохраните изменения.
### Оформление возвратов {#refund}
В административной панели WordPress вы можете оформить полный или частичный возврат средств по заказу:
1. Откройте заказ, для которого необходимо оформить возврат, и в левом нижнем углу нажмите кнопку **Refund**.
{.c-screenshot}
1. Для каждого товара отобразятся поля для ввода количества единиц и суммы возврата:
{.c-screenshot}
Укажите количество единиц или сумму, которую вы хотите вернуть, — в правом нижнем углу окна в поле **Refund amount** отобразится итоговая сумма к возврату.
1. Нажмите кнопку **Refund via Yandex Pay**, чтобы оформить возврат.
{% note info %}
Также вы можете оформить полный или частичный возврат в разделе **Платежи** [личного кабинета Яндекс Пэй](https://pay.yandex.ru/docs/ru/custom/refund-payments.md#payment-refund).
{% endnote %}
### Подключение бейджей и виджетов Яндекс Пэй {#badges-widgets}
{% note info %}
Начиная с версии плагина 1.1.3 бейджи и виджеты Яндекс Пэй подключены по умолчанию. При необходимости вы можете настроить их отображение на страницах вашего магазина.
{% endnote %}
#### Бейджи {#badges}
Бейджи Яндекс Пэй могут отображаться на странице с товарами и в карточке товара:
{% list tabs %}
- Страница с товарами
{.c-screenshot width=60%}
- Карточка товара
{.c-screenshot width=60%}
{% endlist %}
Чтобы подключить и настроить в вашем магазине бейджи Яндекс Пэй:
1. В левом меню административной панели WordPress перейдите в настройки плагина → **Badges / Бейджи**.
1. В блоке **Badge loop settings** активируйте опцию **Enable loop badges** (Включить бейджи на странице с товарами).
{.c-screenshot width=300px}
1. В блоке **Badge single product page settings** активируйте опцию **Enable single product page badges** (Включить бейджи в карточке товара).
{.c-screenshot width=300px}
1. Настройте параметры бейджей в двух блоках:
- **Badge loop settings** — настройки бейджей на странице с товарами.
- **Badge single product page settings** — настройки бейджей в карточке товара.
#|
|| **Раздел настроек** | **Параметр** | **Описание** ||
|| Badge BNPL / Бейдж Сплита | Color / Цвет | Выберите [цвет](*badge-options) бейджа. ||
|| ^ | Variant / Вариант отображения | Выберите [вариант отображения](*badge-options) бейджа. ||
|| ^ | Theme / Тема | Выберите [тему](*badge-options) бейджа. ||
|| ^ | Size / Размер | Выберите [размер](*badge-options) бейджа. ||
|| ^ | Align / Выравнивание | Выберите выравнивание бейджа. ||
|| Badge ultimate / Универсальный бейдж | Variant / Вариант отображения | Выберите [вариант отображения](*badge-options) бейджа. ||
|| ^ | Theme / Тема | Выберите [тему](*badge-options) бейджа. ||
|| ^ | Size / Размер | Выберите [размер](*badge-options) бейджа. ||
|| ^ | Align / Выравнивание | Выберите выравнивание бейджа. ||
|#
1. Сохраните изменения.
#### Виджеты {#widgets}
Виджеты Яндекс Пэй могут отображаться в карточке товара и на странице выбора способа оплаты:
{% list tabs %}
- Карточка товара
{.c-screenshot width=60%}
- Выбор способа оплаты
{.c-screenshot width=60%}
{% endlist %}
Чтобы подключить и настроить в вашем магазине виджеты Яндекс Пэй:
1. В административной панели WordPress перейдите в настройки плагина и в разделе **Widgets / Виджеты** активируйте опции:
- **Enable on single product page** (Включить в карточке товара).
- **Enable on checkout page** (Включить на странице выбора способа оплаты).
{.c-screenshot width=300px}
1. Настройте параметры виджетов:
#|
|| **Параметр** | **Описание** ||
|| Theme / Тема | Выберите [тему](*widget-options) виджета. ||
|| Padding / Внутренний отступ | Выберите [внутренний отступ](*widget-options) для виджета. ||
|| Size / Размер | Выберите [размер](*widget-options) виджета. ||
|| Outline / Обводка | Параметр отвечает за включение/выключение [обводки](*widget-options) виджета. ||
|| Background / Фон | Выберите [фон](*widget-options) виджета. ||
|| Hide header / Скрыть заголовок | Параметр отвечает за включение/выключение [заголовка (шапки)](*widget-options) виджета. ||
|#
1. Сохраните изменения.
### Подключение фискализации {#fiscalization}
{% note alert "Ограничение" %}
При продаже маркированных товаров чеки не формируются из-за ограничений сервиса Яндекс Пэй, данные не передаются в систему маркировки Честный знак.
{% endnote %}
Если вы используете для фискализации АТОЛ Онлайн или CloudKassir, вы можете настроить автоматическую передачу данных в кассу для формирования кассовых чеков:
1. Выполните настройку в [личном кабинете Яндекс Пэй](https://console.pay.yandex.ru):
1. Выберите в [селекторе](*selector) нужный магазин и перейдите в раздел **Настройки** → **Облачная касса** → **Подключить облачную кассу**.
{.c-screenshot width=400px}
1. Выберите из списка кассу и нажмите кнопку **Продолжить**.
1.
Последовательно заполните данные в зависимости от кассы, которую выбрали:
{% list tabs %}
- АТОЛ
- адрес сайта вашего магазина — будет отображен покупателю в чеке;
- электронная почта для связи — будет отображена покупателю в чеке;
- система налогообложения, которую вы используете;
- логин, пароль и код группы касс в системе АТОЛ.
{% note info %}
Адрес сайта магазина и электронная почта могут отличаться от тех данных, которые вы указали при регистрации в личном кабинете Яндекс Пэй.
{% endnote %}
- CloudKassir
- адрес сайта вашего магазина — будет отображен покупателю в чеке;
- электронная почта для связи — будет отображена покупателю в чеке;
- система налогообложения, которую вы используете;
- Public ID — идентификатор магазина из личного кабинета CloudKassir;
- Пароль для API — секретный ключ из личного кабинета CloudKassir.
{% endlist %}
1. Нажмите кнопку **Продолжить**. В течение нескольких минут касса будет подключена.
1.
Включите и настройте НДС в административной панели WordPress:
1. Перейдите в раздел **WooCommerce** → **Настройки** → вкладка **Общие**.
1. Прокрутите страницу вниз до раздела **Налоги и купоны**, активируйте опцию **Включить налоговые ставки и расчёты** и сохраните изменения.
1. Далее перейдите на вкладку **Налог** и настройте параметры налогов в зависимости от режима налогообложения, который вы используете.
Подробнее о настраиваемых параметрах см. в [документации WooCommerce](https://woocommerce.com/document/setting-up-taxes-in-woocommerce/#configuring-tax-options).
1.
После того как вы завершите настройку фискализации, убедитесь, что транзакции проходят корректно и чеки формируются без ошибок.
[*required]: Обязательный параметр
[*button-options]: Как влияет значение параметра на внешний вид кнопки, см. в [таблице параметров кнопки](https://pay.yandex.ru/docs/ru/custom/web-sdk/buttons#options).
[*widget-options]: Как влияет значение параметра на внешний вид виджета, см. в [таблице параметров виджета](https://pay.yandex.ru/docs/ru/custom/web-sdk/ultimate-widget#options).
[*badge-options]: Как влияет значение параметра на внешний вид бейджа, см. в [таблице параметров бейджа](https://pay.yandex.ru/docs/ru/custom/web-sdk/badges#options).
[*selector]:
Выпадающий список в верхней части страницы личного кабинета Яндекс Пэй, с помощью которого можно переключаться между юридическими лицами и магазинами.
{.c-screenshot width=300px}