Инструкция к модулю Оплата Яндекс Пэй и Сплит

Модуль добавляет в CS-Cart процессор оплаты Yandex Pay, позволяет принимать оплату через Яндекс Пэй и Яндекс Сплит, выводить виджеты/бейджи Яндекса на витрине и сопоставлять результат оплаты со статусами заказа.

Что делает модуль

• Добавляет платёжный процессор MS: Yandex Pay для способов оплаты CS-Cart.
• Создаёт заказ в Yandex Pay API и перенаправляет покупателя на полученную платёжную ссылку.
• Позволяет выбрать доступные методы оплаты: только Яндекс Пэй, только Яндекс Сплит или оба варианта.
• Показывает виджет оплаты в карточке товара и, если включено в способе оплаты, на странице оформления заказа.
• Показывает бейджи Яндекса в каталоге и других витринных блоках.
• Передаёт в Яндекс контакт покупателя для фискализации: сначала e-mail, при его отсутствии — телефон.
• Меняет статус заказа после возврата покупателя с платёжной страницы по сопоставлению «Успешно» / «Неуспешно».

Где находится модуль

• Настройки модуля: Модули → Скачанные модули → Оплата Яндекс Пэй и Сплит.
• Способы оплаты: Администрирование → Способы оплаты или Модули → Способы оплаты, в зависимости от версии CS-Cart.
• Процессор в карточке способа оплаты: MS: Yandex Pay.

Данные Яндекса

Для настройки понадобятся данные из кабинета Yandex Pay:

• Merchant ID — идентификатор продавца. Он используется в настройках модуля для виджетов и в параметрах способа оплаты.
• API-ключ — ключ для рабочего режима. В рабочем режиме модуль передаёт его в заголовке Authorization: Api-Key.
• Тестовый режим — включается в параметрах способа оплаты. В тестовом режиме модуль использует тестовый API-адрес Яндекса и в качестве ключа авторизации использует значение Merchant ID.

Отдельного поля Client ID в коде модуля нет.

Настройки модуля

Общие

• Идентификатор продавца (Merchant ID) — Merchant ID для витринных виджетов.
• Сопоставление статусов заказа — выбор статуса CS-Cart для результата Успешно и Неуспешно. Если статус не выбран, используются значения по умолчанию: Open для успешной оплаты и Failed для неуспешной.

В магазинах с несколькими витринами выберите нужную витрину перед настройкой сопоставления статусов.

Виджет

• Варианты отображения виджета в карточке товара — расширенный вид, компактный вид или не отображать.
• Отображаемые методы в виджете способа оплаты — карта, Сплит или карта и Сплит.
• Конфигурация виджета — параметры Yandex Pay Web SDK. Их можно подготовить в интерактивном демо Яндекса и вставить в поле настроек.
• Позиция виджета на странице оформления заказа — не показывать, под итогом заказа или над товарами.
• Вид блока в checkout — свернутый, развернутый или простой.

Бейдж

• Отображать бейджи в каталоге товаров — включает вывод бейджа на витрине.
• Отображать второй бейдж — добавляет дополнительный бейдж.
• Позиция отображения бейджей — под ценой или под всем блоком товара.
• Конфигурация бейджа и Конфигурация второго бейджа — параметры Яндекса для внешнего вида бейджей. Модуль очищает из этих полей значения merchant-id, amount и sku-id, потому что они рассчитываются на витрине.

Создание способа оплаты

1. Откройте раздел способов оплаты и создайте новый способ оплаты.
2. Выберите процессор MS: Yandex Pay.
3. Включите или выключите Режим тестирования.
4. Заполните Идентификатор продавца (Merchant ID).
5. Заполните API-ключ для рабочего режима.
6. В поле Доступные методы оплаты выберите: Яндекс Пэй и Яндекс Сплит, Яндекс Пэй или Яндекс Сплит.
7. Если нужно показать виджет внутри способа оплаты на checkout, включите Показывать виджет на странице «Оформление заказа».
8. Сохраните способ оплаты и проверьте, что он доступен на нужной витрине и для нужных способов доставки.

Сценарий оплаты

1. Покупатель оформляет заказ и выбирает способ оплаты Yandex Pay.
2. Модуль отправляет в Яндекс запрос создания заказа с суммой, валютой, составом корзины, доставкой и разрешёнными методами оплаты.
3. Если в заказе есть e-mail покупателя, он передаётся в fiscalContact. Если e-mail нет, модуль передаёт телефон. Если контакта нет, поле не отправляется.
4. Яндекс возвращает paymentUrl, и модуль перенаправляет покупателя на страницу оплаты.
5. После успешного или неуспешного возврата модуль завершает оплату в CS-Cart и ставит заказу сопоставленный статус.

Webhook, hold, refund и чеки

• Webhook. Код модуля использует возвратные URL CS-Cart payment_notification.success и payment_notification.fail с номером заказа. Отдельной настройки webhook URL в интерфейсе модуля нет.
• Hold / capture. Отдельных настроек холдирования и подтверждения списания в модуле нет.
• Refund / возвраты. Отдельного интерфейса возвратов через Яндекс в модуле нет; возвраты выполняются вне модуля по правилам платёжного сервиса и магазина.
• Чеки и 54-ФЗ. Модуль передаёт в Яндекс контакт покупателя в fiscalContact, если он есть в заказе. Собственных настроек DigitalKassa, ставок НДС или формирования чеков в модуле нет.

Как проверить работу

1. Откройте карточку товара на витрине и проверьте, что виджет или бейдж отображается согласно настройкам модуля.
2. Добавьте товар в корзину и перейдите к оформлению заказа.
3. Выберите способ оплаты Yandex Pay и убедитесь, что набор методов соответствует настройке: Яндекс Пэй, Сплит или оба варианта.
4. Оформите тестовый заказ и проверьте, что покупатель перенаправляется на платёжную страницу Яндекса.
5. После возврата с платёжной страницы проверьте статус заказа в CS-Cart.
6. Для проверки фискального контакта оформите заказ с e-mail, затем заказ без e-mail, но с телефоном: модуль должен отправлять e-mail в первом случае и телефон во втором.