Документация биллинговой системы InterHUB для Merchant

Введение

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

Обзор

Все данные принимаются POST методом Ответ возвращается в формате JSON

Запросы

Обращение производится данными запросами check, pay, и check_status, deposit, merchant_list

Ниже будет описан каждый запрос:

check - метод, который должен выполниться до использования метода pay. Используется для получения дополнительной информации от системы и проверки возможности реальной транзакции.

pay - метод, который должен выполниться после того как метод (Response) вернет значение True. Данный метод используется для того, чтобы выполнилась реальная транзакция.

check_status - метод, который должен выполниться после pay. Используется для получения информации от транзакции он возвращает True или False

POST check

{{url}}/api/payment/check

url и token будут предоставлены в процессе интеграции.

Параметры запроса (request):

Параметр Тип Описание
method string REQUEST
merchant_id string Уникальный идентификатор поставщика
account string Аккаунт или номер телефона
amount double Сумма платежа (валюта от договора)
params object Объект с параметрами метода. Если в данном методе нет параметров, поле можно опустить

Параметры ответа (response):

Параметр Тип Описание
Succes:True boolean Ответ при успешном запросе
Succes:Folse boolean Ответ при не успешном запросе

Body raw (application/json)

{
    "Succes" : true,
}

Example RequestCheck

curl --location --request POST '{{url}}/api/payment/check  ' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data-raw '{
    "account" : "998997774433",
    "agent_transaction_id": "test",
    "amount": 20000.0,
    "merchant_id": 95, 
    "params": {}
}'

Example Response 200 OK

Body
{
  "message": "Success",
  "success": true,
  "status": 0,
  "account": "998997774433",
  "amount": 20000,
  "transaction_id": 1589273985135,
  "amount_in_currency": 20000,
  "comission": 0,
  "currency": "UZS"
}