> ## Documentation Index
> Fetch the complete documentation index at: https://faq.exode.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Рассрочка и автосписания

> Как устроена рассрочка: график платежей, автосписания по привязанной карте и статусы платежей

Рассрочка позволяет ученику оплачивать продукт частями по графику, а платформе — автоматически списывать
очередные платежи с привязанной карты. Управление рассрочками находится в разделе
**Управление → Рассрочки** (`/manage/installments`).

## Как устроена рассрочка

Рассрочка — это тип биллинга доступа к продукту (`ProductBillingType.Installment`). Когда ученик покупает
продукт в рассрочку:

1. Создаётся доступ к продукту с графиком списаний (набор `ProductAccessBilling`);
2. Ученик привязывает карту (см.
   [Типы платежей](/online-schools/sales-payments/payment-types#привязка-карты-для-автосписаний));
3. Первый (вступительный) платёж проводится сразу, остальные — автоматически по датам графика.

<Note>
  Рассрочка — частный случай биллинга. Второй тип биллинга — подписка (`ProductBillingType.Subscription`),
  которая работает по той же механике автосписаний, но с интервальным продлением. Раздел «Рассрочки» по
  умолчанию отфильтрован по типу `Installment`.
</Note>

## Список рассрочек

В таблице раздела по каждому ученику видно сводную информацию о его рассрочке (`billingInfo`):

| Поле                                        | Значение                                  |
| ------------------------------------------- | ----------------------------------------- |
| `status`                                    | Текущий статус биллинга                   |
| `paidCount` / `totalCount`                  | Сколько платежей оплачено из общего числа |
| `totalPaidAmount`                           | Оплаченная сумма                          |
| `installmentTotalAmount`                    | Полная сумма рассрочки                    |
| `currentPaymentAt` / `currentPaymentAmount` | Дата и сумма текущего платежа             |
| `nextPaymentAt` / `nextPaymentAmount`       | Дата и сумма следующего платежа           |

<img src="https://mintlify.s3.us-west-1.amazonaws.com/exode-faq/images/online-schools/sales-payments/installments-list.png" alt="Таблица рассрочек с прогрессом оплат и датами списаний" />

### Фильтры

Список рассрочек можно фильтровать по:

* поиску (`search`), ученикам (`userIds`), продуктам (`productIds`), ценам (`priceIds`);
* статусам списаний (`billingStatuses`);
* активности рассрочки (`billingActivity`: активные / отменённые);
* диапазону дат текущего и следующего платежа, диапазону суммы платежа.

## График платежей

График рассрочки — это набор записей о списаниях (`ProductAccessBillingEntity`). Каждая запись графика содержит:

| Поле                       | Назначение                                   |
| -------------------------- | -------------------------------------------- |
| `order`                    | Порядковый номер платежа в графике           |
| `startDate` / `finishDate` | Период платежа                               |
| `amount`                   | Сумма списания                               |
| `status`                   | Статус платежа (см. таблицу ниже)            |
| `attemptCounter`           | Число попыток автосписания                   |
| `retryDate`                | Дата следующей повторной попытки при неудаче |
| `cancelDate`               | Дата отмены (если платёж отменён)            |
| `next`                     | Следующий платёж графика (дата и сумма)      |

График можно редактировать в управлении: платформа поддерживает создание, обновление и удаление записей
графика по конкретной рассрочке, а также смену привязанной карты (платёжного метода) для будущих списаний.

<Tip>
  Если у ученика меняется карта, в рассрочке можно переназначить платёжный метод — последующие автосписания
  пойдут с новой карты.
</Tip>

## Автосписания

Очередные платежи списываются автоматически по датам графика с привязанной карты ученика. При неуспешном
списании увеличивается счётчик попыток (`attemptCounter`) и назначается дата повторной попытки (`retryDate`).
Если списания исчерпали попытки, платёж и рассрочка переходят в отменённый статус.

Рассрочку можно приостановить/отменить вручную: платформа поддерживает изменение активности биллинга
с указанием причины отмены (`cancellation`).

## Статусы платежей рассрочки

Статус каждого платежа графика — `ProductAccessBillingStatus`. Несколько разных «отменённых» статусов
показывают ученику одинаковую подпись «Отменено», но различаются по причине отмены.

| Статус (`ProductAccessBillingStatus`) | Подпись        | Значение                                        |
| ------------------------------------- | -------------- | ----------------------------------------------- |
| `Scheduled`                           | Запланировано  | Платёж запланирован на будущую дату             |
| `WaitingEntryFee`                     | Ожидание карты | Ожидается вступительный платёж / привязка карты |
| `Processing`                          | В обработке    | Списание выполняется                            |
| `Paid`                                | Оплачено       | Платёж успешно списан                           |
| `Failed`                              | Неуспешно      | Списание не прошло (возможна повторная попытка) |
| `CanceledByUser`                      | Отменено       | Отменено пользователем                          |
| `CanceledByFailedAutoCharge`          | Отменено       | Отменено из-за неудачного автосписания          |
| `CanceledByFailedManualCharge`        | Отменено       | Отменено из-за неудачного ручного списания      |
| `CanceledByReinitialization`          | Отменено       | Отменено из-за переинициализации рассрочки      |
| `CanceledByPreviousCancellation`      | Отменено       | Отменено вследствие предыдущей отмены           |

<Warning>
  Отмена одного платежа может каскадно отменить последующие (`CanceledByPreviousCancellation`). Перед отменой
  убедитесь, что действительно хотите прекратить всю серию списаний по этой рассрочке.
</Warning>