Разработчикам: как интегрировать Долями на сайт

Как провести API-интеграцию сервиса?

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

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

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

Как интегрировать сервис через модули на CMS: Битрикс, WordPress, OpenCart?

Мы опубликовали подробные инструкции для разработчиков по каждому способу.

Есть ли ограничения по IP для обращения к Долями и приема запросов от Долями?

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

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

Можно ли настроить ограничение по лимитам на оплату Долями в своем интернет-магазине?

Да, это могут сделать ваши разработчики. Нужно скрыть способ оплаты «Долями» для корзин, сумма которых превышает лимиты сервиса. Это снизит количество отказов. Какие лимиты есть в Долями

В приложении «Долями» мы постепенно добавляем на витрину бирки с лимитами. Покупатель сразу увидит, какое ограничение на сумму есть в конкретном магазине.

imageBlock

Так покупатели видят лимит магазина в приложении «Долями»: можно сразу оценить, какую максимальную стоимость корзины получится оплатить частями

Как продлить MTLS-сертификат?

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

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

Заявка на сертификат и сам сертификат у нас один, а приватный ключ — private.key — другой. Что делать?

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

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

  • для запроса 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.

Какой информации не хватило?