--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://pay.yandex.ru/docs/ru/console/settings-pay-split.md - href: ru/console/settings-pay-split.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt # Магазины с Яндекс Пэй и Сплит Чтобы настроить способы оплаты для магазинов, к которым подключен сервис Яндекс Пэй и Сплит, при первом переходе в раздел **Настройки** выберите способ интеграции: - **По API и SDK** — если вы настраиваете интеграцию с помощью API. - **C модулем** — если вы используете готовый модуль. Выберите название вашей CMS. При необходимости способ интеграции можно будет изменить. {% note info %} Параллельно с полноценной интеграцией вам доступна оплата [по ссылке](#available-services), которая не требует настройки API. {% endnote %} ## Парамеры интеграции {#parameters} Для настройки интеграции вам понадобятся: - [Merchant ID](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-id) магазина, для которого вы настраиваете интеграцию - [Ключ Merchant API](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#merchant-api-keys) (API-ключ) - [Callback URL](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#callback-settings) - [Client ID и параметры мобильного приложения](https://pay.yandex.ru/docs/ru/console/settings-pay-split.md#id-settings) для интеграции с Яндекс Пэй и Сплит {% note info %} Значения параметров отличаются для тестовой и боевой сред. Чтобы посмотреть настройки для каждой среды, в правом верхнем углу раздела используйте опцию **Тестовые данные**. Подробнее о настройке тестовой среды читайте в разделе [Тестирование](https://pay.yandex.ru/docs/ru/testing.md#pay-split). {% endnote %} ### Как узнать Merchant ID {#merchant-id} Чтобы узнать уникальный Merchant ID магазина, выберите в селекторе нужный магазин и перейдите в раздел **Настройки** → **Merchant ID**. ### Выпуск API-ключа {#merchant-api-keys} При [тестировании сервиса](https://pay.yandex.ru/docs/ru/testing.md) в качестве ключа Merchant API используется Merchant ID магазина. Дополнительно выпускать API‑ключ не требуется. Для работы в боевой среде необходимо выпустить собственный API-ключ в личном кабинете Яндекс Пэй: 1. Проверьте, что в селекторе выбран нужный магазин, и перейдите в раздел [Настройки](https://console.pay.yandex.ru/settings) → **Выпустить ключ Merchant API**. 1. В открывшемся окне отобразится API-ключ. Скопируйте и сохраните его. {% note tip %} После создания ключа рекомендуем сразу сохранить его, так как полное значение отображается только один раз — в момент создания. Повторно просмотреть уже созданный ключ не получится. {% endnote %} 1. Если ранее вы использовали другой API-ключ для тестирования или работы, в коде бэкенда магазина замените текущий API-ключ на новый. Если вы потеряете или забудете API-ключ, его нужно будет выпустить повторно. Для выпуска ключа в настройках нажмите **Ключ Merchant API** → **Выпустить еще ключ**. Одновременно для магазина можно выпустить не более трех API-ключей. ### Установка Callback URL {#callback-settings} {% note info %} Устанавливать параметр Callback URL не обязательно, если вы планируете использовать сервис для получения [прямой ссылки на платежную форму](../custom/integration-guide-link) без использования нотификаций при помощи [/webhook](../custom/backend/merchant-api/webhook). {% endnote %} 1. Перейдите в раздел [Настройки](https://console.pay.yandex.ru/settings) → **Добавить Callback URL**. 1. В открывшемся окне укажите публично доступный 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](../custom/backend/merchant-api/index) справочника разработчика. ### Установка Client ID и параметров мобильного приложения {#id-settings} Чтобы интегрировать Яндекс Пэй с мобильным приложением, выполните следующие шаги: ##### Шаг 1. Добавьте Client ID {#add-client-id} 1. Зайдите в раздел **Настройки** → **Добавить Client ID**. 1. В открывшемся окне укажите идентификатор Client ID вашего приложения и нажмите кнопку **Сохранить**. {% note warning %} Чтобы получить идентификатор Client ID, предварительно [зарегистрируйте](https://yandex.ru/dev/id/doc/ru/register-client) свое приложение в сервисе [Яндекс OAuth](https://oauth.yandex.ru/). {% endnote %} Вы можете добавить до 150 Client ID. ##### Шаг 2. Добавьте приложение {#add-app} Если у вас несколько приложений, вы можете привязать их к одному Client ID в личном кабинете Яндекс Пэй. 1. Зайдите в раздел **Настройки** → **Добавить приложения**. 1. В открывшемся окне выберите Client ID вашего приложения и отметьте платформы, на которых оно расположено (iOS, Android). 1. Для настройки редиректа после оплаты укажите параметры приложения: - **iOS AppID** — для iOS; - **Android package name** и **SHA256 Fingerprint** — для Android. 1. Чтобы добавить параметры второго приложения, нажмите кнопку **Добавить** под соответствующим параметром. {% note info %} Как получить параметры приложения, читайте в разделах документации для мобильных SDK: - [Android](../custom/mobile-sdk/legacy/android-sdk/preparing#create-oauth-app) - [iOS](../custom/mobile-sdk/legacy/ios-sdk/url-flow#setup-client-id) {% endnote %} ## Настройка CMS-модуля {#cms} Если вы настраиваете интеграцию с помощью готового модуля, нажмите **Добавить CMS** и выберите название модуля. При необходимости выбор можно изменить. Список доступных модулей и инструкции по интеграции смотрите в разделе [Готовые модули](https://pay.yandex.ru/docs/ru/cms/index.md). ## Настройка облачной кассы {#cloud-cash-register} Облачная касса нужна, чтобы отправлять фискальные чеки покупателям и передавать данные в [ФНС](*fns) через оператора фискальных данных в соответствии с требованиями [ФЗ-54](https://www.consultant.ru/document/cons_doc_LAW_42359/). {% note warning %} В личном кабинете Яндекс Пэй можно подключить облачную кассу **АТОЛ Онлайн** или **CloudKassir**, при условии что магазин интегрирован через [API](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/index.md) или готовый модуль [Tilda](https://pay.yandex.ru/docs/ru/cms/tilda-yandex/index.md), [1C-Битрикс](https://pay.yandex.ru/docs/ru/cms/bitrix/1c-bitrix.md) или [WordPress](https://pay.yandex.ru/docs/ru/cms/wordpress/index.md) от Яндекса. Если вы используете другую онлайн-кассу или модуль, самостоятельно настройте отправку фискальных чеков покупателям. {% endnote %} 1. В разделе **Настройки** в блоке **Облачная касса** нажмите **Подключить облачную кассу**. 1. Выберите из списка кассу и нажмите кнопку **Продолжить**. 1. Последовательно заполните данные в зависимости от кассы, которую выбрали: {% list tabs %} - АТОЛ - адрес сайта вашего магазина — будет отображен покупателю в чеке; - электронная почта для связи — будет отображена покупателю в чеке; - система налогообложения, которую вы используете; - логин, пароль и код группы касс в системе АТОЛ. {% note info %} Адрес сайта магазина и электронная почта могут отличаться от тех данных, которые вы указали при регистрации в личном кабинете Яндекс Пэй. {% endnote %} - CloudKassir - адрес сайта вашего магазина — будет отображен покупателю в чеке; - электронная почта для связи — будет отображена покупателю в чеке; - система налогообложения, которую вы используете; - Public ID — идентификатор магазина из личного кабинета CloudKassir; - Пароль для API — секретный ключ из личного кабинета CloudKassir. {% endlist %} 1. Нажмите кнопку **Продолжить**. В течение нескольких минут касса будет подключена. 1. Завершите настройку в зависимости от способа интеграции, который вы используете: {% list tabs %} - API Настройте в запросе на создание заказа передачу минимального набора полей для фискализации. Перечень полей и пример Body для фискализации см. в описании метода [/orders](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md). {% note info %} При интеграции по API фискализация работает, только если вы используете [базовую механику](https://pay.yandex.ru/docs/ru/payments/basic.md) приема оплаты. {% endnote %} - Tilda (Яндекс) Настройте НДС в личном кабинете Tilda: 1. Перейдите в раздел **Настройки сайта** → **Платежные системы** → **Яндекс Пэй и Сплит**. 1. В поле **Электронные чеки (РФ)** выберите соответствующую ставку НДС для вашего бизнеса. ![Выбор ставки НДС в настройках Tilda](../cms/tilda-yandex/_assets/tilda-12.png){.c-screenshot width=400px} {% note warning %} Чтобы данные о покупке передавались в платежную систему корректно, оформление заказа на сайте должно происходить через [корзину Tilda](https://help-ru.tilda.cc/online-store/cart). {% endnote %} 1. Убедитесь, что в параметре Receipt передаются обязательные параметры для фискализации в соответствии с требованиями [ФФД 1.05](*ffd): - **payment_method** — признак способа расчета; - **payment_object** — признак предмета расчета. Возможные значения параметров см. в статье Tilda [Как передавать данные для онлайн-кассы](https://help-ru.tilda.cc/online-store/online-kassa). - 1C-Битрикс Настройте НДС для ваших товаров в личном кабинете 1C-Битрикс — используйте для этого [материалы обучающего курса](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&CHAPTER_ID=03069&LESSON_PATH=3912.4580.4828.3069) от 1С-Битрикс. - WordPress Включите и настройте НДС в административной панели WordPress: 1. Перейдите в раздел **WooCommerce** → **Настройки** → вкладка **Общие**. 1. Прокрутите страницу вниз до раздела **Налоги и купоны**, активируйте опцию **Включить налоговые ставки и расчёты** и сохраните изменения. 1. Далее перейдите на вкладку **Налог** и настройте параметры налогов в зависимости от режима налогообложения, который вы используете. Подробнее о настраиваемых параметрах см. в [документации WooCommerce](https://woocommerce.com/document/setting-up-taxes-in-woocommerce/#configuring-tax-options). {% endlist %} 1. После того как вы завершите настройку фискализации, убедитесь, что транзакции проходят корректно и чеки формируются без ошибок. ## Настройка оплаты через ссылку {#available-services} В разделе **Настройки** в блоке **Оплата по ссылке** по умолчанию подключен способ оплаты Яндекс Пэй со Сплитом (полные оплаты и оплаты частями). Чтобы клиенты вашего магазина оплачивали товары только частями, включите опцию **Только частями в Сплит** и в открывшемся окне нажмите кнопку **Да, изменить**. Подробно про способ оплаты по ссылке читайте в разделе [Создание ссылки на оплату](../console/create-link). [*fns]: Федеральная налоговая служба [*ffd]: Обязательный с 1 января 2019 года формат фискальных данных для онлайн-касс.