Интерфейс запроса справочника провайдеров
Интерфейс позволяет запросить справочник провайдеров, существующих в системе.
Параметры запроса
Для получения справочника провайдеров необходимо выполнить POST запрос на url https://api.masspayer.ru/api/v2/get_providers, который содержит только авторизационные данные. Принцип формирования авторизационных данных описан здесь. Дополнительно, запрос может быть подписан.
Параметры ответа
Формат:
1 <?xml version="1.0"?>
2 <response>
3 <datetime></datetime>
4 <code></code>
5 <code_desc></code_desc>
6 <sign></sign>
7 <providers>
8 <provider id="">
9 <name></name>
10 <account_regex></account_regex>
11 <currency id=""></currency>
12 <commission>
13 <provider from_sender="">
14 <min_sum></min_sum>
15 <max_sum></max_sum>
16 <const_sum></const_sum>
17 <percent></percent>
18 </provider>
19 <service from_sender="">
20 <min_sum></min_sum>
21 <max_sum></max_sum>
22 <const_sum></const_sum>
23 <percent></percent>
24 </service>
25 </commission>
26 </provider>
27 ...
28 </providers>
29 </root>
Описание параметров:
Название |
Описание |
Примечание |
providers \ provider |
Провайдер |
Атрибут id: |
providers \ provider \ name |
Наименование провайдера в системе |
|
providers \ provider \ account-regex |
Регулярное выражение для проверки аккаунтов/счетов в системе провайдера |
Подробнее о регулярных выражениях. |
providers \ provider \ currency |
Буквенный код валюты счета (см. описание валют системы). |
Атрибут id: |
providers \ provider \ commission |
Тег комиссии |
|
providers \ provider \ commission \ provider |
Тег комиссии провайдера |
Атрибут from_sender: |
providers \ provider \ commission \ provider \ min_sum |
Сумма минимальной комиссии провайдера |
Указывается в валюте провайдера. |
providers \ provider \ commission \ provider \ max_sum |
Сумма максимальной комиссии провайдера |
Указывается в валюте провайдера. Если равна 0 - значит максимальная комиссия отсутствует. |
providers \ provider \ commission \ provider \ const_sum |
Сумма постоянной комиссии провайдера |
Указывается в валюте провайдера. |
providers \ provider \ commission \ provider \ percent |
Процент комиссии провайдера |
|
providers \ provider \ commission \ service |
Тег комиссии сервиса для платежей по данному провайдеру |
Атрибут from_sender: |
providers \ provider \ commission \ service \ min_sum |
Сумма минимальной комиссии сервиса для платежей по данному провайдеру |
Указывается в валюте провайдера. |
providers \ provider \ commission \ service \ max_sum |
Сумма максимальной комиссии сервиса для платежей по данному провайдеру |
Указывается в валюте провайдера. Если равна 0 - значит максимальная комиссия отсутствует. |
providers \ provider \ commission \ service \ const_sum |
Сумма постоянной комиссии сервиса для платежей по данному провайдеру |
Указывается в валюте провайдера. |
providers \ provider \ commission \ service \ percent |
Процент комиссии сервиса для платежей по данному провайдеру |
Прочие параметры ответа описаны в документе "Общие параметры ответа".
Пример
Пример запроса провайдеров для пользователя с:
логином 3,
паролем 12345678,
ключом API secret_api_key.
Запрос:
1 <?xml version='1.0' encoding='utf-8'?>
2 <request>
3 <datetime>2014-10-14T07:02:05.972306+04:00</datetime>
4 <auth>
5 <login>3</login>
6 <password_hash>$2a$10$PgTItKjowxNJwDJd4oWNOeq1rDVwiS4lW7EdbImvY3sqqL9e9gXIi</password_hash>
7 </auth>
8 <sign>$2a$10$9xIcht.4jFh9FS747xaIbOoSQJGXi/yPZqRMigvEfRSPv4GWejhf.</sign>
9 </request>
Ответ:
1 <?xml version='1.0' encoding='utf-8'?>
2 <response>
3 <datetime>2014-10-14T07:02:06.469346+04:00</datetime>
4 <code>0</code>
5 <code_desc>Ошибки нет</code_desc>
6 <sign>$2a$10$.G2WiL0CuY1CEAWy4DOfkOIneAnA.PdNcQnTjgDsjuJnDrO72dLsm</sign>
7 <providers>
8 <provider id="1">
9 <name>WMR</name>
10 <account_regex>^R\d{12}$</account_regex>
11 <currency id="4">WMR</currency>
12 <commission>
13 <provider from_sender="0">
14 <min_sum>10.0</min_sum>
15 <max_sum>1500.0</max_sum>
16 <const_sum>0</const_sum>
17 <percent>2.3</percent>
18 </provider>
19 <service from_sender="1">
20 <min_sum>0</min_sum>
21 <max_sum>0</max_sum>
22 <const_sum>0</const_sum>
23 <percent>2.0</percent>
24 </service>
25 </commission>
26 </provider>
27 <provider id="2">
28 <name>WMZ</name>
29 <account_regex>^Z\d{12}$</account_regex>
30 <currency id="6">WMZ</currency>
31 <commission>
32 <provider from_sender="0">
33 <min_sum>2.3</min_sum>
34 <max_sum>5.6</max_sum>
35 <const_sum>0</const_sum>
36 <percent>0.8</percent>
37 </provider>
38 <service from_sender="1">
39 <min_sum>0</min_sum>
40 <max_sum>0</max_sum>
41 <const_sum>0</const_sum>
42 <percent>2.0</percent>
43 </service>
44 </commission>
45 </provider>
46 <provider id="3">
47 <name>WME</name>
48 <account_regex>^E\d{12}$</account_regex>
49 <currency id="5">WME</currency>
50 <commission>
51 <provider from_sender="0">
52 <min_sum>0</min_sum>
53 <max_sum>0</max_sum>
54 <const_sum>0</const_sum>
55 <percent>0.5</percent>
56 </provider>
57 <service from_sender="1">
58 <min_sum>0</min_sum>
59 <max_sum>0</max_sum>
60 <const_sum>0</const_sum>
61 <percent>2.0</percent>
62 </service>
63 </commission>
64 </provider>
65 <provider id="4">
66 <name>Яндекс.Деньги</name>
67 <account_regex>^\d{12,16}$</account_regex>
68 <currency id="7">YM</currency>
69 <commission>
70 <provider from_sender="0">
71 <min_sum>0</min_sum>
72 <max_sum>0</max_sum>
73 <const_sum>0</const_sum>
74 <percent>0</percent>
75 </provider>
76 <service from_sender="0">
77 <min_sum>0</min_sum>
78 <max_sum>0</max_sum>
79 <const_sum>0</const_sum>
80 <percent>2.0</percent>
81 </service>
82 </commission>
83 </provider>
84 <provider id="5">
85 <name>QIWI</name>
86 <account_regex>^\+[1-9]\d{10,12}$</account_regex>
87 <currency id="1">RUR</currency>
88 <commission>
89 <provider from_sender="0">
90 <min_sum>0</min_sum>
91 <max_sum>0</max_sum>
92 <const_sum>0</const_sum>
93 <percent>0</percent>
94 </provider>
95 <service from_sender="0">
96 <min_sum>0</min_sum>
97 <max_sum>0</max_sum>
98 <const_sum>0</const_sum>
99 <percent>2.0</percent>
100 </service>
101 </commission>
102 </provider>
103 <provider id="6">
104 <name>Visa</name>
105 <account_regex>^\d{16,18}$</account_regex>
106 <currency id="1">RUR</currency>
107 <commission>
108 <provider from_sender="0">
109 <min_sum>0</min_sum>
110 <max_sum>0</max_sum>
111 <const_sum>0</const_sum>
112 <percent>0</percent>
113 </provider>
114 <service from_sender="0">
115 <min_sum>0</min_sum>
116 <max_sum>0</max_sum>
117 <const_sum>0</const_sum>
118 <percent>2.0</percent>
119 </service>
120 </commission>
121 </provider>
122 <provider id="7">
123 <name>MasterCard</name>
124 <account_regex>^\d{16,18}$</account_regex>
125 <currency id="1">RUR</currency>
126 <commission>
127 <provider from_sender="0">
128 <min_sum>0</min_sum>
129 <max_sum>0</max_sum>
130 <const_sum>0</const_sum>
131 <percent>0</percent>
132 </provider>
133 <service from_sender="0">
134 <min_sum>0</min_sum>
135 <max_sum>0</max_sum>
136 <const_sum>0</const_sum>
137 <percent>2.0</percent>
138 </service>
139 </commission>
140 </provider>
141 </providers>
142 </response>