Операции с балансом

Перевод средств и другие операции с балансом партнера

📘

Адрес для отправки запросов:

https://tdm4.adcloud.org/api/v2/?method=MethodName

В качестве get-параметра необходимо передавать название метода, что позволит динамически определить метод через URL-строку.

За предоставлением доступа к методам работы с балансом и для пополнения счета агентства обратитесь к администратору.

Получение баланса по партнеру

"method": "Statistic.getPartnerBalance" позволяет пользователю получить значение баланса по партнеру (Агентству или Клиенту). Для этого необходимо выполнить запрос, указав в качестве параметров "partner_xxhash" - xxhash партнера.

Пример запроса:

JSON

{
  "jsonrpc": "2.0",
  "method": "Statistic.getPartnerBalance",
  "params": {
    "partner_xxhash": "47111116A9D09E11"
  },
  "id": 1
}

Пример ответа:

JSON

{
    "jsonrpc": "2.0",
    "result": {
        "balance": 3583.73,
        "currency": "RUB"
    },
    "id": 1
}

Метод возвращает в секции результатов значение баланса партнера и его валюту.

Поле	Описание	Пример значения
balance	баланс партнера	3583.73
currency	валюта баланса	RUB

Перевод средств между партнерами

"method": "Partner.transferMoney" позволяет пользователю перевести средств с баланса одного партера на баланс другого партнера. Для этого необходимо выполнить запрос, указав три обязательных параметра:

• fromXxhash - xxhash партнера, с баланса которого осуществляется перевод средств,
• toXxhash - xxhash партнера, на баланс которого происходит начисление средств,
• amount - размер переводимых средств в валюте партнера, указанного в поле "fromXxhash".

Пример запроса:

JSON

{
    "jsonrpc":  "2.0",
     "method": "Partner.transferMoney",
     "params": {
        "fromXxhash": "47111116A9D09E11",
        "toXxhash": "47111116A9D09E22",
        "amount": 100
    },
     "id":  1
}

Пример ответа:

JSON

{
    "jsonrpc": "2.0",
    "result": true,
    "id": 1
}

В случае успешного перевода средств между партнерами в ответе в секции результатов вернется значение "true", иначе вернется ошибка.

При получении ошибки убедитесь, что

• у вас есть доступ к методам,
• на счетах агентства или клиента достаточно средств для выполнения переводов,
• в запросе введены верные Xxhash партнеров.