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

# Создание заявки на ввод

Любой ввод средств начинается с создания заявки на ввод, в результате чего вы получаете реквизиты для осуществления операции ввода, которые вы и передаете вашему клиенту. Сразу после создания заявка будет находиться в статусе "Обработка" до тех пор, пока ваш клиент не выполнит оплату или не истечет срок действия заявки. 

В случае оплаты, заявка перейдет в один из статусов, соответствующих сумме оплаты:

* **Оплачено.** Если ваш клиент выполнил оплату копейка в копейку, согласно той сумме что была указана в заявке. В случае эквайринга обычно речь идет именно об этом статусе
* **Частично оплачено.** Если ваш клиент недоплатил какую-то часть суммы. Например  в заявке было указано 100 рублей 49 копеек, а клиент оплатил ровно 100 рублей. Чаще всего такая ситуация бывает с P2P методами. Иногда бывает так что вместо 10 тысяч рублей была оплачена всего 1 тысяча, поскольку клиент запутался в нулях.
* **Переплата.** Если ваш клиент переплатил какую-то часть суммы. Например в заявке было указано 100 рублей 49 копеек, а клиент заплатил 101 рубль. Иногда бывают и более серьезные переплаты.

Наша система поддерживает множество различных методов ввода и детали по каждому из них описаны в соответствующем разделе.

**Внимание!!!** Когда речь идет об обменных операциях, вы обязаны предоставить расширенные данные по операции. Они предоставляются независимо от типа заявки на ввод

<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>account</td><td>true</td><td>string(1-255)</td><td>Номер карты плательщика</td><td></td><td></td><td>false</td></tr><tr><td>ext_txn</td><td>true</td><td>string(1-255)</td><td> Идентификатор операции на вашем сайте.</td><td>Ваш уникальный номер заявки</td><td></td><td>false</td></tr><tr><td>ext_date</td><td>true</td><td>string(1-255)</td><td>Дата и время операции, пример "2020-01-01T00:00:00"</td><td>Сумма по заявке</td><td></td><td>false</td></tr><tr><td>ext_phone</td><td>true</td><td>string(1-255)</td><td>Номер телефона конечного клиента</td><td>Код счета, на который выполнять зачисление. Например sber</td><td></td><td>false</td></tr><tr><td>ext_photo</td><td>true</td><td>string(1-255)</td><td>Ссылка на верификационное фото клиента. Рекомендуем защитить ссылку паролем, который будет знать только наша служба поддержки</td><td></td><td></td><td>false</td></tr><tr><td>ext_last_name</td><td>true</td><td>string(1-255)</td><td>Фамилия конечного клиента</td><td></td><td></td><td>false</td></tr><tr><td>ext_first_name</td><td>true</td><td>string(1-255)</td><td>Имя конечного клиента</td><td></td><td></td><td>false</td></tr><tr><td>ext_middle_name</td><td>true</td><td>string(1-255)</td><td>Отчество конечного клиента</td><td></td><td></td><td>false</td></tr><tr><td>ext_email</td><td>true</td><td>string(1-255)</td><td>Email конечного клиента</td><td></td><td></td><td>false</td></tr><tr><td>ext_ip</td><td>true</td><td>string(1-255)</td><td>IP-адрес конечного клиента</td><td></td><td></td><td>false</td></tr><tr><td>ext_user_agent</td><td>true</td><td>string(1-255)</td><td>User-agent конечного клиентам</td><td></td><td></td><td>false</td></tr><tr><td>ext_recipient_system</td><td>true</td><td>string(1-255)</td><td>Платежная система получателя, например Payeer EUR</td><td></td><td></td><td>false</td></tr><tr><td>ext_recipient</td><td>true</td><td>string(1-255)</td><td>Аккаунт конечного клиента в платежной системе получателя, например P121321</td><td></td><td></td><td>false</td></tr><tr><td>ext_c_to</td><td>true</td><td>string(1-255)</td><td>Код валюты платежной системы согласно bestchange, например PEUR (см.Описание формата экспортного файла курсов – информационная статья</td><td></td><td></td><td>false</td></tr></tbody></table>

**Внимание!** Если вы не можете передать значение каких-то **ext\_\*\*\*** - полей, то не нужно передавать их вовсе. Пустые значения полей будут отбиваться ошибкой валидации.

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

Допустим вы являетесь обменным пунктом obmen.ru. К вам обратился клиент 22 декабря 2022 г в 09:00 по МСК по вопросу обмена 1000 рублей  ( с карты 516872\*\*\*\*\*1234, банк СберБанк ) на 10 USDT TRC20  ( кошелек TJcP\*\*\*\*JxoCr ) . В вашей системе эта сделка зарегистрирована под номером V-123. Клиент: Семенов Борис, телефон 79252605905, email - <Semenov@gmail.com>, user\_agent - Mozilla/5.0 (Linux; Android 8.1.0;Redmi 5 Plus) AppleWebKit/537.36 (KHTML, like Gecko)Chrome/76.0.3809.132 MobileSafari/537.36, ip- 141.101.155.45

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

```sh
curl --request POST \
  --url https://{{your_api_domain}}/api/v2/deposit/card \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "IN_V-123",
  "site_account": "sber",
  "amount": "1000.00",
  "account": "51xxxx",
  "ext_txn": "V-123",
  "ext_ip": "141.101.155.45",
  "ext_date": "2022-12-22T09:00:00",
  "ext_phone": "79252605905",
  "ext_photo": "https://obmen.ru/photos/3e625939-ed2a-4ea1-8fab-08a048948777.jpg"
  "ext_last_name": "Семенов",
  "ext_first_name": "Борис",
  "ext_middle_name": "Алексеевич",
  "ext_email": "semenov@gmail.com",
  "ext_user_agent": "Mozilla/5.0 (Linux; Android 8.1.0; Redmi 5 Plus) AppleWebKit/537.36 (KHTML, like Gecko)Chrome/76.0.3809.132 Mobile Safari/537.36",
  "ext_recipient": "TJcP****JxoCr",
  "ext_recipient_system": "Tether USDT TRC20",
  "ext_c_to": "USDT-TRC20"  
}'
```

{% endtab %}

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

```php
$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{your_api_domain}}/api/v2/deposit/card', [
    'json' => [
        'order_id'             => 'IN_V-123',
        'site_account'         => 'sber',
        'amount'               => '100.00',
        'account'              => '51xxxxx',
        'ext_txn'              => 'V-123',
        'ext_ip'               => '141.101.155.45',
        'ext_date'             => '2022-12-22T09:00:00',
        'ext_phone'            => '79252605905',
        'ext_photo'            => 'https://obmen.ru/photos/3e625939-ed2a-4ea1-8fab-08a048948777.jpg',
        'ext_last_name'        => 'Семенов',
        'ext_first_name'       => 'Борис',
        'ext_middle_name'      => 'Алексеевич',
        'ext_email'            => 'semenov@gmail.com',
        'ext_user_agent'       => 'Mozilla/5.0 (Linux; Android 8.1.0; Redmi 5 Plus) AppleWebKit/537.36 (KHTML, like Gecko)Chrome/76.0.3809.132 Mobile Safari/537.36',
        'ext_recipient'        => 'TJcP****JxoCr',
        'ext_recipient_system" => 'Tether USDT TRC20',
        'ext_c_to'             => 'USDT-TRC20',
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $yourApiToken,
    ]
]);
```

{% endtab %}
{% endtabs %}