API Documentation

Developer API Reference

🤖 Connect Your Account to Bot

Type your API key on our Telegram bot to get connected. Get real-time updates, API logs, and status reports directly on Telegram.

@dxaapi_service_bot Active

✅

Connected

API Services

UniPin Topup Shell Topup Nickname Check FF Like

Error Codes

UniPin TopUp API

v1.0 Stable

Base URL: https://kstourbd.shop

1. Authentication

                            // Send your API key in header
                            X-API-KEY: YOUR_SECRET_API_KEY
                            
                            // Or as query parameter
                            ?api_key=YOUR_SECRET_API_KEY
                        

2. List Packages

GET /api/packages/uc.php

Parameters:

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

                            // Response
{
    "status": "success",
    "packages": [
        { "id": 25, "name": "25 Diamond", "price": "BDT 25" },
        { "id": 50, "name": "50 Diamond", "price": "BDT 50" }
    ]
}
                        

3. Create Order

POST /api/topup/uc.php

Parameters:

Parameter	Type	Required	Description
`api_key`	string	*	Your API key
`orderid`	string	*	Unique order ID
`playerid`	string	*	Player UID
`code`	string	*	Voucher code
`package`	int	*	Package ID

                            // Example Request
?api_key=DXA-XXXXXXXX&orderid=ORD-001&playerid=8307359292&code=12345678&package=25
                        

Response Formats:

⚡ Processing

{
    "status": "processing",
    "orderid": "ORD-001",
    "message": "Order is being processed"
}
                                    

✅ Success

{
    "status": "success",
    "orderid": "ORD-001",
    "message": "Topup completed successfully",
    "nickname": "Player_8307359292"
}
                                    

❌ Failed

{
    "status": "failed",
    "orderid": "ORD-001",
    "message": "Invalid voucher code",
    "error_code": "INVALID_VOUCHER"
}
                                    

⚠️ Partial

{
    "status": "partial",
    "orderid": "ORD-001",
    "success_count": 2,
    "failed_count": 1,
    "message": "Some vouchers redeemed successfully"
}
                                    