# Ордера

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

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

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

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

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

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

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