# Инструкция для партнёров: как пользоваться ботом EasyPay

## Главное

У вас есть Telegram-бот **@easypay_self_service_bot**, который позволяет управлять платежами в Stripe без участия нашей команды. Вернуть деньги клиенту, отменить подписку, повторить списание — всё это делается прямо в чате за 30 секунд.

Бот работает как диалог: вы пишете команду, бот спрашивает нужные данные, показывает детали операции и просит подтверждение. Пока вы не нажмёте кнопку «Подтвердить», ничего не произойдёт.


---

## Как начать работу

По запросу мы добавим в ваш чат бота: [@easypay_self_service_bot](https://t.me/easypay_self_service_bot)

Напишите `/help` — если увидите список команд, доступ есть. Если бот ответит «Access Denied», напишите команде заботы EasyPay — добавим вас в систему.


---

## Команды

### `/refund` — вернуть деньги клиенту

**Когда использовать:** клиент просит возврат, и вы согласны его сделать.

**Что нужно:** ID платежа — это код, который начинается с `pi_` или `ch_`. Его можно найти в телеграм канале с нотификациями от EasyPay или в Google Sheets с транзакциями.

**Как работает:**


1. Напишите `/refund`
2. Бот попросит ID платежа — вставьте его
3. Бот покажет детали: сумма, клиент, дата
4. Нажмите «Подтвердить» или «Отменить»
5. Готово — клиент получит деньги через 5–10 рабочих дней

**Важно:** бот делает полный возврат всей суммы. Если нужен частичный возврат, напишите нам.


---

### `/cancel` — отменить подписку

**Когда использовать:** клиент хочет прекратить подписку.

**Что нужно:** ID подписки — код, который начинается с `sub_`.

**Как работает:**


1. Напишите `/cancel`
2. Вставьте ID подписки
3. Бот покажет: кто клиент, какой тариф, когда заканчивается период
4. Подтвердите отмену

**Что происходит после:** подписка сразу же отменится. Если у подписки есть неоплаченный счёт, бот предложит его тоже отменить, чтобы Stripe не пытался списать деньги.


---

### `/retry` — повторить списание

**Когда использовать:** у клиента не прошёл платёж, он положил деньги на карту и просит попробовать ещё раз.

**Что нужно:** ID счёта (начинается с `in_`) или ID платежа (начинается с `pi_`).

**Как работает:**


1. Напишите `/retry`
2. Вставьте ID
3. Бот покажет сумму к оплате и статус счёта
4. Подтвердите повторную попытку
5. Бот сообщит результат: прошёл платёж или нет

**Если платёж не прошёл:** бот объяснит причину. Обычно это «insufficient funds» — денег на карте всё ещё не хватает, или «card declined» — банк отклонил операцию.


---

### `/balance` — проверить баланс

**Когда использовать:** хотите узнать, сколько денег на ваших счетах.

**Как работает:**


1. Напишите `/balance`
2. Бот сразу покажет балансы: USD, RUB, крипто и общий в долларах

Эта команда ничего не меняет — просто показывает информацию.


---

### `/dashboard` — открыть панель выставления счетов (бета)

> ⚠️ Эта функция работает в тестовом режиме. По вопросам и помощи — пишите команде заботы EasyPay.

**Когда использовать:** нужно выставить счёт клиенту — через американский банк Mercury или в криптовалюте.

**Как вызвать:**

* Напишите `/dashboard` в чат с ботом
* Или нажмите кнопку «Open App» в профиле бота

**Как работает:**


1. Напишите `/dashboard` или нажмите кнопку в профиле бота
2. Откроется Telegram Mini App с панелью EasyPay Dashboard
3. Выберите тип счёта:
   * **Mercury Invoice** — банковский счёт в долларах. Выберите продукт из списка, и бот сформирует инвойс с реквизитами американского банка.
   * **Crypto Invoice** — счёт в криптовалюте на произвольную сумму в токенах USDT и USDC, сети ETH и TRX.
4. Отправьте счёт клиенту

**Что можно сделать:**

* Выставить банковский инвойс за один из продуктов, которые уже заведены в системе
* Выставить крипто-счёт на любую сумму


---

### `/stop` — отменить текущую операцию

Если передумали в процессе любой команды — напишите `/stop`, и бот прервёт диалог.


---

## Где брать ID

**ID платежа (pi_ или ch_)** — в уведомлениях от Stripe, в отчётах, в письмах о транзакциях.

**ID подписки (sub_)** — в информации о клиенте, в уведомлениях о новых подписках.

**ID счёта (in_)** — в уведомлениях о неудачных платежах, в отчётах по подпискам.

Если не можете найти нужный ID, напишите нам — поможем.


---

## Если что-то пошло не так

**Бот говорит «Not Found»** — ID неправильный или относится к другому аккаунту. Проверьте, что скопировали код полностью.

**Бот говорит «Invalid Format»** — ID должен начинаться с `pi_`, `ch_`, `sub_` или `in_`. Проверьте, что не добавили лишних символов.

**Операция не выполняется** — бот объяснит причину. Например, нельзя вернуть деньги за неуспешный платёж или повторить оплату по уже оплаченному счёту.

**Любые вопросы** — пишите команде заботы EasyPay.


---

## Коротко

| Команда | Что делает | Какой ID нужен |
|---------|------------|----------------|
| `/refund` | Возврат денег | `pi_...` или `ch_...` |
| `/cancel` | Отмена подписки | `sub_...`      |
| `/retry` | Повторное списание | `in_...` или `pi_...` |
| `/balance` | Проверка баланса | Ничего не нужно |
| `/dashboard` | Выставление счетов (бета) | Ничего не нужно |
| `/stop` | Отмена операции | Ничего не нужно |


---

**Concurrent sessions** — бот обрабатывает одну команду за раз. Если вы начали `/refund` и тут же шлёте `/cancel` — старая операция перезатрётся новой.