Интеграция с МойСклад

Платный модуль

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

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

Прием оплаты
Полный возврат
Частичный возврат	*
Бейджи Яндекс Пэй / Сплит
Виджеты Яндекс Пэй / Сплит
Тестовый режим	Неприменимо
Контроль наличия товара	Неприменимо
Синхронизация статуса оплаты	Неприменимо
Получение прямого QR
Получение обратного QR

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

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

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

2. Дождитесь одобрения заявки и подключения сервиса.

3. В личном кабинете Яндекс Пэй выберите в селекторе ваш магазин и перейдите в раздел Настройки.

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

   Где выпустить ключ API

   

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

   Где найти Merchant ID

   

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

Шаг 2. Установка модуля

1. В аккаунте МойСклад перейдите в раздел Приложения → категория Платежные системы → Яндекс Пэй.

   

2. Нажмите Установить.

   

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

1. Нажмите Перейти в приложение.

   

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

   

   1. В поля Merchant ID и Ключ Yandex Pay Merchant API укажите Merchant ID из личного кабинета Яндекс Пэй.

   2. Включите режим тестирования.

   3. Скопируйте URL для callback-уведомлений:

      

3. Готово. Вернитесь в приложение МойСклад.

   

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

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

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

2. В блоке Подключение нажмите Добавить Callback URL Тестовый и укажите скопированный URL для callback-уведомлений.

   Куда добавить тестовый Callback URL

   

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

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

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

1. Дождитесь статуса активации вашего аккаунта сотрудником технической поддержки Яндекс Пэй.

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

2. В настройках приложения RetailCRM:

   1. Отключите режим тестирования.
   2. В поле Ключ Yandex Pay Merchant API укажите API-ключ из личного кабинета Яндекс Пэй.
   3. Скопируйте URL для callback-уведомлений.

3. В личном кабинете Яндекс Пэй:

   1. Перейдите в раздел Настройки и отключите опцию Тестовые данные, чтобы скрыть тестовые настройки.
   2. В блоке Подключение нажмите Добавить Callback URL и укажите скопированный URL для callback-уведомлений.

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

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

Дополнительно

Работа с виджетом

После завершения интеграции станет доступен встроенный виджет в разделах Счета покупателям и Заказы покупателей. С помощью данного виджета вы сможете создавать ссылки на оплату для ваших клиентов. Нажмите кнопку Создать ссылку на оплату.

После создания ссылки на оплату приложение запишет ссылку в дополнительное поле. Также ссылка будет доступна для копирования до перехода транзакции в статус Оплачено.

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

Оформление оплаты

1. Для проведения теста воспользуйтесь ссылкой на оплату, полученной при описании функциональностей виджета.

   

   В нашем случае, для тестирования ссылки на оплату, мы воспользуемся ссылкой, которую создали ранее при описании функционала виджета. Кликните по ссылке для перехода к оплате.

   

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

   

2. Нажмите Вернуться в магазин.

   Заказу или сделке будет присвоен статус Оплачено и в приложении будет добавлен Входящий платеж, а менеджеру приложения будет добавлена задача на проверку оплаты.

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

Виджет поддерживает функционал возврата оплаты, для этого необходимо нажать кнопку Возврат оплаты.

Приложение попросит вас подтвердить операцию.

После нажатия на кнопку Возврат оплаты будет отправлен запрос в банк на совершение операции. Результат будет отображаться в виджете. После совершения операции возврата у счета или заказа будет присвоен статус Возврат.