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

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

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

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

Примечание

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

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

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

Примечание

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

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

Как узнать 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

Примечание

Устанавливать параметр Callback URL не обязательно, если вы планируете использовать сервис для получения прямой ссылки на платежную форму без использования нотификаций при помощи /webhook.

  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. Чтобы добавить параметры второго приложения, нажмите кнопку Добавить под соответствующим параметром.

Примечание

Как получить параметры приложения, читайте в разделах документации для мобильных SDK:

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

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

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

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

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

Важно

Подключить облачную кассу в личном кабинете Яндекс Пэй можно, если вы используете кассу АТОЛ Онлайн и магазин интегрирован через API или готовый модуль Tilda от Яндекса.

Если вы используете другую онлайн-кассу или модуль, самостоятельно настройте отправку фискальных чеков покупателям.

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

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

  3. Последовательно заполните данные:

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

    Примечание

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

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

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

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

    Примечание

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

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

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

      Важно

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

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

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

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

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

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

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

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

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

Обязательный с 1 января 2019 года формат фискальных данных для онлайн-касс.
Предыдущая
Настройки
Следующая
QR‑код от Яндекс Пэй