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

Главное

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

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

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

По запросу мы добавим в ваш чат бота: @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.

Коротко

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