> For the complete documentation index, see [llms.txt](https://sms-club.gitbook.io/smsclub24ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sms-club.gitbook.io/smsclub24ru/popolnenie-balansa-polzovatelyam.md).

# Пополнение баланса пользователям

{% tabs %}
{% tab title="XML" %}
Метод отправки **`POST`**

Кодировка XML-документов: **`UTF-8`**

Обязательный заголовок: **`Content-type: text/xml; charset=utf-8;`**

Адрес для запроса: **`https://my.smsclub24.ru/xml/add_balance.php`**

## Параметры запроса на отправку сообщения

<table><thead><tr><th width="283">Параметр</th><th width="176">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><p>request</p><p><mark style="color:orange;">.security</mark></p><p><mark style="color:purple;">.login</mark></p><p><mark style="color:green;">[value]*</mark></p></td><td>String</td><td>Ваш логин в системе</td></tr><tr><td><p>request</p><p><mark style="color:orange;">.security</mark></p><p><mark style="color:purple;">.password</mark></p><p><mark style="color:green;">[value]*</mark></p></td><td>String</td><td>Ваш пароль в системе</td></tr><tr><td><p>request</p><p><mark style="color:orange;">.security</mark></p><p><mark style="color:purple;">.token</mark></p><p><mark style="color:green;">[value]*</mark></p></td><td>String</td><td>Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру</td></tr><tr><td><p>request</p><p><mark style="color:orange;">.client</mark></p><p><mark style="color:green;">[login_client]*</mark></p></td><td>String</td><td>Логин клиента</td></tr><tr><td><p>request</p><p><mark style="color:orange;">.client</mark></p><p><mark style="color:purple;">[balance]*</mark></p></td><td>Int</td><td>Сумма зачисления</td></tr><tr><td><p>request</p><p><mark style="color:orange;">.client</mark></p><p><mark style="color:purple;">[type_transaction]*</mark></p></td><td>String</td><td><p>Тип транзакции:</p><p>- webmoney - WebMoney</p><p>- manager - Менеджер</p><p>- roboxchange – ROBOXchange</p><p>- cashless – Безналичный</p><p>- cashless_no_score – Безналичный без счета</p><p>- Qiwi – Qiwi</p><p>- yandexmoney - Яндекс.Деньги</p><p>- BITCOIN - Bitcoin</p><p>- trust_payment - Доверительный платеж</p><p>- write_off - Списание</p><p>- subscription - Абонентская плата</p></td></tr></tbody></table>

\*- обязательный параметр

## В случае получения правильного XML-документа

```xml
<?xml version="1.0" encoding="utf-8" ?>
<response>
    <transaction login="test_6_1" id_transaction="366"/>
    <transaction login="test_smpp_3" id_transaction="NO_USER"/>
    ...
    <transaction login="test_smpp_8" id_transaction="401"/>
</response>
```

<table><thead><tr><th width="304">Параметр</th><th width="150">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><p>response</p><p><mark style="color:orange;">.transaction</mark></p><p><mark style="color:purple;">[login]</mark></p></td><td>String</td><td>Логин клиента</td></tr><tr><td><p>response</p><p><mark style="color:orange;">.transaction</mark></p><p><mark style="color:purple;">[id_transaction]</mark></p></td><td>Int</td><td><p>Id транзакции при зачисление средств
</p><p><em><strong><code>NO_USER</code></strong> – означает, что данный пользователь не найден</em></p></td></tr></tbody></table>

## В случае возникновения ошибки в отправленном XML-документе

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>текст ошибки</error>
</response>
```

| Параметр                                                        | Тип    | Описание                                                                                                                                                                                                          |
| --------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>response</p><p><mark style="color:orange;">.error</mark></p> | String | <p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат XML документа</li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul> |

## Пример XML запроса

```xml
<?xml  version="1.0" encoding="utf-8" ?>
<request>
     <security>
          <login value="логин" />
          <password value="пароль" />
     </security>
     <client login_client="test_6_1" balance="100" type_transaction="webmoney">
     <client login_client="test_smpp_3" balance="150" type_transaction="manager">
     ...
     <client login_client="test_smpp_8" balance="200" type_transaction="BITCOIN">
</request>
```

{% endtab %}
{% endtabs %}