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

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:

ParameterTypeRequiredDescription
api_keystring*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:

ParameterTypeRequiredDescription
api_keystring*Your API key
orderidstring*Unique order ID
playeridstring*Player UID
codestring*Voucher code
packageint*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" }