Интеграция с WordPress

Бесплатный модуль

Модуль позволяет клиентам оплачивать покупки при помощи Яндекс Пэй и Сплит на вашем сайте, созданном на базе WordPress. Модуль предоставляет Яндекс бесплатно.

Возможности модуля

Шаг 1. Регистрация в Яндекс Пэй

1. Зарегистрируйтесь в личном кабинете Яндекс Пэй и подайте заявку на подключение сервиса.

2. После того как сервис будет подключен, в личном кабинете Яндекс Пэй перейдите в раздел Настройки и выберите в селекторе нужный магазин.

3. В блоке Подключение нажмите кнопку Выпустить ключ Merchant API и скопируйте его значение.

   

   Также скопируйте значение Merchant ID. Эти данные понадобятся вам при настройке плагина в WordPress.

   

4. Нажмите Добавить Callback URL и укажите:

   {url_адрес_сайта}/wc-api/yandex-pay-and-split
   

   

   Нажмите кнопку Сохранить.

Шаг 2. Установка плагина

Добавить плагин в WordPress можно двумя способами: загрузить из установочного архива или установить из каталога плагинов.

Шаг 3. Настройка плагина

1. В левом меню административной панели WordPress перейдите в раздел Plugins → Installed Plugins.

   

2. В списке плагинов найдите Яндекс Пэй и Сплит и нажмите Активировать.

   

   Ошибка: Запрошенный URL-адрес не найден на этом сервере

   Если возникла ошибка «Запрошенный URL-адрес не найден на этом сервере», настройте значение постоянной ссылки (Permalink), чтобы плагин работал корректно:

   1. В левом меню административной панели перейдите в раздел Настройки → Permalinks.

      

   2. В разделе Common Settings выберите любое поле отличное от Plain.

      

   3. Прокрутите страницу с настройками вниз и сохраните изменения с помощью кнопки Save Changes.

      

3. Перейдите в настройки плагина одним из следующих способов:

   • В административной панели слева перейдите в раздел Plugins → Installed Plugins → Настройки.

     

   • В административной панели слева перейдите в раздел Woocommerce → Яндекс Пэй и Сплит.

     

4. Укажите параметры плагина в разделах настроек:

   Раздел настроек	Параметр	Описание
   Merchant	Merchant ID*	Укажите Merchant ID из личного кабинета Яндекс Пэй.
   	API-key* / API-ключ	Укажите API-ключ из личного кабинета Яндекс Пэй.
   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 width / Ширина кнопки	Выберите фиксированную или адаптивную ширину кнопки оплаты.
   	Icons theme / Тема иконки	Выберите тему иконки, которая будет отображаться на странице выбора метода оплаты рядом с методом оплаты.

5. При необходимости настройте бейджи и виджеты Яндекс Пэй.

6. Сохраните изменения.

Шаг 4. Включение/выключение метода оплаты

Модуль предоставляет два метода оплаты — Яндекс Пэй и Яндекс Сплит. Чтобы включить или выключить метод оплаты:

1. В левом меню административной панели перейдите в раздел Woocommerce → Настройки → Платежи.

   

2. Напротив нужного метода воспользуйтесь переключателем.

   

3. Сохраните изменения.

Шаг 5. Тестирование оплаты

Чтобы проверить корректность обработки платежей c помощью Яндекс Пэй, включите тестовый режим:

1. В личном кабинете Яндекс Пэй перейдите в раздел Настройки, выберите в селекторе нужный магазин и в правом верхнем углу включите опцию Тестовые данные.

   

2. Нажмите Добавить Callback URL Тестовый и укажите:

   {url_адрес_сайта}/wc-api/yandex-pay-and-split
   

   

   Нажмите кнопку Сохранить.

3. В левом меню административной панели WordPress перейдите в настройки плагина WooCommerce → Яндекс Пэй и Сплит → вкладка Общие и включите параметр Тестирование.

   

4. Сохраните изменения.

5. Выполните несколько тестовых платежей и возвратов в вашем магазине, чтобы проверить, что плагин установлен успешно.

Шаг 6. Переход в рабочий режим

После тестирования оплаты переключите среду с тестовой на боевую:

1. В личном кабинете Яндекс Пэй перейдите в раздел Настройки и отключите опцию Тестовая среда, чтобы скрыть тестовые настройки.

   

2. В левом меню административной панели WordPress перейдите в настройки плагина WooCommerce → Яндекс Пэй и Сплит → вкладка Общие и выключите параметр Тестирование.

   

3. Сохраните изменения.

Настройка модуля завершена. Теперь клиенты в вашем магазине могут оплачивать покупки при помощи Яндекс Пэй и Сплит.

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

Оформление возвратов

В административной панели WordPress вы можете оформить полный или частичный возврат средств по заказу:

1. Откройте заказ, для которого необходимо оформить возврат, и в левом нижнем углу нажмите кнопку Refund.

   

2. Для каждого товара отобразятся поля для ввода количества единиц и суммы возврата:

   

   Укажите количество единиц или сумму, которую вы хотите вернуть, — в правом нижнем углу окна в поле Refund amount отобразится итоговая сумма к возврату.

3. Нажмите кнопку Refund via Yandex Pay, чтобы оформить возврат.

Подключение бейджей и виджетов Яндекс Пэй

Бейджи

Бейджи Яндекс Пэй могут отображаться на странице с товарами и в карточке товара:

Чтобы подключить и настроить в вашем магазине бейджи Яндекс Пэй:

1. В левом меню административной панели WordPress перейдите в настройки плагина и в разделе Badges / Бейджи активируйте опцию Enable badges (Включить бейджи).

   

2. Настройте параметры бейджей в двух блоках:

   • Badge loop settings — настройки бейджей на странице с товарами.

   • Badge single page settings — настройки бейджей в карточке товара.

   
   

   Раздел настроек	Параметр	Описание
   Badge BNPL / Бейдж Сплита	Color / Цвет	Выберите цвет бейджа.
   	Variant / Вариант отображения	Выберите вариант отображения бейджа.
   	Theme / Тема	Выберите тему бейджа.
   	Size / Размер	Выберите размер бейджа.
   	Align / Выравнивание	Выберите выравнивание бейджа.
   Badge cashback / Бейдж кешбэка баллами Плюса	Color / Цвет	Выберите цвет бейджа.
   	Variant / Вариант отображения	Выберите вариант отображения бейджа.
   	Theme / Тема	Выберите тему бейджа.
   	Size / Размер	Выберите размер бейджа.
   	Align / Выравнивание	Выберите выравнивание бейджа.

3. Сохраните изменения.

Виджеты

Виджеты Яндекс Пэй могут отображаться в карточке товара и на странице выбора способа оплаты:

Чтобы подключить и настроить в вашем магазине виджеты Яндекс Пэй:

1. В административной панели WordPress перейдите в настройки плагина и в разделе Widgets / Виджеты активируйте опцию Enable widgets (Включить виджеты).

   

2. Настройте параметры виджетов:

   
   

   Параметр	Описание
   Theme / Тема	Выберите тему виджета.
   Padding / Внутренний отступ	Выберите внутренний отступ для виджета.
   Size / Размер	Выберите размер виджета.
   Outline / Обводка	Параметр отвечает за включение/выключение обводки виджета.
   Background / Фон	Выберите фон виджета.
   Hide header / Скрыть заголовок	Параметр отвечает за включение/выключение заголовка (шапки) виджета.

3. Сохраните изменения.