> For the complete documentation index, see [llms.txt](https://docs.trybit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trybit.com/ru/api-reference-v2/create-invoice.md). # Создание счета Метод позволяет создать счет для клиента с помощью POST запроса. ### Что делает метод * Создает уникальный invoice * Возвращает ссылку или реквизиты для оплаты * Позволяет передать дополнительные данные ### Endpoint `POST` `https://api.trybit.com/v2/invoice/create` ### Headers | Name | Type | Example | Description | | ----------------------------------------------- | ------ | ----------------------------------- | ---------------- | | Authorization\* | string | Token eyJ0eXAiOiJK<...>4npi1ksS8tSY | API-ключ проекта | ### Request Body Основные параметры | Name | Type | Example | Description | | ------------------------------------------ | ------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | shop\_id\* | string | NGpD44<...>KXRdQ | Уникальный идентификатор магазина из личного кабинета | | amount\* | float | 100 | Сумма платежа в USD | | currency\* | string | USD |

Доступные валюты для конвертации:

USD, UZS, KGS, KZT, AMD, AZN, BYN, AUD, 'TRY', AED, CAD, CNY, HKD, IDR, INR, JPY, PHP, SGD, THB, VND, MYR, RUB, UAH, EUR, GBP.

По умолчанию устанавливается валюта USD

| | order\_id | string | ORDER\_93223 | Произвольный номер счета во внешней системе | | email | string | | Email адрес плательщика | Необязательные параметры **add\_fields** — это объект для передачи дополнительных данных | Name | Type | Example | Description | | ----------- | ---- | --------------------------------------------------------------------------- | ------------------------ | | add\_fields | dict |

{time\_to\_pay: {

"hours": 24, "minutes": 0

},

}

| Дополнительные параметры | {% hint style="warning" %} Необязательные параметры должны передаваться внутри объекта **add\_fields** {% endhint %} | Name | Type | Example | Description | | --------------------- | ------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | time\_to\_pay | dict | { "hours": 24, "minutes": 0 } | Время жизни счета | | available\_currencies | list\[string] | \[ "USDT\_TRC20", "ETH", "BTC" ] |

Доступные валюты для оплаты:

BTC, LTC, TRX, SOL, TON, BNB, ETH, ETH\_ARB, ETH\_BASE, ETH\_OPT, USDT\_ARB, USDT\_BSC, USDT\_ERC20, USDT\_OPT, USDT\_SOL, USDT\_TON, USDT\_TRC20, USDC\_ARB, USDC\_BASE, USDC\_BSC, USDC\_ERC20, USDC\_OPT, USDC\_SOL, DAI\_ARB, DAI\_BASE, DAI\_BSC, DAI\_ERC20, DAI\_OPT, USDD\_TRC20, PYUSD\_ERC20, PYUSD\_SOL, XAUT\_ERC20, XAUT\_TON, ARB\_ARB, OP\_OPT, PEPE\_BSC, PEPE\_ERC20, SHIB\_BSC, SHIB\_ERC20, TRUMP\_SOL

| | cryptocurrency | string | ETH |

Выбор валюты оплаты за пользователя.

При указании валюты на странице оплаты будут отображаться реквизиты без выбора валюты.

Так же адрес и сумма будут выданы в ответе на запрос.

| ### Примеры запроса Эти примеры показывают, как можно отправить запрос на создание счета. Обратите внимание, что необходимо предоставить ваш API ключ в заголовке `Authorization` для успешной авторизации запроса. {% tabs %} {% tab title="cURL" %} ```bash curl -X POST \ -H "Authorization: Token " \ -H "Content-Type: application/json" \ -d '{"amount": 100, "shop_id": "xBAivfPIbskwuEWj", "currency": "USD"}' \ "https://api.trybit.com/v2/invoice/create" ``` {% endtab %} {% tab title="Python" %} ```python import requests import json url = "https://api.trybit.com/v2/invoice/create" headers = { "Authorization": "Token ", "Content-Type": "application/json" } data = { "amount": 100, "shop_id": "xBAivfPIbskwuEWj", "currency": "USD" } response = requests.post(url, headers=headers, json=data) if response.status_code == 200: print("Success:", response.json()) else: print("Fail:", response.status_code, response.text) ``` {% endtab %} {% tab title="JavaScript " %} {% code title="Fetch.js:" %} ```javascript const url = 'https://api.trybit.com/v2/invoice/create'; const headers = new Headers({ 'Authorization': 'Token ', 'Content-Type': 'application/json' }); const data = { amount: 100, shop_id: 'xBAivfPIbskwuEWj', currency: 'USD' }; fetch(url, { method: 'POST', headers, body: JSON.stringify(data) }) .then(response => { if (response.ok) { return response.json(); } else { return Promise.reject('Creation Error'); } }) .then(data => { console.log('Success:', data); }) .catch(error => { console.error('Fail:', error); }); ``` {% endcode %} {% code title="Ajax.js:" %} ```javascript $.ajax({ url: 'https://api.trybit.com/v2/invoice/create', method: 'POST', headers: { 'Authorization': 'Token ', 'Content-Type': 'application/json' }, data: JSON.stringify({ amount: 100, shop_id: 'xBAivfPIbskwuEWj', currency: 'USD' }), success: function(data) { console.log('Success:', data); }, error: function(error) { console.error('Fail:', error); } }); ``` {% endcode %} {% code title="Axios.js:" %} ```javascript const axios = require('axios'); const url = 'https://api.trybit.com/v2/invoice/create'; const headers = { 'Authorization': 'Token ', 'Content-Type': 'application/json' }; const data = { amount: 100, shop_id: 'xBAivfPIbskwuEWj', currency: 'USD' }; axios.post(url, data, { headers }) .then(response => { console.log('Success:', response.data); }) .catch(error => { console.error('Fail:', error); }); ``` {% endcode %} {% endtab %} {% tab title="PHP" %} {% code title="cURL:" %} ```php ", "Content-Type: application/json" ); $data = array( "amount" => 100, "shop_id" => "xBAivfPIbskwuEWj", "currency" => "USD" ); $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); if($http_code == 200){ echo "Success: " . $response; } else { echo "Fail: " . $http_code . " " . $response; } curl_close($ch); ?> ``` {% endcode %} {% code title="File\_get\_contents:" %} ```php array( "header" => "Authorization: Token \r\n" . "Content-Type: application/json\r\n", "method" => "POST", "content" => json_encode(array( "amount" => 100, "shop_id" => "xBAivfPIbskwuEWj", "currency" => "USD" )), ), ); $context = stream_context_create($headers); $response = file_get_contents($url, false, $context); $http_code = $http_response_header[0]; if(strpos($http_code, "200")){ echo "Success: " . $response; } else { echo "Fail: " . $http_code . " " . $response; } ?> ``` {% endcode %} {% endtab %} {% endtabs %} ### Пример ответа На успешный запрос приходит ответ со статусом `success` и объектом `result`. {% tabs %} {% tab title="200: ОК – Invoice created" %} ```json { "status": "success", "result": { "uuid": "INV-89UX09KA", "created": "2026-01-27 09:03:58.958133", "address": "0xb07427fc721C23674c48233ffE93D3846ee58B63", "expiry_date": "2026-01-28 09:03:57.493361", "side_commission": "client", "side_commission_service": "merchant", "type_payments": "crypto", "amount": 0.034187, "amount_usd": 100.0, "amount_in_fiat": 100.0, "fee": 1.499999996212864e-06, "fee_usd": 0.0, "service_fee": 0.00065, "service_fee_usd": 1.9, "fiat_currency": "USD", "status": "created", "is_email_required": false, "link": "https://pay.trybit.com/89UX09KA", "invoice_id": null, "currency": { "id": 3, "code": "ETH", "fullcode": "ETH", "network": { "code": "ERC20", "id": 3, "icon": "https://cdn.trybit.com/img/network/ERC.svg", "fullname": "Ethereum" }, "name": "Ethereum", "is_email_required": false, "stablecoin": false, "icon_base": "https://cdn.trybit.com/img/currency/ETH.svg", "icon_network": "https://cdn.trybit.com/img/currency/ETH.svg", "icon_qr": "https://cdn.trybit.com/img/stroke/ETH_STROKE.svg", "order": 9 }, "project": { "id": 1, "name": "Test", "fail": "https://test.com/failed-payment", "success": "https://test.com/successful-payment", "logo": "https://static.trybit.com/logo/L52hWwjt98uYtUF91765782359.174416.jpg" }, "test_mode": false } } ``` {% endtab %} {% endtabs %} ### Параметры ответа Объект result содержит: | Name | Type | Example | Description | | -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | uuid | string | INV-89UX09KA | Уникальный идентификатор счета с префиксом INV | | created | string | 2026-01-01 12:00:00.000000 | Время создания счета по UTC +0 в формате YYYY-MM-DD HH:MI:SS.FFFFFF | | address | string | 0xb07427<...>E93D3846ee58B63 |

Адрес для оплаты

Будет предзаполнен только в случае выбора криптовалюты для оплаты

Для выбора валюты за клиента необходимо в add\_fields.cryptocurrency указать доступную в проекте валюту

| | expiry\_date | string | 2026-01-02 12:00:00.000000 |

Дата истечения срока действия счета по UTC +0 в формате YYYY-MM-DD HH:MI:SS.FFFFFF

После истечения срока действия счет переведется в статус canceled, если оплата не поступила

| | side\_commission | string | client | Сторона оплаты трансферной комиссии | | side\_commission\_cc | string | client | Сторона оплаты комиссии сервиса | | amount | float | 0.033366 | Сумма счета в выбранной криптовалюте | | amount\_usd | float | 100.0 | Сумма счета в USD | | amount\_in\_fiat | float | 100.0 | Сумма счета в валюте создания (зависит от параметра `currency`) | | fee | float | 4.500000159168849e-06 | Трансферная комиссия счета | | fee\_usd | float | 0.01 | Трансферная комиссия счета в USD | | service\_fee | float | 0.000634 | Комиссия сервиса | | service\_fee\_usd | float | 1.9 | Комиссия сервиса в USD | | fiat\_currency | string | USD | Код фиатной валюты, в которой был создан счет | | status | string | created |

Статус счета

При отправке запроса на создание счета всегда равен created.

Так же есть статусы paid (оплачен), partial (оплачен частично), overpaid (переплачен) и canceled (отменен)

| | is\_email\_required | bool | false | Параметр для обязательного заполнения почты в счете | | link | string | pay.trybit.com/89UX09KA | Ссылка на страницу счета | | currency | dict |

"currency": {

"id": 3,

"code": "ETH",

"fullcode": "ETH",

"network": {

"code": "ERC20",

"id": 3,

"icon": "",

"fullname": "Ethereum"

},

"name": "Ethereum",

"is\_email\_required": false,

"stablecoin": false,

"icon\_base": "",

"icon\_network": "",

"icon\_qr": "",

"order": 9

}

|

Объект выбранной криптовалюты в счете.


Так же содержит объект network — информация о выбранной сети валюты

| | project | dict |

"project": {

"id": 0,

"name": "MyShop",

"fail": "",

"success": "",

"logo": ""

}

| Объект с информацией о проекте | | test\_mode | bool | false | Признак тестового счета | > Мы регулярно работаем над улучшением документации сервиса для разработчиков. Пожалуйста, оцените качество и полезность материалов [по ссылке](https://survey.zohopublic.eu/zs/G6TdRh). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.trybit.com/ru/api-reference-v2/create-invoice.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.