Яндекс Пэй и Сплит

Начиная с версии 4.22.1, в русских версиях CS-Cart и Multi-Vendor доступен модуль Яндекс Пэй и Сплит. Он позволяет принимать платежи через Яндекс Пэй и предлагать покупателям оплату частями через Сплит.

Сплит позволяет покупателю разделить платеж на несколько частей, а продавцу — получить всю стоимость покупки сразу. Это не распределение платежа между продавцами маркетплейса.

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

  • Merchant ID — идентификатор магазина.
  • Ключ Merchant API — ключ для обращения к Яндекс Пэй.

Сплит может потребовать отдельного подключения на стороне Яндекса. Выбор Сплита в настройках CS-Cart сам по себе не подключает эту услугу. Подробнее см. в документации Яндекс Пэй.

Чтобы создать способ оплаты:

  1. На странице Модули → Скачанные модули установите и включите модуль Яндекс Пэй и Сплит. Для его работы также требуется модуль Налоговые ставки РФ.
  2. Перейдите на страницу Настройки → Способы оплаты.
  3. Добавьте способ оплаты, нажав соответствующую кнопку.
  4. На вкладке Общее выберите процессор Yandex Pay в списке российских способов оплаты.
  5. Задайте название, которое покупатели увидят при оформлении заказа, и заполните остальные общие настройки способа оплаты.

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

Перейдите на вкладку Настроить и заполните параметры интеграции.

  1. Укажите реквизиты для интеграции: заполните Merchant ID и Ключ Merchant API.

  2. Укажите режим работы:

    • Тестовый режим выбирается для проверки интеграции. В нем в качестве API-ключа используется Merchant ID.
    • Рабочий режим выбирается для приема реальных платежей. В нем необходимо указать отдельный API-ключ, полученный в кабинете Яндекс Пэй.

    Примечание

    Для тестирования в кабинете Яндекс Пэй включите отображение тестовых данных и укажите Callback URL из настроек способа оплаты в CS-Cart. В CS-Cart выберите тестовый режим и заполните тестовые реквизиты.

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

  3. Выберите доступные способы оплаты:

    • Карта и Сплит (по умолчанию) — покупатель сможет выбрать вариант оплаты на стороне Яндекса, если Сплит ему доступен.
    • Только карта — оплата без Сплита.

    Примечание

    Доступность Сплита зависит от подключения услуги и условий Яндекса.

  4. Настройте отображение при оформлении заказа:

    • Перенаправление (по умолчанию) — покупатель размещает заказ стандартной кнопкой магазина, затем переходит на страницу оплаты Яндекса.
    • Кнопка Яндекс Пэй — при оформлении заказа отображается кнопка Яндекс Пэй. Она позволяет показать доступность Сплита до оплаты.

Статусы заказов

Выберите в выпадающих списках, какой статус должен получать заказ после:

  • успешной оплаты;
  • неудачной оплаты;
  • полного возврата средств;
  • частичного возврата средств.

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

Обратите внимание на статус после частичного возврата. По умолчанию для полного и частичного возврата используется статус Аннулирован. Если после частичного возврата вы продолжаете выполнять заказ, выберите подходящий статус.

Сохраните способ оплаты.

Подключение уведомлений от Яндекса

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

  1. Скопируйте Callback URL из раздела информации на вкладке Настроить.
  2. Укажите его в настройках уведомлений в кабинете Яндекс Пэй.
  3. Сохраните настройки на стороне Яндекса.

Если CS-Cart показывает адреса нескольких витрин, выберите адрес витрины, используемой для интеграции. В кабинете Яндекса для одного аккаунта магазина задается один адрес уведомлений.

Примечание

Без Callback URL статус оплаченного заказа обновляется только при возвращении покупателя в магазин. Статусы возвратов автоматически обновляться не будут. Периодический опрос Яндекса для проверки возвратов не предусмотрен.

Проверка подключения

Перед началом приема платежей проверьте оформление заказа, переход к оплате и обновление статуса заказа после завершения оплаты. Если используете кнопку Яндекс Пэй, проверьте ее отображение на витрине.

В информации об оплате заказа доступны идентификатор заказа Яндекс Пэй и сведения о состоянии платежа. Запросы к сервису и ошибки можно проверить в журнале событий CS-Cart.

Возврат денежных средств

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

Сумма возврата определяется уменьшением итоговой стоимости заказа при обработке запроса. Отправленный запрос еще не означает, что деньги возвращены: результат операции поступает отдельно. Подробнее см. в статье Как работать с запросами на возврат.

Примечание

В текущей версии интеграции не реализована передача данных для формирования чеков через онлайн-кассу, подключенную к Яндекс Пэй.