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

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

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

* **Оплачено.** Если ваш клиент выполнил оплату копейка в копейку, согласно той сумме что была указана в заявке. В случае эквайринга обычно речь идет именно об этом статусе
* **Частично оплачено.** Если ваш клиент недоплатил какую-то часть суммы. Например  в заявке было указано 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 %}


---

# 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/transactions/deposit/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.