Протокол Merchant API

Последнее обновление: 2021-04-14 | Редактировать на GitHub

Общие принципы протокола

Взаимодействие систем OSON и провайдера строится в режиме "запрос-ответ", где инициатором запроса всегда является OSON, а отвечающей стороной – провайдер.

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

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

Требования к интерфейсу провайдера

  1. Интерфейс должен принимать запросы по протоколу HTTPS с IP-адресов подсетей:
    • 195.158.16.6, маска 255.255.255.255
    • 185.8.212.168, маска 255.255.255.255
    • 195.158.7.220, маска 255.255.255.255
  2. Интерфейс должен обрабатывать параметры, передаваемые системой методами HTTP POST 3 .Интерфейс должен формировать ответ системе в формате JSON в кодировке UTF-8.
  3. Скорость ответа не должна превышать 60 секунд, в противном случае система разрывает соединение по таймауту.
  4. Если предполагаемое количество платежей за услуги подключаемого провайдера, ожидается интенсивным (до 10 платежей в минуту и более), необходимо, чтобы интерфейс поддерживал многопоточную коммуникацию до 10-15 одновременных соединений.
  5. Интерфейс должен принимать запросы по протоколу HTTPS на один из следующих TCP-портов: 80, 81, 443, 8008, 8080, 8081, 8090, 8443, 4433. Использование иных портов не допускается.

Введение

Наши технология обеспечивают безопасный, удобный, доступный процесс оплаты и предоставляют принимать оплаты c банковских карт Uzcard, HUMO и международными платежными системами, как Oson кошелёк, VISA, Mastercard.
Для реализации протокола API от партнеров достаточно адаптировать свои биллингвою систему получить от нас 3 типа запроса (CHECK, PAY, CHECK_STATUS) и предоставить ответ на эти запросы
Настройки взаимодействия
1. Приготовьте 3 URL адреса которое предназначено для получения запроса. Для улучшения безопасности передачи данных рекомендуем использовать протокол HTTPS.
Пример URL CHECK запроса - https://interhub.hos.....er.uz/api/payment/check окончания URL адреса должно бить …api/payment/check
Пример URL PAY запроса - https://interhub.hos.....er.uz/api/payment/pay окончания URL адреса должно бить …api/payment/pay
Пример URL CHECK_STATUS запроса - https://interhub.hos.....er.uz/api/payment/check_status окончания URL адреса должно бить …api/payment/chack_status
2. В целях безопасности мы создаем token, чтобы партнер знал, что запрос пришел из нашей учетной записи. Для получения токена обратитесь нашим агенту
3. Как только API и URL, запрошенные выше, будут готовы, вы можете протестировать их в песочнице.
Если проверка прошла успешно, уведомите InterHub Менжера, он добавит вас на боевой сервер, и вы начнете принимать оплату за свои услуги и продукты с карт Oson кошелёк, Uzcard, Humo, Visa, Mastercard.