--- metadata: - name: generator content: Diplodoc Platform v5.48.2 alternate: - https://yandex.uz/support/split-business/en/custom/pay-offline.md - https://yandex.uz/support/split-business/ru/custom/pay-offline.md - https://yandex.uz/support/split-business/uz/custom/pay-offline.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.uz/support/split-business/ru/llms.txt # Интеграция для офлайн-магазинов ## План интеграции {#plan} 1. Убедитесь, что в помещении, в котором располагается ваш офлайн-магазин, обеспечена стабильная работа мобильного интернета, чтобы клиент мог перейти к оплате. 1. [Подайте заявку](https://yandex.uz/support/split-business/ru/console/registration.md#application) в личном кабинете и дождитесь письма об активации [тестовой](../testing) среды. 1. На бэкенде магазина настройте передачу параметров оплаты с помощью метода [/orders](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md): {% cut "Пример параметров" %} | **Параметр** | **Описание** | | ------------------------- | ------------------------------------------------------------ | | `availablePaymentMethods` | Доступные клиенту методы оплаты | | `cart` | Свойства корзины товаров, включая код и наименование товаров | | `managerId` | Задает код продавца | | `branchId` | Задает код магазина | {% endcut %} 1. Проверьте работу сервиса в тестовой среде: 1. В верхнем правом углу страницы раздела [Настройки](https://console.pay.yandex.uz/settings) включите опцию **Тестовые данные**. 1. [Заполните](https://yandex.uz/support/split-business/ru/console/settings-pay-split.md#callback-settings) поле **Callback URL `Тестовый`**, если хотите, чтобы Yandex Split присылал [уведомления](../custom/backend/merchant-api/webhook) по Merchant API. 1. [Настройте](https://yandex.uz/support/split-business/ru/custom/backend/merchant-api/index.md) декодирование сообщений. 1. Проведите [тестирование](../testing). 1. После получения уведомления о подключении сервиса переключите среду с тестовой на боевую: 1. В разделе **Настройки** скройте тестовые настройки, выключив опцию **Тестовые данные**. 1. [Заполните](https://yandex.uz/support/split-business/ru/console/settings-pay-split.md#callback-settings) поле **Callback URL**. 1. [Выпустите API-ключ](https://yandex.uz/support/split-business/ru/console/settings-pay-split.md#merchant-api-keys). 1. Не забудьте про фискализацию. Вы готовы принимать оплату. ## Способы и методы оплаты для офлайн-магазинов {#payment} ### Способы оплаты Покупатели вашего магазина могут оплачивать покупки любой банковской картой, которая привязана к аккаунту Яндекс ID. ### Методы оплаты Проведение оплаты в офлайн-магазине, в котором подключен сервис Yandex Split возможно с помощью прямого QR. Прямой QR — оплата, при которой пользователь сканирует динамический QR-код, который размещен на поверхностях продавца: мониторах, экранах телефонов менеджеров, чеках, ценниках и других носителях. {% list tabs %} - Прямой QR Оплата покупки включает в себя несколько этапов. 1. Генерация прямого QR-кода. 1. Пользователь выбирает товары, которые он хочет купить. 1. Продавец формирует корзину товаров в кассовой программе. Когда пользователь готов оплатить товары, продавец выбирает вид оплаты и нажимает кнопку создания заказа. 1. После нажатия кнопки оплаты на стороне партнера блокируется корзина товаров и создается заказ, который через бэкенд магазина передается в Yandex Split с помощью метода [/orders](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md). В ответ возвращается ссылка на форму оплаты Yandex Split для проведения оплаты пользователем. {% note alert %} В методе [/orders](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v1_orders-post.md) необходимо передать код продавца `managerId` и код магазина `branchId`, в котором происходит оплата. Также продавец передает способы оплаты , доступные для этого заказа. {% endnote %} 1. На основе полученной ссылки на оплату необходимо сгенерировать QR-код и вывести его на один из носителей, доступных пользователю для сканирования камерой телефона или приложения Yandex Split: - экраны и мониторы; - чек или распечатка QR-кода. Возможно использование стороннего сервиса для создания QR-кода из ссылки. Например, можно использовать сервис [QR Code Generator](https://goqr.me/api/). 1. Оплата пользователем. 1. Пользователь сканирует созданный продавцом QR-код через камеру телефона или в приложении Yandex Split: - Если у пользователя не установлено приложение Yandex Split, то после перехода по ссылке или сканирования QR-кода процесс оплаты происходит в браузере. - Если у пользователя установлено приложение Yandex Split, то после перехода по ссылке или сканирования QR-кода процесс оплаты происходит в приложении. 1. Пользователь переходит на форму оплаты Yandex Split, которая содержит корзину и сумму к оплате. 1. Пользователь выбирает способ (частями в сплит) и нажимает кнопку оплаты. При оплате частями пользователь выбирает количество платежей и производит оплату первого платежа со своей сохраненной в Яндексе банковской карты. 1. Проведение платежа. 1. Yandex Split проводит платеж, списывая денежные средства с выбранной карты пользователя. 1. Yandex Split уведомляет бэкенд магазина о статусе платежа через вызов [/webhook](https://yandex.uz/support/split-business/ru/custom/backend/merchant-api/webhook.md), если был настроен Callback URL. Бэкенд магазина может самостоятельно запросить статус заказа через запрос [/orders/{order_id}](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md). {% cut "Статусы оплаты" %} - `PENDING` — оплата еще в процессе, нужно запросить статус платежа позже. В уведомлении этот статус не отправляется. Продавец может прервать оплату с помощью метода [/orders/{orderId}/rollback](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v1_rollback-post.md) в одном из случаев: - пользователь отказался от покупки; - появилась необходимость отменить покупку; - произошло зависание кассовой программы. - `FAILED` — оплата завершилась неудачно. Терминальный неуспешный статус. - `CAPTURED` — оплата успешно совершена, можно печатать чек. Терминальный успешный статус. {% endcut %} 1. Необходимо распечатать чек через кассовую программу. Покупка успешно совершена. На следующий рабочий день деньги в размере полной стоимости покупки поступят на расчетный счет организации офлайн-магазина. {% cut "Схема процесса оплаты" %} {% endcut %} {% endlist %} ## Проведение возврата {#refund} Провести возврат можно двумя способами: - в личном кабинете в разделе [Платежи](https://yandex.uz/support/split-business/ru/custom/refund-payments.md#payment-refund); - при помощи запросов к [API](https://yandex.uz/support/split-business/ru/custom/refund-payments.md#api-refund).