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

## Что это такое

EasyPay может автоматически передавать данные об успешных оплатах в ваш GetCourse. Когда клиент оплачивает заказ через платёжную ссылку EasyPay (Stripe), информация об оплате автоматически поступает в GetCourse и создаёт заказ в нужном предложении (оффере).

Это позволяет:

* Автоматически открывать клиентам доступ к курсам и материалам после оплаты
* Не вести ручной учёт оплат
* Использовать GetCourse для управления контентом и учениками, а EasyPay — для приёма международных платежей


---

## Как это работает

Схема интеграции состоит из трёх элементов:


1. **Уникальный код предложения в GetCourse** — текстовый идентификатор, который вы задаёте в настройках оффера
2. **Metadata в платёжной ссылке Stripe** — мы прописываем этот же идентификатор в metadata платёжной ссылки
3. **Автоматическая передача данных** — при успешной оплате EasyPay видит `getcourse_offer_id` в metadata и отправляет данные в API GetCourse

**Поток данных:**

```mermaidjs
graph LR
    A[Клиент оплачивает] --> B[Stripe фиксирует оплату]
    B --> C{Есть getcourse_offer_id?}
    C -->|Да| D[EasyPay передаёт данные в GetCourse API]
    D --> E[GetCourse создаёт заказ в нужном оффере]
    C -->|Нет| F[Стандартная обработка без GetCourse]
```


---

## Настройка: пошагово

### Шаг 1. Задать уникальный код предложения в GetCourse


1. Откройте нужное предложение (оффер) в GetCourse
2. Перейдите в раздел настроек оффера
3. Найдите поле **«Уникальный код предложения»**
4. Введите понятный текстовый идентификатор, например: `Breathwork_Teachers_stage2_stream6_full`

> ⚠️ Код должен быть уникальным в рамках вашего GetCourse-аккаунта. Используйте латиницу, цифры и символ подчёркивания. Без пробелов.

 ![](https://docs.thenextgen.store/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2ZjNDA1YThiLTg3YTctNDgxNi1hN2IyLWIxZjA2MWQ2OGVhOS82YTFkN2M0My0wOTIxLTRhNjMtODAxNi04NjIxYzk5MDIwMTIvU2NyZWVuc2hvdCAyMDI2LTAzLTE4IGF0IDA4LjU5LjMzLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzg5NzMzNzAwLCJleHAiOjE3ODk4MjAxMDB9.0eksbYWTix6gi0gvnNxLzj3sTqy86FkyQ1kWvcg4Egc " =1230x510")

### Шаг 2. Сообщить код оффера в EasyPay, заполнив ячейки в таблице с тарифами

Отправьте нам (в ваш рабочий чат с EasyPay в Telegram) следующую информацию:

* **Уникальный код предложения** — тот, что вы задали в GetCourse (например, `Breathwork_Teachers_stage2_stream6_full`)
* **Название продукта / оффера** — чтобы мы понимали, к чему он относится
* **Цена и валюта** — если нужно создать новую платёжную ссылку

### Шаг 3. Мы создаём или обновляем платёжную ссылку

На стороне EasyPay мы создаём Payment Link в Stripe и добавляем в его metadata два параметра:

| Параметр | Описание | Пример |
|----------|----------|--------|
| `ep_pid` | Идентификатор партнёра в системе EasyPay | `bbw`  |
| `getcourse_offer_id` | Уникальный код предложения из GetCourse | `Breathwork_Teachers_stage2_stream6_full` |

### Шаг 4. Готово — можно принимать оплаты

После настройки процесс полностью автоматический:


1. Клиент переходит по платёжной ссылке и оплачивает
2. Stripe обрабатывает платёж
3. EasyPay получает webhook об успешной оплате
4. EasyPay проверяет, есть ли в metadata поле `getcourse_offer_id`
5. Если есть — отправляет данные (email клиента, сумма, оффер) в API GetCourse
6. GetCourse создаёт заказ и открывает клиенту доступ


---

## Что нужно от вас для подключения

Для настройки интеграции нам нужно от вас:


1. **Домен вашего GetCourse-аккаунта** — например, `online.yoursite.ru`
2. **API-ключ GetCourse** — найти можно в GetCourse: *Профиль → Настройки аккаунта → API*
3. **Уникальные коды предложений** — для каждого оффера, по которому вы хотите принимать оплаты через EasyPay


---

## Добавление новых офферов

Если вы запускаете новый курс или поток и хотите принимать оплаты через EasyPay:


1. Создайте оффер в GetCourse и задайте уникальный код предложения
2. Напишите нам в Telegram: код оффера, название, цена и валюта
3. Мы создадим новую платёжную ссылку и подключим её к вашему GetCourse


---

## Частые вопросы

**Можно ли использовать одну платёжную ссылку для нескольких офферов?** Нет. Каждая платёжная ссылка привязана к одному конкретному `getcourse_offer_id`. Для каждого оффера нужна отдельная ссылка.

**Что произойдёт, если клиент оплатит, но в GetCourse не появится заказ?** Напишите нам в Telegram — мы проверим логи и при необходимости передадим данные вручную. Обычно это связано с некорректным email или изменённым кодом оффера.

**Можно ли изменить код предложения после настройки?** Менять код после начала приёма оплат не рекомендуется. Если это необходимо — предупредите нас заранее, чтобы мы обновили metadata в платёжных ссылках.

**Нужно ли что-то настраивать в GetCourse для приёма данных по API?** Да, нужно убедиться, что API-доступ включён и ключ передан нам. Никаких дополнительных вебхуков или настроек на стороне GetCourse не требуется — мы пушим данные через их API.