> For the complete documentation index, see [llms.txt](https://fkassa.gitbook.io/firekassa-api-v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fkassa.gitbook.io/firekassa-api-v2/transactions/withdrawal/create/phone.md).

# Телефон

{% hint style="info" %}
**Суть метода:** Пополнение баланса указанного телефона
{% endhint %}

## Метод запроса

POST

## Урл запроса

/api/v2/withdrawal/phone

## Параметры запроса

На вход принимаются следующие параметры

<table><thead><tr><th width="180">Название</th><th width="81" data-type="checkbox">Обяз.</th><th width="151">Формат</th><th>Описание</th><th data-hidden>Описание</th><th data-hidden>Формат</th><th data-hidden data-type="checkbox">Обязательно</th></tr></thead><tbody><tr><td>order_id</td><td>true</td><td>string(1-200)</td><td>Ваш уникальный номер заявки</td><td>Ваш уникальный номер заявки</td><td></td><td>false</td></tr><tr><td>site_account</td><td>true</td><td>string(1-255)</td><td>Код счета, с которого будет выполняться списание, например sber</td><td>Код счета, на который выполнять зачисление. Например sber</td><td></td><td>false</td></tr><tr><td>amount</td><td>true</td><td>string(1-255)</td><td>Сумма заявки</td><td>Сумма по заявке</td><td></td><td>false</td></tr><tr><td>account</td><td>true</td><td>string(1-255)</td><td>Номер телефона, баланс которого надо пополнить</td><td></td><td></td><td>false</td></tr><tr><td>phone_carrier</td><td>true</td><td>string(1-255)</td><td><p>Код оператора сотовой связи, может быть один из этих:</p><ol start="1"><li>Tele2, код <strong>tele2</strong></li><li>Билайн, код <strong>beeline</strong></li><li>Мегафон, <strong>megafon</strong></li><li>МТС, <strong>mts</strong></li></ol></td><td></td><td></td><td>false</td></tr><tr><td>comment</td><td>false</td><td>string(1-255)</td><td>Примечание по операции</td><td></td><td></td><td>false</td></tr><tr><td>notification_url</td><td>false</td><td>string(1-255)</td><td>Ссылка для отправки уведомления по этой транзакции</td><td></td><td></td><td>false</td></tr></tbody></table>

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

{% tabs %}
{% tab title="CURL" %}

```sh
curl --request POST \
  --url https://{{your_api_domain}}/api/v2/withdrawal/phone \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "OUT_2024_1289",
  "site_account": "sber",
  "amount": "100.00",
  "account": "7xxxx",
  "phone_carrier": "tele2"
}'
```

{% endtab %}

{% tab title="PHP + Guzzle" %}

```php
$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{your_api_domain}}/api/v2/withdrawal/phone', [
    'json' => [
        'order_id'     => 'OUT_2024_1289',
        'site_account' => 'sber',
        'amount'       => '100.00',
        'account'      => '7xxxxx',
        'phone_carrier'=> 'tele2',
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $yourApiToken,
    ]
]);
```

{% endtab %}
{% endtabs %}

## Параметры ответа

<table><thead><tr><th width="180">Название</th><th width="151">Формат</th><th>Описание</th><th data-hidden>Описание</th><th data-hidden>Формат</th><th data-hidden data-type="checkbox">Обязательно</th></tr></thead><tbody><tr><td>id</td><td>number</td><td>Номер заявки в нашей системе</td><td>Код метода, в данном случае card</td><td></td><td>false</td></tr><tr><td>amount</td><td>string(1-255)</td><td>Сумма по заявке</td><td>Ваш уникальный номер заявки</td><td></td><td>false</td></tr><tr><td>commission</td><td>string(1-255)</td><td>Сумма комиссии по заявке</td><td>Сумма по заявке</td><td></td><td>false</td></tr></tbody></table>

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

```
{
  "id": 20,
  "amount": "100.00",
  "commission": "2.00",
}
```