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

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

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

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

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

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

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

Как узнать Merchant ID

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

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

При тестировании сервиса в качестве ключа Merchant API используется Merchant ID магазина. Дополнительно выпускать API‑ключ не требуется.

Для работы в боевой среде необходимо выпустить собственный 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-адрес для тестового и рабочего окружения может отличаться, например:

Тип окружения	Callback 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 и выберите название модуля. При необходимости выбор можно изменить.

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

Настройка облачной кассы

Облачная касса нужна, чтобы отправлять фискальные чеки покупателям и передавать данные в ФНС через оператора фискальных данных в соответствии с требованиями ФЗ-54.

1. В разделе Настройки в блоке Облачная касса нажмите Подключить облачную кассу.

2. Выберите из списка кассу и нажмите кнопку Продолжить.

3. Последовательно заполните данные в зависимости от кассы, которую выбрали:

   АТОЛ

   CloudKassir

   • адрес сайта вашего магазина — будет отображен покупателю в чеке;
   • электронная почта для связи — будет отображена покупателю в чеке;
   • система налогообложения, которую вы используете;
   • логин, пароль и код группы касс в системе АТОЛ.

   Примечание

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

   • адрес сайта вашего магазина — будет отображен покупателю в чеке;
   • электронная почта для связи — будет отображена покупателю в чеке;
   • система налогообложения, которую вы используете;
   • Public ID — идентификатор магазина из личного кабинета CloudKassir;
   • Пароль для API — секретный ключ из личного кабинета CloudKassir.

4. Нажмите кнопку Продолжить. В течение нескольких минут касса будет подключена.

5. Завершите настройку в зависимости от способа интеграции, который вы используете:

   API

   Tilda (Яндекс)

   1C-Битрикс

   WordPress

   Настройте в запросе на создание заказа передачу минимального набора полей для фискализации. Перечень полей и пример Body для фискализации см. в описании метода /orders.

   Примечание

   При интеграции по API фискализация работает, только если вы используете базовую механику приема оплаты.

   Настройте НДС в личном кабинете Tilda:

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

   2. В поле Электронные чеки (РФ) выберите соответствующую ставку НДС для вашего бизнеса.

      

      Важно

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

   3. Убедитесь, что в параметре Receipt передаются обязательные параметры для фискализации в соответствии с требованиями ФФД 1.05:

      • payment_method — признак способа расчета;
      • payment_object — признак предмета расчета.

      Возможные значения параметров см. в статье Tilda Как передавать данные для онлайн-кассы.

   Настройте НДС для ваших товаров в личном кабинете 1C-Битрикс — используйте для этого материалы обучающего курса от 1С-Битрикс.

   Включите и настройте НДС в административной панели WordPress:

   1. Перейдите в раздел WooCommerce → Настройки → вкладка Общие.

   2. Прокрутите страницу вниз до раздела Налоги и купоны, активируйте опцию Включить налоговые ставки и расчёты и сохраните изменения.

   3. Далее перейдите на вкладку Налог и настройте параметры налогов в зависимости от режима налогообложения, который вы используете.

      Подробнее о настраиваемых параметрах см. в документации WooCommerce.

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

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

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

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

Федеральная налоговая служба

Обязательный с 1 января 2019 года формат фискальных данных для онлайн-касс.