DONYAEDIGITAL_API_v1

Authentication

To connect to the API infrastructure, you must include your dedicated private security key within the HTTP headers of every request. This token acts as your gateway credential and securely authorizes financial transactions.

Authorization Header Required:
api-token: YOUR_SECRET_API_TOKEN

Rate Limiting & Security

To preserve gateway architecture integrity and prevent system overload, the following request limits are strictly enforced globally:

300 Requests / 10 Seconds

Exceeding this specific burst frequency parameter will trigger a temporary HTTP 429 Error response.

Automated Firewall IP Ban

Continuous execution of invalid payloads or malformed structural calls will cause a permanent server-side IP restriction.


GET

Get Me (Account Identity Data)

https://donyaedigital-api.samotechno.com/api/v1/getMe

Fetches linked user identity metrics, verified Telegram platform metadata, and the precise floating-point balance remaining inside the wallet container.

Example Response (JSON)
{
  "success": true,
  "data": {
    "user_id": "123456789",
    "username": "developer_user",
    "first_name": "Ali",
    "balance": 150.75
  }
}
GET

Get Active Categories

https://donyaedigital-api.samotechno.com/api/v1/categories

Returns structural system arrays consisting of active categories currently authorized for product sorting filters (e.g. Category 1 for automated games).

Example Response (JSON)
{
  "success": true,
  "count": 1,
  "data": [
    {
      "id": 1,
      "title": "PUBG Mobile UC"
    }
  ]
}
GET

Get Available Products

https://donyaedigital-api.samotechno.com/api/v1/products

Returns structural data arrays of live items across Category 1 (PUBG) and Category 4 (Bigo, Saya, Likee, Hapi). Numerical values are dynamically normalized to remove trailing floating zeros.

Example Response (JSON)
{
  "success": true,
  "count": 4,
  "data": [
    {
      "id": 22,
      "title": "Hapi",
      "price": "0.000001167",
      "category_id": 4
    },
    {
      "id": 19,
      "title": "Bigo Live",
      "price": "0.018",
      "category_id": 4
    }
  ]
}
GET

Get Order Transaction History

https://donyaedigital-api.samotechno.com/api/v1/orders

Queries historical logs of transaction execution statuses. When an order is completed, the vendor delivery wrapper object (`delivery`) automatically populates with dynamic array license values or structural voucher parameters.

Example Response (JSON)
{
  "success": true,
  "count": 1,
  "data": [
    {
      "order_id": 785,
      "product_id": 19,
      "category_id": 4,
      "player_id": "5541289",
      "amount": "0.018",
      "uc_amount": 100,
      "status": "success",
      "delivery": {
        "type": "voucher",
        "items": ["VCHR-XYZ123456789"]
      },
      "created_at": "2026-06-11 14:02:10"
    }
  ]
}
POST

Submit Dynamic Game Purchase

https://donyaedigital-api.samotechno.com/api/v1/topup/game/auto/{product_id}/purchase

Dispatches an instant automated fulfillment procedure. The internal router handles target gateway abstraction. Failed attempts execute an atomic rollback transaction to safely return user wallet credits.

JSON Body Parameters
Field Type Required Description
player_id string Yes The target numerical user ID inside the corresponding game database.
qty integer No (Default: 1) Total pack item bundles requested for deployment.
Example Success Response
{
  "success": true,
  "message": "Game topup request processed successfully.",
  "data": {
    "order_id": 9104,
    "status": "completed",
    "player_id": "5541289",
    "qty": 2,
    "total_amount": "0.036",
    "product_title": "Bigo Live"
  }
}