DONYAEDIGITAL_API_v1

Authentication

All requests to protected endpoints require an API token. Include this token in your HTTP headers to authenticate your requests.

Header Required:
api-token: YOUR_SECRET_API_TOKEN

Rate Limiting & Security

To keep the gateway stable and secure, we enforce the following global rate limits:

300 Requests / 10 Seconds

Exceeding this frequency limit will temporarily return an HTTP 429 Error code.

Automatic IP Ban

Sending multiple invalid payloads or failed requests will trigger a permanent server-side IP ban.

GET

Get Me

/client/v1/getMe
Response Format 
{
  "success": true,
  "data": {
    "user_id": "123456789",
    "username": "developer_user",
    "first_name": "Ali",
    "balance": 150.75
  }
}
GET

Get Active Categories

/client/v1/categories
Response Format 
{
  "success": true,
  "count": 1,
  "data": [
    {
      "id": 1,
      "title": "PUBG Mobile UC"
    }
  ]
}
GET

Get Available Products

/client/v1/products
Response Format 
{
  "success": true,
  "count": 2,
  "data": [
    {
      "id": 22,
      "title": "Hapi Diamonds Pack",
      "price": "0.000001167",
      "category_id": 4,
      "qty_values": {
        "min": "600000",
        "max": "100000000000"
      }
    },
    {
      "id": 19,
      "title": "Bigo Live Diamonds",
      "price": "0.018",
      "category_id": 4,
      "qty_values": {
        "min": "50",
        "max": "500000"
      }
    }
  ]
}
GET

Get Order History

/client/v1/orders
Response Format 
{
  "success": true,
  "count": 1,
  "data": [
    {
      "order_id": "ID_785",
      "product_id": 19,
      "category_id": 4,
      "player_id": "5541289",
      "qty": 100,
      "amount": "1.80",
      "status": "success",
      "product_type": "variable_diamonds",
      "gem_amount": 100,
      "created_at": "2026-06-11 14:02:10"
    }
  ]
}
POST

Purchase Product

/client/v1/topup/auto/{product_id}/purchase
JSON Body Parameters
Field Type Required Description
player_id string Yes The game character target account numerical ID.
qty integer Yes The ordered diamond or package quantity amount.
order_uuid string Yes A unique client-generated string (UUID v4) to prevent double charging.
Example Success Response 
{
  "success": true,
  "message": "Game topup request processed successfully.",
  "data": {
    "order_id": "ID_9104",
    "status": "completed",
    "player_id": "5541289",
    "qty": 100,
    "total_amount": "1.8",
    "product_title": "Bigo Live"
  }
}