Интеграция InSales с системой платежей Doku.com

О проекте

Магазин Oceaninside.ru продает украшения ручной работы из серебра с острова Бали. Работает за пределами России, нужна была платежная система для приёма оплаты в разных валютах.

Выбрали Doku.com — международный платежный шлюз, который поддерживает множество валют и способов оплаты.

Что такое Doku.com

Doku.com — платежная система для азиатского региона. Работает с банковскими картами, электронными кошельками, банковскими переводами.

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

Что сделали

1. Автоматическое создание страниц оплаты

Когда покупатель оформляет заказ в InSales, система автоматически передает данные в Doku.com. Для каждого заказа создается отдельная страница оплаты.

Покупатель переходит на эту страницу, выбирает способ оплаты и вводит данные карты. Платеж проходит через Doku, данные карты не попадают на сервер магазина.

2. Настройка приложения

Установили и настроили приложение для InSales, которое интегрируется с Doku.com. Приложение работает автоматически, без ручных операций.

Что настроили:

API-ключи для соединения с Doku
Параметры валют и способов оплаты
URL для уведомлений о статусе платежа
Логику обработки успешных и неуспешных платежей

3. Защита платежей

Когда Doku обрабатывает платеж, система отправляет уведомление на сервер магазина. Это уведомление содержит информацию о статусе платежа и подпись для проверки.

Настроили проверку подписи, чтобы исключить подделку данных. Если подпись не совпадает — платеж не засчитывается.

Защита транзакций

Все запросы от Doku подписываются секретным ключом. Магазин проверяет подпись перед обработкой уведомления. Это защищает от несанкционированного изменения статусов заказов.

4. Варианты размещения

Приложение можно разместить на нашем хостинге или на сервере клиента. На нашем хостинге проще — ничего настраивать не нужно, всё работает сразу.

На своем сервере — больше контроля. Можно настроить безопасность под свои требования, интегрировать с другими системами.

5. Тестирование

Протестировали все сценарии:

Успешная оплата — заказ переходит в статус "Оплачен"
Отмена оплаты — заказ остается в статусе "Новый"
Ошибка платежа — покупатель видит сообщение об ошибке
Возврат платежа — заказ переходит в статус "Возврат"

Проверили корректность передачи данных между InSales и Doku, работу уведомлений, обновление статусов.

6. Поддержка подписок

Для магазинов, которые продают товары по подписке (регулярная доставка продуктов, книг, канцелярии), есть отдельное решение — приложение для рекуррентных платежей.

Оно работает с системой PayOnline и позволяет автоматически списывать деньги с карты клиента по расписанию. Подробнее в кейсе о рекуррентных платежах.

Технические детали

API Doku.com

Используем REST API Doku для создания страниц оплаты и получения уведомлений о статусе платежа.

Webhooks

Doku отправляет webhook при изменении статуса платежа. Приложение ловит это уведомление и обновляет статус заказа в InSales.

Мультивалютность

Покупатель видит цены в своей валюте. При создании страницы оплаты указывается валюта заказа. Doku обрабатывает платеж в этой валюте и конвертирует по своему курсу.

Логирование

Все запросы к Doku и от Doku логируются. Если что-то идет не так, можно посмотреть логи и понять, на каком этапе произошла ошибка.

Результат

Магазин принимает платежи в разных валютах через Doku.com. Покупатели из Азии могут оплачивать заказы локальными способами: картами местных банков, электронными кошельками.

Процесс оплаты автоматический. Заказ создается в InSales, страница оплаты генерируется в Doku, статус обновляется после платежа.

Не нужно вручную проверять платежи или обновлять статусы. Система делает это автоматически.

Транзакции защищены проверкой подписи. Невозможно подделать уведомление о платеже и получить товар без оплаты.