Hex
HexDigital Reseller API

Продавайте Stars и Premium у себя

Оптовая цена с депозита, доставка за секунды, идемпотентные заказы. Ключ выдаётся через Telegram, без регистрации и KYC.

Получить ключ Документация
от ключа до заказа: 5 минут
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":"durov"}'

# 2. списываем депозит и уходим в доставку
curl -X POST $API/order/pay \
  -H "Authorization: Bearer $KEY" \
  -d '{"custom_id":"a3f1"}'

# {"status":"delivered","charged_rub":"..."}

Заказ в две фазы

Разделение на фиксацию и оплату снимает классическую проблему: показать цену клиенту и не списать деньги раньше, чем он согласился.

  1. create

    Цена фиксируется, депозит не списан. Можно показать её клиенту.

  2. pay

    Списываем депозит и ставим заказ в очередь доставки.

  3. delivered

    Воркер разбирает очередь каждые 3 секунды и отдаёт товар.

Неоплаченный заказ живёт 30 минут, дальше отменяется сам. Если доставка сорвалась, депозит возвращается автоматически.

Семь эндпоинтов, больше не нужно

base: https://hexpay.live/api/reseller
GET/productsкаталог с оптовыми ценами
GET/balanceостаток депозита
GET/check-recipientпроверить получателя до заказа, бесплатно
POST/order/createзафиксировать цену
POST/order/payсписать депозит и доставить
GET/order/{custom_id}статус заказа, источник истины
GET/statsагрегаты и доставки за 30 дней
товары: stars, premium_3m / 6m / 12mStars: от 50 до 1 000 000 за заказ

Что защищает от боли на проде

Идемпотентность по custom_id

Уникальность заказа держит база, а не наша память. Ретрай при таймауте сети вернёт тот же заказ, а не создаст второй. Это снимает главный страх интеграции с платным API.

Автовозврат

Доставка сорвалась, депозит вернулся. Без тикетов и переписки.

Подписанные вебхуки

HMAC-SHA256 в заголовке X-Signature, три ретрая с бэкоффом. Polling при этом остаётся источником истины.

Ключи и лимиты

В базе лежит только sha256-хеш ключа, плейнтекст показывается один раз и ротируется в кабинете. Лимит около 60 запросов в минуту, на превышении приходит 429 с заголовком Retry-After.

Ошибки говорят прямо

По коду сразу понятно, чинить у себя или ждать нас.
400
валидация
401
ключ
402
мало депозита
404
не найден
409
нельзя оплатить
429
лимит
503
товар недоступен

Кабинет открывается по Telegram

Аккаунт создаётся сам при первом входе. Регистрация, документы и KYC не нужны.

  • API-ключ и webhook-секрет с ротацией
  • Депозит от 50 до 50 000 рублей: CryptoBot, СБП, карта, крипта
  • История заказов с фильтром по статусу и статистика

Вход в кабинет

Тем же аккаунтом Telegram, что и в боте. Аккаунт создаётся сам — без регистрации и KYC.

Войти в кабинет

Кабинет также доступен в боте, раздел «API».

Мы используем cookie для аналитики посещений, это помогает улучшать сайт. Данные анонимны. Подробнее