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

{% 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",
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fkassa.gitbook.io/firekassa-api-v2/invoices/create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.