> For the complete documentation index, see [llms.txt](https://integration.nbcgate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integration.nbcgate.com/sozdanie-invoisa-i-provedeniya-platezha-deprecated.md).

# Создание инвойса и проведения платежа \[deprecated]

#### Документация: Работа с API для создания инвойса и проведения платежа

***

#### **1. Общая информация**

API предоставляет возможность управлять инвойсами: создавать новые инвойсы и проводить платежи по ним.

**Базовый URL:**\
`https://api.client.nbcgate.tech`

***

#### **2. Этапы работы**

**Шаг 1. Создание инвойса**

Метод используется для создания нового инвойса с указанием суммы, валюты, продукта и других данных.

**URL запроса:**\
`POST /invoice/create`

**Пример запроса (cURL):**

```bash
curl -X 'POST' \
  'https://api.client.nbcgate.tech/invoice/create' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "amount": 100,
  "coin_id": 1,
  "id": 12345,
  "product_id": 67890
}'
```

**Описание параметров тела запроса:**

| Поле         | Тип    | Описание                                 | Пример значения |
| ------------ | ------ | ---------------------------------------- | --------------- |
| `amount`     | number | Сумма инвойса                            | 100             |
| `coin_id`    | number | Идентификатор валюты (например, 1 — USD) | 1               |
| `id`         | number | Уникальный идентификатор pay\_link       | 12345           |
| `product_id` | number | Идентификатор продукта                   | 67890           |

**Пример ответа (JSON):**

```json
{
  "success": true,
  "invoice_id": 12345,
  "message": "Invoice created successfully"
}
```

**Описание ответа:**

* `success` (boolean): Статус операции.
* `invoice_id` (number): Уникальный идентификатор созданного инвойса.
* `message` (string): Описание результата.

***

**Шаг 2. Проведение платежа по инвойсу**

Метод используется для оплаты ранее созданного инвойса.

**URL запроса:**\
`POST /invoice/pay`

Обновим документацию для метода **`/invoice/pay`** с учетом нового формата ответа.

***

#### **Метод: Проведение платежа по инвойсу**

Метод используется для оплаты ранее созданного инвойса. В ответе возвращается информация о платеже, включая адрес для перевода средств, сумму, комиссию и дополнительные данные.

***

**URL запроса:**

`POST /invoice/pay`

***

**Пример запроса (cURL):**

```bash
curl -X 'POST' \
  'https://api.client.nbcgate.tech/invoice/pay' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "idInvoice": 12345
}'
```

***

#### **Тело запроса:**

| Поле        | Тип    | Обязательное | Описание                         | Пример значения |
| ----------- | ------ | ------------ | -------------------------------- | --------------- |
| `idInvoice` | number | Да           | Уникальный идентификатор инвойса | 12345           |

***

**Пример успешного ответа:**

```json
{
  "address": "TRDkc3pmPnvYZ2UiDsmModEitJp7akTVyy",
  "amount": "444.274652",
  "rate": 0.116482,
  "name": "Tron Shasta Testnet",
  "code": "TRX"
}
```

***

#### **Описание полей ответа:**

| Поле                       | Тип     | Описание                                                            |
| -------------------------- | ------- | ------------------------------------------------------------------- |
| `address`                  | string  | Адрес кошелька, на который необходимо перевести средства.           |
| `amount`                   | string  | Сумма перевода в указанной криптовалюте.                            |
| `rate`                     | float64 | Обменный курс валюты относительно базовой валюты инвойса.           |
| `name`                     | string  | Название сети криптовалюты (например, Tron Shasta Testnet).         |
| `code`                     | string  | Код криптовалюты, в которой осуществляется перевод (например, TRX). |
| `transferCommissionWeis`\* | float64 | (Если доступно) Размер комиссии за перевод в единицах криптовалюты. |

> \*Поле `transferCommissionWeis` может быть включено в зависимости от настроек API или контекста запроса.

***

**Пример использования ответа:**

Получив ответ, вы можете:

1. Отправить сумму `amount` на адрес `address` через выбранный криптовалютный кошелек.
2. Убедиться, что используется правильный код валюты (`code`) и сеть (`name`).

***

#### **Обработка ошибок:**

| Код ответа | Описание                  | Возможные причины                   |
| ---------- | ------------------------- | ----------------------------------- |
| 400        | Неверный запрос           | Отсутствие обязательного параметра. |
| 404        | Инвойс не найден          | Указан несуществующий `idInvoice`.  |
| 500        | Внутренняя ошибка сервера | Проблемы на стороне сервера.        |

***

#### **3. Полный пример выполнения двух запросов**

1. Создайте инвойс:

   ```bash
   curl -X 'POST' \
     'https://api.client.nbcgate.tech/invoice/create' \
     -H 'accept: application/json' \
     -H 'Content-Type: application/json' \
     -d '{
     "amount": 100,
     "coin_id": 1,
     "id": 12345,
     "product_id": 67890
   }'
   ```

   **Результат:**

   ```json
   {
     "success": true,
     "invoice_id": 12345,
     "message": "Invoice created successfully"
   }
   ```
2. Проведите платеж:

   ```bash
   curl -X 'POST' \
     'https://api.client.nbcgate.tech/invoice/pay' \
     -H 'accept: application/json' \
     -H 'Content-Type: application/json' \
     -d '{
     "idInvoice": 12345
   }'
   ```

   **Результат:**

   ```json
   {
     "success": true,
     "message": "Payment processed successfully"
   }
   ```

***

#### **4. Ошибки и их обработка**

При работе с API возможно получение следующих ошибок:

| Код ответа | Описание                  | Возможные причины                   |
| ---------- | ------------------------- | ----------------------------------- |
| 400        | Неверный запрос           | Отсутствие обязательных параметров. |
| 404        | Инвойс не найден          | Указан несуществующий `idInvoice`.  |
| 500        | Внутренняя ошибка сервера | Проблемы на стороне сервера.        |


---

# 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://integration.nbcgate.com/sozdanie-invoisa-i-provedeniya-platezha-deprecated.md?ask=<question>&goal=<endgoal>
```

`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.