Как интегрировать сервис со своим интернет-магазином

Интегрировать на сайт. Есть несколько способов встроить Долями на сайт:

• по API;
• через CMS-модули;
• с помощью интернет-эквайринга Т-Кассы, если он уже подключен.

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

Без интеграции. В этом случае менеджер сам создает заказы в своем личном кабинете и передает их на оплату по QR-коду. Как его сформировать, написали в инструкции, которую разместили в личном кабинете менеджера.

Все вопросы по окончании интеграции можно задавать в чате в личном кабинете или на почту partners@dolyame.ru.

MTLS-сертификат обеспечивает безопасный обмен данными между магазином и Долями. Его можно выпустить одним из двух способов:

• с помощью плагина КриптоПро;
• с подписанием заявки вручную.

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

Чтобы выпустить сертификат с помощью плагина КриптоПро:

1. Перейдите в личный кабинет руководителя → в верхнем меню «Все сервисы» → «Сервисы» → «Интеграции».

3. Нажмите на стрелку в строке «Для какого сервиса нужен сертификат». В выпадающем меню выберите сервис «Долями» и нажмите «Дальше».

5. Нажмите «Отправить заявку». Откроется окно подтверждения, в котором нужно разрешить выпуск сертификата, — для этого нажмите «Да».

6. Заявка на выпуск сертификата отправлена. Процесс длится около 10 минут, статус можно отслеживать на странице «Сервисы» → «Интеграции» → T-API → «Сертификаты».

На странице с сертификатами вы можете:

• На вкладке «Действуют» — скачать сертификат, посмотреть срок действия, перевыпустить его или выпустить новый.
• На вкладке «Не действуют» — посмотреть невыпущенные сертификаты или выпустить новый.
• На вкладке «Выпускаются» — посмотреть ваши незавершенные заявки на выпуск сертификата, перейти к подписанию заявки или отменить ее.

Срок действия сертификата — год. Он пригодится для заполнения настроек Долями через CMS-модули или для дополнительной защиты API-запросов. Чтобы вы успели перевыпустить сертификат, напомним об истечении его срока за три недели.

Это можно сделать в личном кабинете руководителя. Зачем выпускать MTLS-сертификат

1. Перейдите в личный кабинет руководителя → в верхнем меню «Все сервисы» → «Сервисы» → «Интеграции».

3. Нажмите на стрелку в строке «Для какого сервиса нужен сертификат». В выпадающем меню выберите сервис «Долями» и нажмите «Дальше».

5. Скачайте ключ и заявку — нажмите на ссылку «Скачайте».

6. Если у вас нет электронной подписи, нажмите на ссылку «Выпустить ее» во втором пункте.

Если у вас есть электронная подпись, подпишите заявку. Как это сделать

7. Перетащите в поле для загрузки файл с вашей подписью в расширении .sig. Неподписанный PDF-файл заявки загружать не нужно. После этого нажмите «Отправить заявку».

8. Заявка на выпуск сертификата отправлена. Процесс выпуска длится около 10 минут, статус можно отслеживать в личном кабинете Т-Бизнеса: «Сервисы» → «Интеграции» → T-API → «Сертификаты».

На странице с сертификатами вы можете:

• На вкладке «Действуют» — скачать сертификат, посмотреть срок действия, перевыпустить его или выпустить новый.
• На вкладке «Не действуют» — посмотреть невыпущенные сертификаты или выпустить новый.
• На вкладке «Выпускаются» — посмотреть ваши незавершенные заявки на выпуск сертификата, перейти к подписанию заявки или отменить ее.

Срок действия сертификата — год. Он пригодится для заполнения настроек Долями через CMS-модули или для дополнительной защиты API-запросов. Чтобы вы успели перевыпустить сертификат, напомним об истечении его срока за три недели.

Перед настройкой проверьте, что на вашем компьютере установлены:

• Операционная система Windows или macOS.
• Браузер Google Chrome версии 76 или выше — другие браузеры не подходят. Проверить версию можно по ссылке chrome://settings/help.
  Установить Google Chrome с официального сайта

Далее следуйте инструкции:

1. Перейдите в личный кабинет руководителя → «Настройка для подписи».

Выпустить новый сертификат можно по памятке.

Сертификат действует год. Проверить срок можно через командную строку, обратившись к папке, где лежит файл с сертификатом: openssl x509 -enddate -noout -in open-api-cert.pem.

Интеграция состоит из четырех этапов:

1. Подготовка.
2. Подключение.
3. Работа с заявками.
4. Настройка возвратов.

Подробные инструкции и справочная информация есть на сайте, в разделе «Бизнесу» → «Способы интеграции» → API.

Ограничение — 10 входящих запросов от одного партнера в секунду. Для обращения к Долями нужно выпустить MTLS-сертификат, иначе запросы не дойдут. Как продлить MTLS-сертификат

Если сайт магазина находится на иностранном сервере, напишите в поддержку Долями: partners@dolyame.ru. Мы добавим адреса магазина в список разрешенных. Если этого не сделать, входящие запросы от него могут блокироваться — так срабатывает защита Долями от DDoS-атак.

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

Проверить это можно через командную строку:

• для запроса csr: openssl req -noout -modulus -in request.csr | openssl md5;
• для ключа: openssl rsa -noout -modulus -in private.key | openssl md5;
• для сертификата: openssl x509 -noout -modulus -in open-api-cert.pem | openssl md5.

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

Для любой онлайн-кассы мы запрашиваем несколько данных:

• ИНН организации, который указывается в чеке;
• сайт магазина, который указывается в чеке;
• эл. почту службы поддержки вашего магазина, которая указывается в чеке;
• название сервиса онлайн-кассы, который подключен;
• расширенные настройки: для всех онлайн-касс — массив полей для учетной записи, для кассы «Атол» — код группы;
• ключи авторизации для вашей онлайн-кассы;
• систему налогообложения;
• формат фискальных документов.

Это безопасно: мы храним данные в зашифрованном виде и не передаем их третьим лицам. Данные из списка можно прислать менеджеру по интеграции — в телеграм-чате или на почту partners@dolyame.ru.