GamesDrop.io API

Руководство для мерчантов

Авторизация

Получение токена

1
Войдите в личный кабинет мерчанта
2
Создайте новый магазин
3
После создания магазина вы получите уникальный токен
4
Формат токена: abcdef1234567890abcdef1234567890

Безопасность токена

  • 🔒 Токен является конфиденциальной информацией
  • ⚠️ Не передавайте токен третьим лицам
  • 📝 Токен нельзя восстановить после создания
  • 🔄 При необходимости можно сгенерировать новый токен (старый станет недействительным)

Статусы заказов

Статус Описание Действия
SUBMITTED Заказ создан и ожидает обработки Ожидать перехода в PROCESSING
PROCESSING Заказ в процессе обработки Ожидать завершения
COMPLETED Заказ успешно выполнен Получить ключ/товар
CANCELED Заказ отменен из-за ошибки Создать новый заказ
REFUND Заказ возвращен Ожидать возврат средств

Возможные ошибки

Код ошибки Описание Решение
INVALID_TOKEN Неверный токен авторизации Проверить токен или получить новый
OFFER_NOT_FOUND Товар не найден или нет доступа Проверить ID товара и права доступа
TRANSACTION_DUPLICATE Дубликат транзакции Использовать новый transaction_id
WRONG_PRICE Неверная цена товара Обновить информацию о цене
ORDER_NOT_FOUND Заказ не найден Проверить ID заказа
ORDER_NOT_PROCESSING Заказ еще не в обработке Дождаться перехода в статус PROCESSING
ORDER_NOT_COMPLETED Заказ еще не завершен Дождаться завершения заказа
ORDER_ALREADY_CANCELED Заказ уже отменен Создать новый заказ
ORDER_ALREADY_REFUNDED Заказ уже возвращен Создать новый заказ

Проверка баланса

POST /api/v1/balance/check 
POST /api/v1/balance/check
Authorization:

Ответ:

{
  "currency": "RUB",
  "balance": 689240.32
}

Описание полей ответа:

Ключ Значение Дополнение
currency KZT | USD | EUR | RUB Указывается при регистрации
balance null | number -

Получение информации о товаре

POST /api/v1/offers/find-one 
POST /api/v1/offers/find-one
Authorization: 

{
  "offerId": "1001"
}

Ответ:

{
  "productCode": "pubg_mobile",
  "productName": "PUBG Mobile",
  "offerId": "LH300MSDG",
  "offerName": "60 UC",
  "price": 560.10,
  "currency": "RUB",
  "available": true,
  "returnDataForCustomer": false,
  "required": ["gameUserId"]
}

Описание полей запроса:

Ключ Значение Дополнение
offerId string -

Описание полей ответа:

Ключ Значение Дополнение
productCode string -
productName string -
offerId string -
offerName string -
price number -
currency KZT | USD | EUR | RUB -
available boolean Доступен ли продукт для покупки
returnDataForCustomer boolean Возвращается ли ключ для активации
required undefined | array Может содержать gameUserId для прямого пополнения

Создание заказа

POST /api/v1/order/create 
POST /api/v1/order/create
Authorization: 

{
  "offerId": "1000",
  "price": 560.10,
  "transactionId": "test112321124214",
  "customer": {
    "email": "user@gmail.com",
    "gameUserId": "52357322414"
  }
}

Описание полей запроса:

Ключ Значение Дополнение
offerId string -
price number -
transactionId string Уникальный идентификатор транзакции в вашей системе
customer undefined | object -
email undefined | string Необязательное поле для отслеживания
gameUserId undefined | string Обязательно, если указано в required

Ответ:

{
  "orderId": 10222502,
  "productCode": "pubg_mobile",
  "productName": "PUBG Mobile",
  "offerId": "1001",
  "offerName": "60 UC",
  "price": 560.10,
  "currency": "RUB",
  "status": "COMPLETED",
  "key": "001434249936",
  "returnDataForCustomer": true,
  "createdAt": "2024-05-28 10:08:04.296+00"
}

Описание полей ответа:

Ключ Значение Дополнение
orderId number -
status string Для некоторых номиналов обработка может занять время
key undefined | string Возвращается только при COMPLETED и returnDataForCustomer=true
createdAt string UTC +0

Проверка статуса заказа

POST /api/v1/order/find-one 
POST /api/v1/order/find-one
Authorization: 

{
  "orderId": 10222502
}

Описание полей запроса:

Ключ Значение Дополнение
orderId number -

Ответ:

{
  "orderId": 10222502,
  "productCode": "pubg_mobile",
  "productName": "PUBG Mobile",
  "offerId": "1001",
  "offerName": "60 UC",
  "price": 560.10,
  "currency": "RUB",
  "status": "COMPLETED",
  "key": "001434249936",
  "returnDataForCustomer": true,
  "createdAt": "2024-05-28 10:08:04.296+00"
}

Описание полей ответа:

Ключ Значение Дополнение
status string Текущий статус заказа
key undefined | string Возвращается только при COMPLETED и returnDataForCustomer=true

Проверка игрока

POST /api/v1/offers/check-game-data 
POST /api/v1/offers/check-game-data
Authorization: 

{
  "gameUserId": "52357322414",
  "gameServerId": "1234"
}

Описание полей запроса:

Ключ Значение Дополнение
gameUserId string Идентификатор игрока
gameServerId string Идентификатор сервера

Успешный ответ:

{
  "status": "VALID",
  "gameUserLogin": "JJJ"
}

Описание полей успешного ответа:

Ключ Значение Дополнение
status "VALID" Игрок валиден
gameUserLogin string Логин игрока

Ответ при ошибке:

{
  "status": "INVALID"
}

Описание полей ответа с ошибкой:

Ключ Значение Дополнение
status "INVALID" Игрок не валиден

Советы по интеграции

Перед созданием заказа

  • 🔍 Проверьте баланс (В процессе реализации)
  • 📋 Получите актуальную информацию о товаре
  • ✅ Проверьте валидность игрока (в случае прямого пополнения)

При создании заказа

  • 🔑 Используйте уникальный transactionId
  • 💰 Указывайте актуальную цену
  • 📝 Заполняйте все required поля

После создания заказа

  • 💾 Сохраните orderId
  • 👁️ Проверяйте статус заказа
  • 🎮 При статусе COMPLETED получите ключ/товар

При возникновении ошибок

  • 🔑 Проверьте токен
  • 📋 Убедитесь в корректности данных
  • 🔄 Создайте новый заказ при необходимости

Поддержка

При возникновении вопросов обращайтесь в техническую поддержку: