> ## 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/school/acquiring`).

## Что такое эквайринг в Exode

Один **эквайринг** (Acquiring) — это ваше подключение к конкретному платёжному провайдеру с вашими реквизитами.
Вы можете подключить несколько эквайрингов одновременно (например, разные провайдеры или разные способы оплаты),
и ученик при оплате увидит доступные ему варианты.

Каждый эквайринг содержит:

| Поле          | Назначение                                                                      |
| ------------- | ------------------------------------------------------------------------------- |
| `provider`    | Платёжный провайдер (Payme, Click, Тинькофф и т. д.)                            |
| `name`        | Название, которое видит ученик при выборе способа оплаты                        |
| `description` | Дополнительное описание способа оплаты                                          |
| `config`      | Реквизиты и технические параметры подключения (заполняются по форме провайдера) |
| `active`      | Включён эквайринг или нет                                                       |
| `note`        | Служебная заметка (видна только в управлении)                                   |
| `currencies`  | Валюты, которые поддерживает провайдер                                          |

<Note>
  Список эквайрингов можно сортировать перетаскиванием — порядок влияет на то, в каком порядке способы
  оплаты показываются ученику на странице оплаты.
</Note>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/exode-faq/images/online-schools/sales-payments/acquiring-list.png" alt="Список подключённых эквайрингов в разделе управления" />

## Доступные провайдеры

Провайдер выбирается из списка активных провайдеров, поддерживающих валюту вашей школы
(`seller.baseCurrency`). Набор доступных провайдеров зависит от региона школы.

| Провайдер (`PaymentProviderType`) | Регион     | Способ оплаты                  |
| --------------------------------- | ---------- | ------------------------------ |
| `PaymeAcquiringUz`                | Узбекистан | Оплата в приложении Payme      |
| `ClickAcquiringUz`                | Узбекистан | Оплата в приложении Click      |
| `UzumMerchantUz`                  | Узбекистан | Оплата в приложении Uzum       |
| `UzumAcquiringUz`                 | Узбекистан | Оплата картой (Uzum)           |
| `MulticardAcquiringUz`            | Узбекистан | Uzcard • Humo • СБП            |
| `AtmosMpsAcquiringUz`             | Узбекистан | Visa • Mastercard (Atmos)      |
| `AtmosNpsAcquiringUz`             | Узбекистан | Uzcard • Humo (Atmos)          |
| `PaylovNpsAcquiringUz`            | Узбекистан | Оплата картой (Paylov)         |
| `TinkoffAcquiringRu`              | Россия     | Оплата картой или в приложении |
| `ProdamusAcquiringRu`             | Россия     | Оплата картой (Prodamus)       |

<Tip>
  Один и тот же провайдер может поддерживать разовые платежи (`OneTime`) и подписки/рекуррентные списания
  (`RecurrentInit`). При выборе провайдера в форме подключения указывается, какие платёжные системы он
  поддерживает — это важно, если вы планируете продавать рассрочку или подписки с автосписанием.
</Tip>

## Шаги подключения эквайринга

<Steps>
  <Step title="Откройте раздел эквайринга">
    Перейдите в **Управление → Школа → Эквайринг**. Если ещё ничего не подключено, вы увидите пустой
    список с кнопкой добавления.
  </Step>

  <Step title="Выберите провайдера">
    Нажмите добавить эквайринг и выберите провайдера из выпадающего списка. Показываются только провайдеры,
    поддерживающие валюту вашей школы. Под выбором отображается, какие платёжные системы поддерживает провайдер.
  </Step>

  <Step title="Заполните реквизиты">
    Форма реквизитов формируется динамически под каждого провайдера (`dynamicForm`). Заполните поля, которые
    вы получили в личном кабинете провайдера (идентификаторы мерчанта, ключи, токены и т. п.).
  </Step>

  <Step title="Сохраните подключение">
    Нажмите «Создать». После создания эквайринг появится в списке.
  </Step>

  <Step title="Пропишите callback-ссылку (если требуется)">
    Некоторые провайдеры требуют, чтобы вы указали в своём личном кабинете callback-ссылку
    (поле `_callbackLink`). Если провайдер её использует, после создания эквайринга Exode покажет ссылку,
    которую нужно скопировать и вставить в настройки провайдера.
  </Step>
</Steps>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/exode-faq/images/online-schools/sales-payments/acquiring-form.png" alt="Форма подключения эквайринга с выбором провайдера и полями реквизитов" />

<Warning>
  Callback-ссылка — обязательный шаг для корректной работы уведомлений об оплате. Если не прописать её в
  кабинете провайдера, платежи учеников могут не подтверждаться автоматически. При затруднениях в форме
  подключения есть кнопка связи с поддержкой.
</Warning>

## Режимы и управление эквайрингом

* **Включение / выключение.** Флаг `active` позволяет временно отключить способ оплаты, не удаляя реквизиты.
  Выключенный эквайринг не показывается ученикам.
* **Редактирование реквизитов.** Реквизиты можно изменить в любой момент через ту же форму — она подставит
  сохранённые значения из `config`.
* **Архивирование.** Ненужный эквайринг можно архивировать (`archivedAt`). По умолчанию список показывает
  только неархивные подключения (фильтр `archived: false`).
* **Порядок отображения.** Перетаскиванием задаётся приоритет способов оплаты для ученика.

<Note>
  Все технические параметры подключения хранятся в поле `config` и заполняются строго по форме конкретного
  провайдера. Набор полей отличается от провайдера к провайдеру, поэтому ориентируйтесь на подсказки в самой
  форме и на документацию провайдера.
</Note>