Соединяем сайт или приложение с сервисами, которые нужны бизнесу. Важно не только отправить запрос в API, но и корректно обработать ответ, сбой и повторное уведомление.
Для каких задач
Владельцам сайтов и приложений, которым нужно подключить оплату, передавать заявки или связать данные нескольких сервисов.
Передавать данные между системами без повторного ручного ввода
Получать и обрабатывать статусы платежей и других операций
Понятно обрабатывать сбои, задержки и повторные уведомления
01
Согласование обмена данными
Изучаем документацию, доступные методы и ограничения внешнего сервиса. Определяем, какие данные передаются, какая система является их источником и кто может запускать операцию. Секреты подключения остаются на сервере, а интерфейс получает только необходимые для пользователя результаты.
02
Ошибки и повторные операции
Внешний сервис может временно не отвечать, а callback — прийти повторно. Поэтому заранее рассматриваем статусы, таймауты и повторную обработку. Для платежных сценариев отдельно проверяем связь операции с заказом и обновление статуса после ответа провайдера. Для уведомлений — результат отправки и доступные ограничения канала.
03
Проверка существующего продукта
Интеграцию можно добавить в действующий сайт без переделки всей системы. Сначала разбираем текущую архитектуру и точки подключения, затем проверяем совместимость с существующими сценариями. В кейсе Mohir.tj показана работа над платформой, в том числе платежами и интеграциями.
Что входит в работу
Схема обмена данными
Серверное подключение API
Обработка статусов и ошибок
Проверка основных и повторных операций
Как строится работа
Возможности внешнего сервиса
Изучаем документацию API, способы авторизации и доступность тестового окружения. Согласовываем, какие поля и события передаются и какая система хранит исходные данные.
Подключение на сервере
Реализуем обмен в пределах согласованного сценария. Доступы не размещаем в публичном интерфейсе; заранее определяем поведение при повторном событии и временной недоступности API.
Проверка статусов
Проверяем успешные, ошибочные и повторные операции на тестовых данных. Для оплаты отдельно рассматриваем обновление статуса после уведомления провайдера, а не только возвращение пользователя на сайт.
Название сервиса, документация API и описание нужного обмена: что, откуда и когда должно передаваться. На первом обсуждении достаточно описания доступов; сами ключи и пароли не нужно отправлять в публичных сообщениях.
Можно подключить сервис без API?
Это зависит от доступных способов обмена. Иногда подходит согласованный импорт файлов, иногда надёжной автоматизации нет. До начала разработки нужно проверить технические возможности и правила самого сервиса.
Есть ли опыт платёжных интеграций?
В Mohir.tj подключён Alif WebCheckout. Это подтверждённая часть опубликованного кейса. Возможность подключения другого провайдера оценивается по его документации, условиям доступа и требованиям конкретного продукта.