# Ордера

В данном разделе описаны методы для создания ордеров и получения информации о них

Функционал ордеров позволяет принимать платежи в указанной монете и сети

## Схема взаимодействия с API

{% @mermaid/diagram content="sequenceDiagram
Client ->> Merchant: Запрос оплаты
Merchant ->> Onchainpay: Создание ордера
Onchainpay ->> Merchant: Ордер
Merchant ->> Client: Адрес для оплаты или ссылка на оплату

```
Note over Client: Отправляет монеты

Onchainpay -->> Merchant: Вебхук о поступлении платежа" %}
```

## Возможные статусы

| Статус      | Описание                                |
| ----------- | --------------------------------------- |
| `init`      | Ордер создан                            |
| `error`     | Ошибка при создании или при исполнении  |
| `processed` | Упешная оплата ордера                   |
| `pending`   | При поступлении первой оплаты           |
| `expired`   | Истекло время жизни ордера              |
| `partial`   | Ордер истёк, но был частично оплачен    |
| `overpaid`  | Ордер был оплачен сверх указанной суммы |

При изменении статуса или поступлении новой транзакции, Вам будет отправлен вебхук на указанный при создании ордера URL.

Подробнее о вебхуке можно узнать в разделе **Webhooks**

> #### Внимание
>
> Обратите внимание, что статусы `processed`, `expired`, `partial`, `overpaid` **не являются конечными**
>
> При обработке вебхука вам стоит отдельно обрабатывать массив полученных транзакций для корректной обработки суммы платежа

## Срок жизни ордера

При создании ордера выделяется адрес из пула `PAY_IN` адресов организации.\
Этот адрес будет недоступен для других операций в течении всего срока жизни ордера.

В зависимости от сети оплаты минимальное и максимальное время жизни ордера может меняться.

Минимальное и максимальное значения для сетей:

| Сеть          | Минимальное значение | Максимальное значение |
| ------------- | -------------------- | --------------------- |
| `ton`         | 1800                 | 43200                 |
| `bitcoin`     | 7200                 | 43200                 |
| `bitcoincash` | 7200                 | 43200                 |
| `bsc`         | 1800                 | 43200                 |
| `tron`        | 1800                 | 43200                 |
| `ethereum`    | 1800                 | 43200                 |
| `fantom`      | 1800                 | 43200                 |
| `litecoin`    | 3600                 | 43200                 |

## Потерянные транзакции

В некоторых случаях плательщик может отправить на адрес монеты в другой сети или монете.\
Такие транзакции будут отображаться в отдельном поле `orphanDeposits` при получении вебхука\
или получении информации об ордере через API.

Вы можете увидеть эти транзакции в личном кабинете в разделе **Платежи —> Сиротские транзакции**.\
В этом разделе будет доступен вывод этих монет на сторонний адрес.


---

# 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://docs.onchainpay.io/ru/api-reference/05orders.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.