Pinchai API Overview

The Pinchai API connects your top-up website directly with Unipin Suppliers, Garena Shell, and Game Topup automation services. It transforms standard HTTP API requests into high-speed order fulfillment in real-time.

Pinchai API হলো একটি উচ্চগতির সংযোগ মাধ্যম যা আপনার ওয়েবসাইটকে গেম টপ-আপ সার্ভিসের সাথে যুক্ত করে। আপনার মার্চেন্ট আইডি ও API Key পাওয়ার জন্য সরাসরি টেলিগ্রামে যোগাযোগ করুন।

API Base URL

http://localhost:8000

Authentication

Every request must include your API Key in the X-API-Key HTTP Header or query parameter (?token=YOUR_KEY).

Parameter	Location	Type	Description
X-API-Key	Header	string	Your secret API Key (e.g. `pc_9a1b2c3d...`)
merchant	Query Parameter	string	Target merchant ID for balance deduction (e.g. `7024464702`)

Error Reference

Status Code	Error JSON	Meaning
`401 Unauthorized`	`{"detail": "Invalid API key"}`	Wrong or missing API key
`402 Payment Required`	`{"detail": "insufficient_balance"}`	Main balance is lower than order price
`402 Payment Required`	`{"detail": "due_limit_exceeded"}`	Allowed credit/baki limit reached
`409 Conflict`	`{"detail": "out_of_stock"}`	Seller bot out of voucher stock
`400 Bad Request`	`{"detail": "player_id must be 5+ digits"}`	Invalid player UID parameter

GET /getinfo

Look up any Free Fire player by UID. Returns player nickname, level, and likes instantly for pre-order verification.

Query Parameters

Name	Type	Required	Description
uid	string	Required	Player Free Fire UID
region	string	Optional	Server region (e.g. `BD`, `SG`, `IND`). Optional (defaults to `BD`)

cURL Request Example

curl "BASE_URL/getinfo?uid=1854028907" \
  -H "X-API-Key: pc_yourkey"

200 OK Response

{
  "status": "success",
  "uid": "1854028907",
  "region": "BD",
  "nickname": "—͟͞MITULㅤ米图尔",
  "level": 73,
  "likes": 26102,
  "time_taken": "0.928s"
}

POST /uc

Purchase Unipin UC voucher codes instantly. Synchronous response returning voucher codes ready to deliver.

Body Parameters (JSON)

Field	Type	Required	Description
item	string	Required	Code and quantity formatted as `code:qty` (e.g. `80:2,161:1`)
currency	string	Required	`bdt` or `usdt`
credit	string	Required	`balance` (deduct main balance) or `baki` (use credit line)
orderid	string	Required	Your unique order ID reference

cURL Request

curl -X POST "BASE_URL/uc?merchant=7024464702" \
  -H "X-API-Key: pc_yourkey" \
  -H "Content-Type: application/json" \
  -d '{
    "item": "80:2,161:1",
    "currency": "bdt",
    "credit": "balance",
    "orderid": "ORD-1002"
  }'

200 OK Response

{
  "status": "success",
  "orderid": "ORD-1002",
  "currency": "bdt",
  "payment": "balance",
  "total": 160.0,
  "balance_after": 840.0,
  "due_after": 0.0,
  "codes": {
    "80UC": {
      "label": "115 ◆",
      "codes": [
        "BDMB-J-S-03811638 5562-1363-6736-1546",
        "BDMB-J-S-03814108 8717-4446-3425-9452"
      ],
      "qty": 2,
      "price": 50.0
    },
    "161UC": {
      "label": "Weekly ◆",
      "codes": [
        "BDMB-Q-S-12511213 1111-7557-1794-1734"
      ],
      "qty": 1,
      "price": 60.0
    }
  }
}

POST /tp

Direct In-Game Topup via player UID. Supports instant execution & asynchronous Webhook callbacks when url parameter is passed.

cURL Request Example

curl -X POST "BASE_URL/tp?merchant=7024464702" \
  -H "X-API-Key: pc_yourkey" \
  -H "Content-Type: application/json" \
  -d '{
    "playerid": "3625452741",
    "item": "161:1",
    "currency": "bdt",
    "credit": "balance",
    "orderid": "ORD_652718",
    "url": "https://yourwebsite.com/api/webhook/callback"
  }'

Immediate Webhook Acknowledgment

{"status": "processing", "orderid": "ORD_652718"}

200 OK / Webhook Callback Success Response

{
  "status": "success",
  "orderid": "ORD_652718",
  "player_id": "3625452741",
  "player_name": "Xz!ᅠSquadron",
  "currency": "bdt",
  "total": 147.5,
  "balance_after": 449.8,
  "due_after": 0,
  "fail_reason": null,
  "voucher_detail": {
    "api_status": "success",
    "items": [
      {
        "status": "success",
        "code": "UPBD-N-S-16602103 1737-7916-4191-1411",
        "product": "161:1",
        "unit_price": 147.5
      }
    ]
  }
}

POST /topup

Direct Profile Likes & Package Topup via Free Fire UID.

cURL Request Example

curl -X POST "BASE_URL/topup?merchant=7024464702" \
  -H "X-API-Key: pc_yourkey" \
  -H "Content-Type: application/json" \
  -d '{
    "playerid": "3625452741",
    "package": "100like",
    "orderid": "LIKE_9981"
  }'

200 OK Response

{
  "status": "success",
  "orderid": "LIKE_9981",
  "player_id": "3625452741",
  "player_name": "Xz!ᅠSquadron",
  "package": "100like",
  "total": 35.0,
  "balance_after": 414.8,
  "due_after": 0
}

POST /verify

Verify bKash / Nagad / Mobile banking Transaction ID and automatically credit merchant balance in database.

cURL Request

curl -X POST "BASE_URL/verify" \
  -H "X-API-Key: pc_yourkey" \
  -H "Content-Type: application/json" \
  -d '{"trxid": "9B8A7C6D5E"}'

200 OK Response

{
  "success": true,
  "trxid": "9B8A7C6D5E",
  "gateway": "bkash",
  "raw_amount": 500.0,
  "credited": 492.5,
  "prev_balance": 1000.0,
  "new_balance": 1492.5,
  "currency": "BDT"
}

POST /usdverify

Verify USDT (BinancePay / TRC20 / BEP20) deposit transaction and credit USD balance.

cURL Request

curl -X POST "BASE_URL/usdverify" \
  -H "X-API-Key: pc_yourkey" \
  -H "Content-Type: application/json" \
  -d '{"trxid": "0xabc1237890def"}'

200 OK Response

{
  "success": true,
  "trxid": "0xabc1237890def",
  "gateway": "usdt",
  "raw_amount": 50.0,
  "credited": 50.0,
  "prev_balance": 100.0,
  "new_balance": 150.0,
  "currency": "USDT"
}