# API интеграции с платформами

**API** — инструмент для автоматизации процесса подачи клиентами заявок на рассрочку/кредит и их обработки.

### Основные функции API

**🔹 Автоматическое создание заказов** на стороне РР2.0 и перенаправление пользователей на страницу оплаты одним кликом;

**🔹 Получение данных** о совершенных платежах (рассрочка, кредит или другие формы оплаты);

**🔹 Автоматическое завершение заказов** в онлайн-школе при полной оплате, с последующим предоставлением доступа к курсам.

### Важные особенности

**📍 Система уведомлений**\
При изменении статуса заказа РР2.0 отправляет информацию в онлайн-школу.

{% hint style="warning" %}

1. Каждая нотификация[^1] подписывается с использованием секретного ключа нотификаций. Для каждого аккаунта партнёра свой ключ.
2. Всегда делайте повторный запрос на получение актуальной информации о заказе после получения нотификации, т.к. уведомление может прийти с задержкой или неактуальным статусом.
3. Тип нотификации теперь **`order.changed`** (заказ изменен), а не **`status.changed`** (статус изменён), так как теперь один заказ может иметь несколько рассрочек, и изменение статуса одной из них влияет на весь заказ.
   {% endhint %}

**📍 Статус заказа**

* **Общие статусы** для автоматического завершения заказов, например, `approved`, `canceled`, `wait_client`, `authorized`);
* **Расширенные статусы** более детализированные, отражающие этапы работы с заявкой в CRM, полезные для отдела продаж онлайн-школы).

**📍 Комиссии**\
Отдельно отображается **`commission`** (общая потеря партнера) и **`credit_commission`** (комиссия, которую забирает Ресурс Развития от суммы кредитного договора).

**📍 Формирование чеков**\
**Чек уже можно и нужно отправлять**, если **поле `allowSendReceipt`** имеет значение **`true`**. Эта механика учитывает разницу в пробитии чеков для России (*при авторизации*) и стран СНГ (*при отправке денег*).

### Получение данных для настройки API интеграции

Для настройки интеграции вам понадобится: логин, пароль и секретный ключ. Как правило, как только создаётся рабочий чат партнёра, эти данные присылаются в первую очередь техническим специалистом, но вы можете запросить их повторно.

### Настройка интеграции с Skillspace

{% stepper %}
{% step %}

#### Для настройки API перейдите в "Настройки школы" > "Способы оплаты"

<figure><img src="/files/NmTeZ7DEe43hobQO6Ioo" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Кликните на кнопку "Добавить другой способ оплаты"

<figure><img src="/files/z3NlGSeho9IS29nI8e02" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### В верхнем поле выберите "Ресурс Развития (рассрочка)", заполните поля тестовыми логином, паролем и секретным ключом

<figure><img src="/files/cczaVmcnXZcR4kfkyjyM" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Переходите в курсы

<figure><img src="/files/4ZEQB3paJsxlWSkw35gp" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Редактировать курс ➡ Настройки курса

<figure><img src="/files/VdTBtdtDzIdGf77kAO0w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/cCzNllfmXmu0YpOUsVnV" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### В блоке "Стоимость и оплата" > "Способ оформления рассрочки" выбрать Ресурс Развития

<figure><img src="/files/oHvy94ZJ30LCJ0xRG0fm" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Проверяете на странице оплаты, появилась ли рассрочка&#xD;. Если все работает, то вводите боевые данные API, вернувшись к [шагам 1-3](/help/integracii/api-integracii-s-platformami.md#nastroika-integracii-s-skillspace)

<figure><img src="/files/ciMDEMqdbWeyjaak12zg" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
*Вы можете настроить интеграцию с онлайн-кассами АТОЛ и CloudKassir для автоматического пробития чеков.*\
*Для консультации напишите своему персональному менеджеру или в общий чат поддержки.*
{% endhint %}

{% embed url="<https://docs.google.com/forms/d/e/1FAIpQLSezXxP5arrxDLC1VQPlKF6tVfS64BgfOC6-JIrs_cOIwCMJbg/viewform?usp=dialog>" %}

[^1]: **Нотификации** - это запросы, которые приходят со стороны 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://help.rrllc.ru/help/integracii/api-integracii-s-platformami.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.