API Documentation

API Status: Active v2.0 LTS

আপনার সিস্টেমে TN API HUB-এর API ইন্টিগ্রেট করার জন্য নিচের নির্দেশিকাগুলো অনুসরণ করুন। সমস্ত রিকোয়েস্ট JSON ফরম্যাটে করতে হবে এবং রেসপন্সও JSON ফরম্যাটেই রিটার্ন হবে।

1. UniPin Topup API

POST

Base URL

UniPin/UC https://topupbd.top/api/topup/uc

Authentication

Every request must include your API key as a header or query parameter:

Header: Authorization: your_api_key_here

Query Parameter: ?api_key=your_api_key_here

Request Parameters

Parameter	Type	Required	Description
`api_key`	string	* Yes	Your API key from dashboard
`orderid`	string	* Yes	Your unique order ID for tracking
`playerid`	string	* Yes	Free Fire player UID (minimum 8 digits)
`code`	string	* Yes	UniPin voucher codes (comma-separated, max 5)
`url`	string	* Yes	Webhook URL for callback notification

Example Request

{
  "api_key": "TPBD-XXXX-XXXX",
  "orderid": "ORD-2026-001",
  "playerid": "1234567890",
  "code": "BDMB-T-S-01885045 6591-4164-9992-5148",
  "url": "https://yourdomain.com/api/callback"
}

cURL Example

curl -X POST https://topupbd.top/api/topup/uc \
  -H "Authorization: TPBD-XXXX-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "orderid": "ORD-2026-001",
    "playerid": "1234567890",
    "code": "BDMB-T-S-01885045 6591-4164-9992-5148",
    "url": "https://yourdomain.com/api/callback"
}'

Processing (200)

{
  "status": "processing",
  "orderid": "ORD-2026-001",
  "timestamp": "2026-01-18 19:30:25"
}

Success (200)

{
  "status": "success",
  "orderid": "ORD-2026-001",
  "message": "Topup completed"
}

Invalid Player ID (400)

{
  "status": "error",
  "error_code": "INVALID_PLAYERID",
  "message": "Invalid playerid"
}

Consumed Voucher (409)

{
  "status": "error",
  "error_code": "VOUCHER_CONSUMED",
  "message": "Voucher already consumed"
}

Limit Exceeded (401)

{
  "status": "error",
  "error_code": "TOKEN_ERROR",
  "message": "Insufficient limit (need 1, have 0)",
  "used": 100,
  "limit": 100,
  "remaining": 0
}

Webhook Callback

PinBot will send the final result to your webhook URL

POST

Callback — All Success

{
  "status": "success",
  "orderid": "ORD-2026-001",
  "content": {
    "batch": [
      {
        "uc": "BDMB-T-S-01885045 6591-4164-9992-5148",
        "ok": true,
        "detail": "✅ Success"
      }
    ],
    "callback_url": "https://yourdomain.com/api/callback"
  },
  "nickname": "PlayerName"
}

Callback — All Failed

{
  "status": "failed",
  "orderid": "ORD-2026-001",
  "content": {
    "batch": [
      {
        "uc": "BDMB-T-S-01885045 6591-4164-9992-5148",
        "ok": false,
        "detail": "❌ Consumed Voucher"
      }
    ],
    "callback_url": "https://yourdomain.com/api/callback"
  },
  "nickname": "PlayerName"
}

Callback — Partial Success

{
  "status": "partial",
  "orderid": "ORD-2026-001",
  "content": {
    "batch": [
      {
        "uc": "BDMB-T-S-01885045 6591-4164-9992-5148",
        "ok": true,
        "detail": "✅ Success"
      },
      {
        "uc": "BDMB-T-S-01885046 6591-4164-9992-5149",
        "ok": false,
        "detail": "❌ Consumed Voucher"
      }
    ],
    "callback_url": "https://yourdomain.com/api/callback"
  },
  "nickname": "PlayerName"
}

2. Nickname Check

GET

Base URL

Name Check https://topupbd.top/api/name-check

Request Parameters (GET)

Parameter	Type	Required	Description
`api`	string	* Yes	Your API key from dashboard
`uid`	string	* Yes	Free Fire player UID to check

Example Request

GET https://topupbd.top/api/name-check?api=YOUR_API_KEY&uid=1234567890

cURL Example

curl -X GET "https://topupbd.top/api/name-check?api=YOUR_API_KEY&uid=1234567890"

Success (200)

{
  "status": true,
  "data": {
    "status": true,
    "username": "ADNANツ",
    "developer": "@TEAMDXA"
  }
}

Error (400)

{
  "status": false,
  "data": {
    "message": "Invalid or expired API Key",
    "developer": "@TEAMDXA"
  }
}