GamesDrop.io API - Merchant Guide

Welcome to the GamesDrop.io Partner API documentation! This guide provides everything you need to integrate your reseller platform with the GamesDrop network. By integrating, you gain access to our catalog of over 10,000 digital products, ranging from mobile operator top-ups to in-game currency for popular mobile games. Start here to streamline your product offerings and connect your customers to a world of digital goods.

Table of Contents

1. Authorization
   • Getting a Token
   • Token Security
2. Core Concepts
   • Order Statuses
   • Error Handling
3. API Endpoints
   • Check Balance
   • Manage Products
   • Manage Orders
   • Player Validation
4. Integration Recommendations
5. Support

Authorization

Getting a Token

How to get it

1. Log in to your merchant account
2. Create a new store
3. After creating the store, you will receive a unique token
4. Token format: abcdef1234567890abcdef1234567890

Token Security

• 🔒 The token is confidential information
• ⚠️ Do not share the token with third parties
• 📝 The token cannot be recovered after creation
• 🔄 If necessary, you can generate a new token (the old one will become invalid)

Core Concepts

Order Statuses

Possible Errors

API Endpoints

Check Balance

HTTP
POST /api/v1/balance/check
Authorization: {{token}}

Response:

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

Response fields description:

Getting Product Information

HTTP
POST /api/v1/offers/find-one
Authorization: {{token}}

{
  "offerId": "1001"
}

Response:

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

Request fields description:

Response fields description:

Creating an Order

HTTP
POST /api/v1/order/create
Authorization: {{token}}

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

Request fields description:

Response:

JSON
{
  "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"
}

Response fields description:

Check Order Status

HTTP
POST /api/v1/order/find-one
Authorization: {{token}}

{
  "orderId": 10222502
}

Request fields description:

Response:

JSON
{
  "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"
}

Response fields description:

Player Validation

HTTP
POST /api/v1/offers/check-game-data
Authorization: {{token}}

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

Request fields description:

Successful response:

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

Successful response fields description:

Error response:

JSON
{
  "status": "INVALID"
}

Error response fields description:

Integration Recommendations

🔍 Before Creating an Order

• Check balance (Implementation in progress)
• Get up-to-date product information
• Check player validity (for direct top-up)

📝 When Creating an Order

• Use a unique transactionId
• Specify the current price
• Fill in all required fields

✅ After Creating an Order

• Save the orderId
• Check the order status
• Upon COMPLETED status, receive the key/product

⚠️ When Errors Occur

• Check the token
• Ensure data correctness
• Create a new order if necessary

Support

If you have any questions, please contact technical support:

• 📧 Email: support@gamesdrop.io
• 💬 Telegram: @igoryan34

Error Handling Recommendations

🔍 Pre-Request Checks

• Token validation
• Product ID verification
• Price accuracy
• Uniqueness of transaction_id

🛠 Response Handling

• Handle all error codes
• Log errors
• Implement retry mechanism

📊 Order Management

• Save order IDs
• Monitor statuses
• Update data