Developers

Reseller API Documentation

Place orders programmatically. Your reseller discount is applied automatically and orders are charged to your wallet balance.

JSON Bearer token Webhooks

Base URL https://buildspare.site

Auth Order Bulk Response Status Webhooks tag_line UID cURL

You are not an approved reseller yet. Apply on your account page to get your API key.

1 Authentication

Every request must include your API key in the Authorization header as a Bearer token.

Authorization: Bearer YOUR_API_KEY

Base URL

https://buildspare.site

2 Place an Order POST

/api/resaleorder

{
  "account_info": { "player_id": "123456789" },
  "selectedPackage": { "id": 1, "tag_line": "100" },
  "quantity": 1,
  "order_id": "YOUR-REF-0001",
  "url": "https://your-store.com/webhooks/topup"
}

Field	Type	Required	Description
account_info.player_id	string	Yes	Player/game ID (min 6 chars). Use "noplayerid" if not needed.
selectedPackage.id	number	Yes (unused)	Any positive number.
selectedPackage.tag_line	string	Yes	Selects the package — must match exactly.
quantity	number	Yes	Positive integer.
order_id	string	No	Your own reference.
url	string	Recommended	Webhook URL for async delivery results.

Swipe the table sideways to see all columns.

2b Bulk Order (instant codes) POST

/api/resaleorder/bulk — For code/voucher packages. No player ID needed.

{
  "items": [
    { "tag_line": "100", "quantity": 1 },
    { "tag_line": "200", "quantity": 2 }
  ]
}

3 Response Format

{
  "success": true,
  "message": "Order Placed Successfully",
  "order": {
    "id": 10234,
    "status": "complete",
    "payment": "complete",
    "content": "ABCD-EFGH-1234",
    "due_used": 0
  }
}

HTTP	Message	Meaning
200	Your selected stock is not available	Out of stock — auto refunded.
200	Insufficient balance	Top up your wallet and retry.
200	Package not found	tag_line didn't match any package.
401	Unauthorized	Invalid or missing API key.
422	validation message	A required field is missing/invalid.

4 Check Order Status GET

/api/resaleorder/status?order_id=YOUR-REF-0001

curl "https://buildspare.site/api/resaleorder/status?order_id=YOUR-REF-0001" \
  -H "Authorization: Bearer YOUR_API_KEY"

5 Webhooks

Send a url in your order request and we will POST the result when delivered or failed.

POST <your url>
Content-Type: application/json

{
  "orderid": "YOUR-REF-0001",
  "status": "success",
  "content": "ABCD-EFGH-1234",
  "codes": ["ABCD-EFGH-1234"]
}

6 Finding a package's tag_line

Each package has a tag_line. See the live pricing on the packages page.

7 Validate Player UID (optional) GET

/api/checkuid?uid=123456789 — No authentication required.

GET https://buildspare.site/api/checkuid?uid=123456789
// 200 -> { "message": "PlayerUsername" }
// 400 -> { "message": "UID INVALID" }

8 cURL Example

curl -X POST "https://buildspare.site/api/resaleorder" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_info": { "player_id": "123456789" },
    "selectedPackage": { "id": 1, "tag_line": "100" },
    "quantity": 1,
    "order_id": "YOUR-REF-0001",
    "url": "https://your-store.com/webhooks/topup"
  }'