Магазины с Яндекс Пэй и Сплит

Чтобы настроить способы оплаты для магазинов, к которым подключен сервис Яндекс Пэй и Сплит, при первом переходе в раздел Настройки выберите способ интеграции:

• По API и SDK — если вы настраиваете интеграцию с помощью API.
• C модулем — если вы используете готовый модуль. Выберите название вашей CMS.

При необходимости способ интеграции можно будет изменить.

Парамеры интеграции

Для настройки интеграции вам понадобятся:

• Merchant ID магазина, для которого вы настраиваете интеграцию
• Ключ Merchant API (API-ключ)
• Callback URL
• Client ID и параметры мобильного приложения для интеграции с Яндекс Пэй и Сплит

Как узнать Merchant ID

Чтобы узнать уникальный Merchant ID магазина, выберите в селекторе нужный магазин и зайдите в раздел Настройки → Merchant ID.

Выпуск API-ключа

При тестировании сервиса ключ Merchant API (далее — API-ключ) идентичен значению Merchant ID. Для работы в боевой среде необходимо выпустить собственный API-ключ в личном кабинете Яндекс Пэй:

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

2. В открывшемся окне отобразится API-ключ. Скопируйте и сохраните его.

   Совет

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

3. Если ранее вы использовали другой API-ключ для тестирования или работы, в коде бэкенда магазина замените текущий API-ключ на новый.

Если вы потеряете или забудете API-ключ, его нужно будет выпустить повторно. Для выпуска ключа в настройках нажмите Ключ Merchant API → Выпустить ещё ключ. Одновременно для магазина можно выпустить не более трех API-ключей.

Установка Callback URL

1. Зайдите в раздел Настройки → Добавить Callback URL.
2. В открывшемся окне укажите публично доступный HTTPS URL-адрес бэкенда магазина, для которого вы настраиваете интеграцию, и нажмите кнопку Сохранить.

Указывайте Callback URL без /v1/webhook — этот путь добавится автоматически, например:

Callback URL	Куда придет запрос
https://example.merchant.ru	https://example.merchant.ru/v1/webhook
https://example.merchant.ru/v1/webhook	https://example.merchant.ru/v1/webhook/v1/webhook

URL-адрес для тестового и рабочего окружения может отличаться, например:

Тип окружения	URL-адрес
Рабочее (Production)	https://example.merchant.ru
Тестовое (Testing)	https://sandbox.example.merchant.ru

Подробнее о нотификациях читайте в разделе Merchant API справочника разработчика.

Установка Client ID и параметров мобильного приложения

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

Шаг 1. Добавьте Client ID

1. Зайдите в раздел Настройки → Добавить Client ID.

2. В открывшемся окне укажите идентификатор Client ID вашего приложения и нажмите кнопку Сохранить.

   Важно

   Чтобы получить идентификатор Client ID, предварительно зарегистрируйте свое приложение в сервисе Яндекс OAuth.

   Вы можете добавить до 150 Client ID.

Шаг 2. Добавьте приложение

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

1. Зайдите в раздел Настройки → Добавить приложения.

2. В открывшемся окне выберите Client ID вашего приложения и отметьте платформы, на которых оно расположено (iOS, Android).

3. Для настройки редиректа после оплаты укажите параметры приложения:

   • iOS AppID — для iOS;
   • Android package name и SHA256 Fingerprint — для Android.

4. Чтобы добавить параметры второго приложения, нажмите кнопку Добавить под соответствующим параметром.

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

Если вы настраиваете интеграцию с помощью готового модуля, нажмите Добавить CMS и выберите название модуля. При необходимости выбор можно изменить.

Список доступных модулей и инструкции по интеграции смотрите в разделе Готовые модули.

Настройка оплаты через ссылку

В разделе Настройки в блоке Оплата по ссылке по умолчанию подключен способ оплаты Яндекс Пэй со Сплитом (полные оплаты и оплаты частями). Чтобы клиенты вашего магазина оплачивали товары только частями, включите опцию Только частями в Сплит и в открывшемся окне нажмите кнопку Да, изменить.

Подробно про способ оплаты по ссылке читайте в разделе Создание ссылки на оплату.