Цифровые товары
Telegram Stars и Premium, подарки, игры, нейросети, подарочные карты, музыкальные подписки.
Продавайте цифровые товары и VPN по API
Два HTTP API одной площадки: Telegram Stars, Premium, игры, нейросети и подарки одним, VPN-подписки другим. Оптовая цена с депозита, подписанные вебхуки.
Пишете через нейросеть? Дайте ей спецификацию VPN API, бриф цифровых товаров лежит в кабинете.
API=https://hexpay.live/api/reseller
# 1. фиксируем цену, депозит не тронут
curl -X POST $API/order/create \
-H "Authorization: Bearer $KEY" \
-d '{"custom_id":"a3f1","product":"stars",
"quantity":500,"username":"nightowl_buyer"}'
# 2. списываем депозит и уходим в доставку
curl -X POST $API/order/pay \
-H "Authorization: Bearer $KEY" \
-d '{"custom_id":"a3f1"}'
# {"status":"delivered","charged_rub":"..."} Два API
Какой API вам нужен
Оба работают с депозита и шлют подписанные вебхуки. Отличается предмет продажи, а с ним и жизненный цикл.
Цифровые товары
Stars, Premium и коды с автодоставкой
Заказ в две фазы, доставка воркером, возврат депозита при срыве. Подходит магазинам, ботам и любому сервису, где покупают разово.
- 01
Войдите и выпустите ключ
Кабинет открывается тем же аккаунтом Telegram, что и бот. Ключ показывается один раз.
- 02
Пополните депозит
CryptoBot, СБП, карта или крипта. С депозита списывается оптовая цена заказа.
- 03
Создайте и оплатите заказ
create фиксирует цену и депозит не трогает, pay списывает и ставит заказ в доставку.
POST /order/create → /order/pay
Пошаговый старт в кабинете Неоплаченный заказ живёт 30 минут, дальше отменяется сам. Если доставка сорвалась, депозит возвращается автоматически.
| Метод | Путь | Что делает |
|---|---|---|
| GET | /products | каталог с оптовыми ценами |
| GET | /balance | остаток депозита |
| GET | /check-recipient | проверить получателя до заказа, бесплатно |
| POST | /order/create | зафиксировать цену |
| POST | /order/pay | списать депозит и доставить |
| GET | /order/{custom_id} | статус заказа, источник истины |
| GET | /stats | агрегаты и доставки за 30 дней |
Stars: от 50 до 1 000 000 за заказКоды ошибок и поля товаров в документации
VPN-подписки
VPN-подписки на нашей инфраструктуре
Вы держите витрину, кассу и поддержку, платформа отвечает за серверы, конфиги и продление. Подписка приходит одной ссылкой, её открывает любой популярный VPN-клиент.
- 01
Выпустите ключ
Вход тем же партнёрским аккаунтом, что и кабинет франшизы. Ключ показывается один раз.
- 02
Пополните депозит
Подписки списываются с депозита по вашей закупочной цене, розница остаётся вашей.
- 03
Выдайте первую подписку
В ответе придёт ссылка на подписку и дата окончания.
POST /api/v1/vpn/subscriptions
| Раздел | Методов |
|---|---|
| Тарифы | 1 метод |
| Депозит | 1 метод |
| Подписки | 14 методов |
| Пользователи | 3 метода |
| Устройства | 4 метода |
| Операции | 1 метод |
| Пополнение | 4 метода |
| Вебхуки | 6 методов |
Подписка живёт дольше заказа, поэтому 13 событий вебхука приходят весь её срок: выдача, продление, за трое суток до конца, окончание, превышение трафика. Ошибки разобраны 41 кодами: у каждого написано, вернулись ли деньги и есть ли смысл в повторе.
Надёжность
Надёжность интеграции
Деньги не спишутся дважды, а о каждом событии вы узнаете. Ниже то, что держит интеграцию при обрывах сети и повторах.
Повтор не спишет дважды
Идентификатор операции custom_id придумываете вы. Повтор при обрыве сети вернёт результат первой попытки, уникальность держит база.
Автовозврат
Цифровые товары: доставка сорвалась, депозит вернулся сам, без тикетов и переписки.
Подписанные вебхуки
Подпись HMAC-SHA256 в заголовке X-Signature, повторы с нарастающей паузой.
Ключи и лимиты
Ключ показывается один раз и перевыпускается в кабинете. Около 60 запросов в минуту, на превышении приходит 429 с заголовком Retry-After.
Два кабинета: по одному на API
Кабинет цифровых товаров открывается по Telegram, без регистрации и KYC. Кабинет VPN API это ваш партнёрский аккаунт. Внутри ключ и webhook-секрет с ротацией, депозит и журнал операций. Оба есть и в мини-аппе бота, раздел «API».
Мы используем cookie для аналитики посещений, это помогает улучшать сайт. Данные анонимны. Собираем анонимную аналитику посещений. Подробнее