API Documentation

Integrate our rapid gaming fulfillment engine directly into your software or website. Each request carries a flat service fee.

UniPin TopUp API

v1.0 Stable

Base URL: https://dxabot.shop

1. Authentication

Send your X-API-KEY in the request header (recommended) or as a query parameter.

X-API-KEY: YOUR_SECRET_API_KEY

?api_key=YOUR_SECRET_API_KEY

2. List Packages

Fetch all active UniPin packages to get their id for order creation.

GET /api/packages/uc.php

Parameter	Type	Required	Description
`api_key`	string	*	Your API key

                    Success Response
                    
{
    "status": "success",
    "packages": [
        { "id": 25, "name": "25 Diamond", "price": "BDT 25" },
        { "id": 50, "name": "50 Diamond", "price": "BDT 50" },
        { "id": 115, "name": "115 Diamond", "price": "BDT 115" }
    ],
    "fee_per_request": 0.5
}
                

UniPin Package ID Reference:

Package Name	ID (Input)
25 Diamond	`25`
50 Diamond	`50`
115 Diamond	`115`
Weekly Membership	`161`
240 Diamond	`240`
610 Diamond	`610`
Monthly Membership	`800`
1240 Diamond	`1240`
2530 Diamond	`2530`

3. Create TopUp Order

Initiate an automated voucher redemption request.

POST /api/topup/uc.php

Parameter	Type	Aliases	Description
`playerid`	String	`player_id`	Target Player ID (min 8 digits).
`package`	Int	`package_id`	Package ID from step 2.
`code`	String	—	Voucher PIN (8/16 digit patterns).
`orderid`	String	`user_order_id`	Optional — your internal order reference.
`callback_url`	URL	`url`	Optional — webhook URL for updates.

                        
{
    "status": "success",
    "order_id": "DXA-ABCD12345678",
    "message": "Order created and pending fulfillment."
}
                    

                        
{
    "status": "error",
    "message": "Validation failed",
    "errors": {
        "playerid": ["The playerid must be at least 8 characters."],
        "code": ["The code format is invalid."]
    }
}
                    

4. Check Order Status

Fetch details for a specific order by our ID or your tracking ID.

GET / ANY /api/order/status

Params: order_id OR user_order_id

                    Response Example
                    
{
    "status": "success",
    "data": {
        "orderid": "TRACK-001",
        "api_order_id": "DXA-ABCD1234",
        "status": "success",
        "package": "UniPin 100 Diamonds",
        "message": "Topup successful! Automation complete.",
        "created_at": "2026-04-06 12:00:00"
    }
}
                

5. Webhook (Callback) Updates

We POST a JSON payload to your callback_url for terminal status changes (Success/Failed).

                        
{
    "status": "success",
    "api_order_id": "DXA-ABCD1234",
    "orderid": "TRACK-001",
    "player_id": "8307359292",
    "package": "UniPin 50 Diamonds",
    "message": "Top-up success!"
}
                    

                        
{
    "status": "failed",
    "api_order_id": "DXA-ABCD1234",
    "orderid": "TRACK-001",
    "player_id": "8307359292",
    "message": "Voucher already redeemed. Balance refunded."
}
                    