Подключение партнёра к сервису «Подели»#
Варианты подключения#
Выберите способ, который подходит вашей платформе:
Способ |
Что использовать |
|---|---|
Прямая интеграция через API |
Документация API и коллекция методов для Postman: |
Обёртки API |
Готовые библиотеки, ускоряющие прямую интеграцию: Python, dotNet, PHP. |
Готовые решения для CMS |
Модули для Bitrix, WordPress, Tilda, CS-Cart, OpenCart 3 и 4, MODX Revolution (miniShop2), Joomla, Webasyst, RetailCRM, а также 1С Розница. |
Чек-лист прямого подключения#
Шаг 1. Ознакомьтесь с документацией API.
Шаг 2. Скачайте цепочку тестовых сертификатов ООО «Подели» для установки защищённого соединения:
сертификат, ключ (иные форматы).
Шаг 3. Получите тестовые логин и пароль у менеджера по интеграции.
Шаг 4. Подключитесь к тестовому контуру по адресу, указанному в документации API. Для тестирования можно использовать Postman — скачайте и установите коллекцию Podeli_API_collection.json, сертификат и ключ.
Подсказка
На некоторых дистрибутивах Linux может потребоваться добавить серверные сертификаты «Подели» в список доверенных (необязательный шаг):
сертификат 1, сертификат 2.
Debian, Ubuntu и т. п.:
$ sudo cp local-ca.crt /usr/local/share/ca-certificates
$ sudo update-ca-certificates
Fedora, CentOS, Arch:
$ sudo cp mycert.pem /etc/pki/ca-trust/source/anchors/mycert.pem
$ sudo update-ca-certificates
Шаг 5. Пройдите интеграционные тесты. Основные тест-кейсы:
успешная оплата;
отказ на скоринге;
отмена заказа до оплаты;
ошибка при оплате;
полный возврат;
частичный возврат.
Шаг 6. Для получения HTTP-нотификаций обеспечьте доступность вашего API из публичной сети интернет: разместите сервис на публичном («белом») IP-адресе.
Шаг 7. Получите боевой сертификат по инструкции Настройка защищённого соединения. Выпуск сертификата занимает до 3 рабочих дней.
Внимание
К моменту получения боевого сертификата убедитесь, что на вашей стороне выполнены следующие условия: подписан договор с сервисом, реализованы методы API, пройдены все интеграционные тесты.
Иные форматы SSL-сертификатов#
По умолчанию при генерации боевых сертификатов вы получите файлы .crt и .key. Это рекомендуемые форматы: они подходят для большинства сценариев.
Если вашей инфраструктуре нужен сертификат в другом формате, вы можете самостоятельно преобразовать его и использовать один из вариантов ниже: