🚀 Auto Topup & UniPin Redeem API

Welcome to the official API documentation. Integrate our automated service into your application (Telegram Bots, Sketchware Apps, or Websites) to deliver Game Topups and UniPin Vouchers seamlessly.

1. Place Order (Topup / Redeem)

This is the primary endpoint to place an order. It operates asynchronously and will return a "processing" status immediately.

GET https://api.codereaperbd.top/api/uc.php

Query Parameters

Parameter	Type	Required	Description
`playerid`	String	Yes	The customer's Game UID.
`code`	String	Yes	UniPin Voucher code or Shop selector (e.g., UPBD-Q-S-...).
`orderid`	String	No	Your unique system order ID. Auto-generated if left empty.

Example Request

https://api.codereaperbd.top/api/uc.php?playerid=8742381676&code=UPBD-Q-S-02816864%204237-3657-7159-6735

Success Response

{
  "status": "processing",
  "orderid": "NEXA-1789193512",
  "message": "Order is processing. Save this orderid to check final status."
}

2. Check Final Order Status

Use this endpoint to check if an order has been successfully completed or failed. (Recommended to check 10-15 seconds after placing the order).

GET https://api.codereaperbd.top/api/check.php

Query Parameters

Parameter	Type	Required	Description
`orderid`	String	Yes	The Order ID returned from the Place Order endpoint.

Example Request

https://api.codereaperbd.top/api/check.php?orderid=NEXA-1789193512

Response (Example: Completed)

{
  "status": "completed",
  "orderid": "NEXA-1789193512",
  "nickname": "MAHADIメKing모"
}

Response (Example: Failed)

{
  "status": "failed",
  "orderid": "NEXA-1789193512",
  "content": {
    "batch": [
      {
        "uc": "UPBD-Q-S-...",
        "ok": false,
        "detail": "Consumed Voucher ❌"
      }
    ]
  },
  "nickname": "MAHADIメKing모"
}

3. Webhook Callback (Internal System)

Once an order finishes processing on the Nexa server, it automatically POSTs the final result to your webhook receiver.

POST https://api.codereaperbd.top/api/callback.php

⚠️ Note: This endpoint is handled internally. You do not need to call this manually from your app or bot.