API пополнения игровых счетов для реселлеров
Краткий ответ
API игровых пополнений позволяет реселлерам отправлять внутриигровую валюту (UC, Diamonds, Robux, Crystals) напрямую на игровой аккаунт игрока, передавая его игровой ID и сумму пополнения. В отличие от API подарочных карт, который доставляет код, API пополнений зачисляет кредит на аккаунт без генерации кода для активации. Это меняет требования к интеграции: валидация игрового ID обязательна, соответствие региона критично, и у покупателя нет кода, который он мог бы передать кому-то или использовать повторно.
Определение: API игровых пополнений — это B2B-интерфейс, позволяющий реселлерам зачислять виртуальную валюту на игровой аккаунт игрока, передавая игровой ID и выбирая пакет пополнения — без генерации кода для активации. Доставка осуществляется напрямую на игровой аккаунт.
Главный вывод: API пополнений имеет более низкий риск мошенничества с кодами, чем API подарочных карт, поскольку код для активации не генерируется. Но у них строже требования к вводимым данным: неверный игровой ID или несовпадение региона означает, что кредит уйдёт не на тот аккаунт или вовсе не будет доставлен. Валидация игрового ID обязательна.
Для кого это руководство
- Реселлеры, продающие внутриигровую валюту (PUBG UC, Roblox Robux, Mobile Legends Diamonds, Genshin Crystals и др.) и желающие автоматизировать доставку
- Владельцы интернет-магазинов, добавляющие игровые пополнения в каталог
- Разработчики Telegram-ботов, создающие автоматизированную доставку пополнений
- Разработчики, интегрирующие поставщика пополнений в магазин или маркетплейс
Пополнение счёта vs. подарочная карта: отличия для реселлеров
| Фактор | API подарочных карт | API пополнений |
|---|---|---|
| Что доставляется | Код для активации | Кредит напрямую на игровой аккаунт |
| Требуемый ввод от покупателя | Никакого (код самодостаточен) | Игровой ID (+ ID сервера для некоторых игр) |
| Чувствительность к региону | Регион карты должен совпадать с регионом аккаунта | Регион игры игрока должен быть указан |
| Риск возвратов | Коды могут быть использованы до подачи жалобы | Кредит на аккаунте необратим |
| Сложность интеграции | Ниже | Выше (валидация игрового ID) |
| Риск перепродажи кода | Код можно скриншотнуть и продать | Нет кода — нет риска |
Рабочий процесс API
1. Покупатель вводит игровой ID (и сервер при необходимости)
2. Ваш магазин вызывает эндпоинт валидации игрового ID
3. API подтверждает существование ID и возвращает имя аккаунта
4. Покупатель подтверждает и оплачивает
5. Ваш магазин вызывает эндпоинт создания заказа с валидированным ID
6. API зачисляет валюту на игровой аккаунт
7. API возвращает подтверждение доставки
8. Ваш магазин показывает подтверждение покупателю
Игры, требующие выбора сервера/региона
Игры, где нужно указывать сервер:
- Mobile Legends: Bang Bang (требует ID сервера)
- Genshin Impact (требует сервер: Asia, America, Europe, TW/HK/MO)
- Honkai: Star Rail (требует сервер)
Игры с глобально уникальным ID:
- PUBG Mobile (игровой ID глобально уникален)
- Roblox (имя пользователя или user ID глобально уникален)
- Free Fire (игровой ID глобально уникален)
Обработка ошибок
| Сценарий ошибки | Причина | Что показать покупателю |
|---|---|---|
| Неверный игровой ID | Опечатка или несуществующий аккаунт | «Игровой ID не найден. Проверьте ID и попробуйте снова.» |
| Неверный сервер | Правильный ID, неверный сервер | «ID не найден на этом сервере. Проверьте ваш сервер.» |
| Аккаунт заблокирован | Игровой аккаунт заблокирован или ограничен | «Этот аккаунт не может получать пополнения.» |
| Недостаточный баланс | Баланс реселлера слишком низкий | Заказ не должен был быть размещён; добавьте мониторинг баланса |
| Ошибка доставки | Ошибка сервера игры | Повторная попытка или обращение в поддержку |
Пример расчёта маржи (иллюстративный)
| Статья | Сумма |
|---|---|
| Розничная цена (600 UC) | $9,99 |
| Оптовая стоимость (скидка 12%) | $8,79 |
| Комиссия платёжной системы (2%) | $0,20 |
| Затраты на конвертацию (0,5%) | $0,04 |
| Резерв возвратов (0,2%) | $0,02 |
| Чистая прибыль | $0,94 |
| Чистая маржа | 9,4% |
Чек-лист интеграции
- Определить игры, которые будете предлагать (у каждой свой формат ID)
- Подтвердить, какие игры требуют выбора сервера/региона
- Реализовать эндпоинт валидации игрового ID для каждой игры
- Создать UI ввода ID с выбором сервера там, где нужно
- Показывать имя аккаунта после валидации до оплаты
- Реализовать создание заказа с обработкой ошибок
- Настроить вебхуки для подтверждения доставки
- Настроить мониторинг баланса с оповещениями
- Прописать условия: пополнения невозвратны после доставки