Guides
  1. Getting20started

Каталог товаров

Выберите товар в каталоге и создайте заказ с нужными полями.

Каталог товаров

Вы получите идентификаторы и обязательные поля из каталога, а затем создадите заказ для каждого типа товара.

Используйте каталог перед созданием заказа

Перед каждым заказом запрашивайте актуальный каталог: он содержит доступные позиции, их идентификаторы и оптовые цены. Во всех запросах передавайте API-ключ.

curl -H "Authorization: Bearer $KEY" \
  https://hexpay.live/api/reseller/products

Для подарков, нейросетей и игр используйте отдельные каталоги ниже. После order/create оплатите заказ через POST /api/reseller/order/pay с тем же custom_id.

Telegram Stars

Укажите Telegram-юзернейм и quantity от 50 до 1 000 000.

curl -X POST https://hexpay.live/api/reseller/order/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_id":"stars-0001",
    "product":"stars",
    "recipient_username":"durov",
    "quantity":100
  }'
# {"success":true,"custom_id":"stars-0001","status":"created","total_to_pay_rub":131.68}

Telegram Premium

Выберите один из продуктов: premium_3m, premium_6m или premium_12m. quantity не передавайте.

curl -X POST https://hexpay.live/api/reseller/order/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_id":"premium-0001",
    "product":"premium_3m",
    "recipient_username":"durov"
  }'
# {"success":true,"custom_id":"premium-0001","status":"created","total_to_pay_rub":131.68}

Telegram-подарки

Сначала получите доступные подарки. В ответе используйте gift_id; также каталог содержит emoji, star_count, remaining_count и wholesale_price_rub. Цена подарка рассчитывается как цена звезды, умноженная на его звёздность.

curl -H "Authorization: Bearer $KEY" \
  https://hexpay.live/api/reseller/gifts

Подставьте gift_id из ответа каталога и Telegram-юзернейм получателя.

curl -X POST https://hexpay.live/api/reseller/order/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_id":"gift-0001",
    "product":"gift",
    "gift_id":"'$GIFT_ID'",
    "recipient_username":"durov"
  }'
# {"success":true,"custom_id":"gift-0001","status":"created","total_to_pay_rub":131.68}

Пополнение Steam

В recipient_username передайте логин Steam, а в quantity — сумму пополнения в рублях, от 50 до 50 000.

curl -X POST https://hexpay.live/api/reseller/order/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_id":"steam-0001",
    "product":"steam",
    "recipient_username":"steam_login",
    "quantity":500
  }'
# {"success":true,"custom_id":"steam-0001","status":"created","total_to_pay_rub":131.68}

Для steam значение quantity — сумма в рублях, а не количество единиц товара. Не передавайте сумму меньше 50 или больше 50 000.

Нейросети

Получите позиции нейросетей и выберите code. Каталог возвращает code, title, emoji, delivery и wholesale_price_rub; позиции с ручной выдачей в API не попадают.

curl -H "Authorization: Bearer $KEY" \
  https://hexpay.live/api/reseller/neural

Для neural получатель не нужен.

curl -X POST https://hexpay.live/api/reseller/order/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_id":"neural-0001",
    "product":"neural",
    "code":"'$NEURAL_CODE'"
  }'
# {"success":true,"custom_id":"neural-0001","status":"created","total_to_pay_rub":131.68}

Игры

Выберите игру, затем регион и пакет. Первый запрос возвращает список games, второй — список regions, а третий — тип delivery, необходимые fields, пакеты с product_ref и wholesale_price_rub.

curl -H "Authorization: Bearer $KEY" \
  https://hexpay.live/api/reseller/games

curl -H "Authorization: Bearer $KEY" \
  "https://hexpay.live/api/reseller/games?game=$GAME_KEY"

curl -H "Authorization: Bearer $KEY" \
  "https://hexpay.live/api/reseller/games?game=$GAME_KEY&region=$REGION_CODE"

Коды (delivery: "codes")

Для игровых кодов передайте product_ref выбранного пакета и quantity от 1 до 10. Получатель не нужен.

curl -X POST https://hexpay.live/api/reseller/order/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_id":"game-code-0001",
    "product":"game",
    "product_ref":"'$PRODUCT_REF'",
    "quantity":1
  }'
# {"success":true,"custom_id":"game-code-0001","status":"created","total_to_pay_rub":131.68}

Пополнение (delivery: "topup")

Для игрового пополнения передайте product_ref, quantity от 1 до 10 и объект fields. Имена ключей берите из массива fields в ответе каталога. Например, если каталог требует account_number и zone_id, передайте оба значения.

curl -X POST https://hexpay.live/api/reseller/order/create \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_id":"game-topup-0001",
    "product":"game",
    "product_ref":"'$PRODUCT_REF'",
    "quantity":1,
    "fields":{
      "account_number":"123456789",
      "zone_id":"1"
    }
  }'
# {"success":true,"custom_id":"game-topup-0001","status":"created","total_to_pay_rub":131.68}

Не добавляйте поля наугад: состав fields определяется выбранным пакетом. Если пропустить обязательное поле, API вернёт 400 со списком недостающих полей.

Updated 6 days ago

Did this page help you?