> 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/invoices/create.md).

# Создание инвойса

{% hint style="info" %}
**Суть метода:** при создании инвойса вы получаете ссылку и передаете ее вашему клиенту, далее ваш клиент при переходе по ссылке видит перечень доступных методов для оплаты, и использует тот, который ему больше нравится
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=k3RTvJF0nsY>" %}

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

POST

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

/api/v2/invoices

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

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

<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>amount</td><td>true</td><td>string(1-255)</td><td>Сумма заявки</td><td>Сумма по заявке</td><td></td><td>false</td></tr><tr><td>currency</td><td>false</td><td>string(1-255)</td><td>Валюта заявки. По умолчанию дефолтная валюта системы</td><td></td><td></td><td>false</td></tr><tr><td>payment_methods</td><td>false</td><td>массив строк</td><td>Список платежных методов, которые должны быть включены в инвойс. Применяется для усечения, поскольку по умолчанию включены все доступные. <br><br>Доступные варианты - h2h, card, sbp, sbp-a</td><td></td><td></td><td>false</td></tr><tr><td>site_account</td><td>false</td><td>string(1-255)</td><td>Код счета на который будет выполняться зачисление, например sber</td><td>Код счета, на который выполнять зачисление. Например sber</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><tr><td>success_url</td><td>false</td><td>string(1-1024)</td><td>Ссылка для перенаправления вашего клиента в случае успешной оплаты</td><td></td><td></td><td>false</td></tr><tr><td>fail_url</td><td>false</td><td>string(1-1024)</td><td>Ссылка для перенаправления вашего клиента в случае проблем с оплатой</td><td></td><td></td><td>false</td></tr><tr><td>ext_****</td><td>false</td><td></td><td>Детали по этим параметрам указаны в <a href="/pages/iZCnLecsz0fv9JXpEutj">создании заявки</a></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/invoices \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "IN_2024_1289",
  "amount": "100.00"
}'
```

{% endtab %}

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

```php
$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{your_api_domain}}/api/v2/invoices', [
    'json' => [
        'order_id'     => 'IN_2024_1289',
        'amount'       => '100.00',
    ],
    '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-200)</td><td>Комиссия по заявке</td><td>Ваш уникальный номер заявки</td><td></td><td>false</td></tr><tr><td>payment_url</td><td>string(1-255)</td><td>Ссылка на оплату</td><td>Код счета, на который выполнять зачисление. Например sber</td><td></td><td>false</td></tr></tbody></table>

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

```
{
  "id": 20,
  "amount": "100.00"
  "commission": "2.00",
  "payment_url": "https://some-domain.com/url",
}
```