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

# Интеграция с Kaspi

> Оплата через платёжный сервис Kaspi (QR-код или счёт на телефон) в финансовом контуре.

Полный перечень полей — в [глоссарии интеграции с Kaspi](/ru/logic/finances/kaspi-glossary).

**Kaspi-оплата (карточка платежа)** — приложение к обычной оплате (см. [«Оплата: модель, знак и проверки»](/ru/logic/finances/payments)),
хранящее детали платежа через платёжный сервис Kaspi: способ (QR-код или счёт на телефон), идентификатор операции, статус,
ссылку на чек и полный ответ сервиса.

## Оплата через платёжный сервис Kaspi

При создании оплаты с признаком оплаты через Kaspi система обращается к сервису и создаёт карточку Kaspi-оплаты:

<Steps>
  <Step title="Выбор способа">
    Если указан телефон плательщика — выставляется **счёт на телефон**, иначе создаётся **QR-код**.
  </Step>

  <Step title="Ожидание оплаты">
    Сама оплата ставится в состояние **«ожидает оплаты»** (деньги ещё не поступили).
  </Step>

  <Step title="Входящее уведомление">
    Фактический результат приходит позже входящим уведомлением от Kaspi: по идентификатору операции находится карточка, в
    неё пишется статус, ссылка на чек, телефон плательщика и полный ответ сервиса, а **та же самая** оплата переводится в
    «успешно», «ошибка» или «истёк срок» — по типу события.
  </Step>

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

| Событие Kaspi     | Во что переходит оплата | Текст уведомления                    |
| ----------------- | ----------------------- | ------------------------------------ |
| Оплата прошла     | Успешно                 | «Kaspi Pay: оплата прошла успешно …» |
| Оплата отклонена  | Ошибка                  | «Kaspi Pay: оплата отклонена …»      |
| Срок оплаты истёк | Истёк срок              | «Kaspi Pay: срок оплаты истёк …»     |

<Note>
  Уведомление **обновляет уже существующую оплату** и никогда не создаёт новую. Если карточки Kaspi-оплаты по присланному
  идентификатору операции нет, событие записывается в лог и игнорируется — приходов «из ниоткуда» не появляется. События
  неизвестных типов тоже пропускаются без изменений.
</Note>

<Warning>
  Входящее уведомление обрабатывается **только при верной подписи** запроса. Если секрет подписи не задан, подпись считается
  неверной и уведомления по сути не принимаются.
</Warning>

Отдельно существует **публичная страница оплаты аренды**, где клиент сам платит через Kaspi по QR — по прямой ссылке на
аренду или найдя её по номеру телефона, без входа в систему. Там оплата создаётся сразу в состоянии «успешно» (ещё до
фактического получения денег), сумма ограничена остатком долга по аренде, а сама страница защищена ограничением частоты —
повторный запрос по той же ссылке в течение двух минут отклоняется. Подробности — на странице
[«Публичная страница оплаты аренды»](/ru/logic/finances/rentlink).

## Связанные страницы

<CardGroup cols={2}>
  <Card title="Глоссарий: Интеграция с Kaspi" icon="book" href="/ru/logic/finances/kaspi-glossary">
    Полный перечень полей Kaspi-оплаты.
  </Card>

  <Card title="Оплата: модель, знак и проверки" icon="receipt" href="/ru/logic/finances/payments">
    Статус «ожидает оплаты» и уведомления о поступлении денег.
  </Card>

  <Card title="Публичная страница оплаты аренды" icon="link" href="/ru/logic/finances/rentlink">
    Ссылка на аренду, поиск по телефону и оплата через Kaspi без входа в систему.
  </Card>
</CardGroup>