Интерфейс запроса баланса.
Интерфейс позволяет запросить баланс по всем личным счетам в системе, в том числе, и по отключенным. Подробнее о счетах в системе см. описание личных счетов в системе.
Параметры запроса
Для запроса баланса необходимо выполнить POST запрос на url https://api.masspayer.ru/api/v2/get_balance, который содержит только авторизационные данные. Принцип формирования авторизационных данных описан здесь. Дополнительно, запрос может быть подписан.
Параметры ответа
Формат:
Описание параметров:
Название |
Описание |
Примечание |
bills \ bill |
Личный счет в системе |
Атрибут id: |
bills \ bill \ name |
Наименование счёта в система |
Удобное имя, которое было выбрано при создании счета |
bills \ bill \ amount |
Баланс счета на момент запроса |
Сумма указывается в валюте счета |
bills \ bill \ currency |
Валюта счета |
Содержит буквенный код валюты счета (см. описание валют системы). |
Прочие параметры ответа описаны в документе "Общие параметры ответа".
Пример
Пример запроса баланса для пользователя с:
логином 3,
паролем 12345678,
ключом API secret_api_key.
Запрос:
1 <?xml version='1.0' encoding='utf-8'?>
2 <request>
3 <datetime>2014-10-14T06:48:24.891157+04:00</datetime>
4 <auth>
5 <login>3</login>
6 <password_hash>$2a$10$1SHTg8UanwjBV9qWfXLLEuilweNq26/C2PUZi4A.cCfrCL9Y0sBgG</password_hash>
7 </auth>
8 <sign>$2a$10$e6kSO/7Y/1McnvjQwmiPe.aBn9T1/4rrj0qP6wBE7MKbdtUEgA68K</sign>
9 </request>
Ответ:
1 <?xml version='1.0' encoding='utf-8'?>
2 <response>
3 <datetime>2014-10-14T06:48:25.302751+04:00</datetime>
4 <code>0</code>
5 <code_desc>Ошибки нет</code_desc>
6 <sign>$2a$10$8F7HhaVJvM4FveDfmIPVf.5i6JySy1mVADdUL6YZ/Zs.d.cVuK8RO</sign>
7 <bills>
8 <bill disabled="0" id="7">
9 <name>Рублевый</name>
10 <amount>456.0</amount>
11 <currency id="1">RUR</currency>
12 </bill>
13 <bill disabled="0" id="8">
14 <name>Доллары</name>
15 <amount>556.0</amount>
16 <currency id="2">USD</currency>
17 </bill>
18 <bill disabled="0" id="9">
19 <name>WMR основной</name>
20 <amount>563.0</amount>
21 <currency id="4">WMR</currency>
22 </bill>
23 <bill disabled="0" id="10">
24 <name>WMZ</name>
25 <amount>125.0</amount>
26 <currency id="6">WMZ</currency>
27 </bill>
28 </bills>
29 </response>