Query Topup Offer – PlayerAuctions Help Center

GET api/v1/offers/topup/{id}

Query a single topup offer by ID.

i. Request Parameters

Path Parameters

Parameter	Type	Required	Description
id	int	Yes	Offer ID.

ii. Response Example

Success Response

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "minUnitPerOrder": 10.000,
    "totalUnit": 2000,
    "currencyPerUnit": 10.000,
    "instruction": "Simple Instruction.",
    "deliveryGuarantee": 6,
    "discounts": [],
    "categoryId": 3638,
    "serverId": 3638,
    "deliveryTime": 0,
    "topUpCategoryId": 102,
    "deliveryType": 1,
    "deliveryTypeName": "UID",
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Simple Title",
    "offerDesc": "<p>Simple Description.</p>",
    "offerId": 71394388,
    "isAgree": false,
    "memberId": 678694,
    "state": 1,
    "productType": "topup"
  }
}

Response Parameters

Parameter	Type	Description
code	int	Response code. 10000 indicates success, other values indicate an error.
message	string	Response message. Contains error details on failure.
requestId	string	Unique identifier for the request, used for tracking.
data	object	Topup offer details.
minUnitPerOrder	decimal	Minimum units required per order.
totalUnit	int	Total available units for this offer.
currencyPerUnit	decimal	Currency value per unit.
instruction	string	Instructions for the topup process.
deliveryGuarantee	int	Delivery guarantee time in hours.
discounts	array	List of applicable discounts.
categoryId	int	Category ID of the offer.
serverId	int	Server ID for the game.
deliveryTime	int	Estimated delivery time.
topUpCategoryId	int	Topup category ID.
deliveryType	int	Type of delivery method. 1 (UID), 2 (Manual Top-Up).
deliveryTypeName	string	Name of the delivery type (e.g., "UID", "Manual Top-Up").
gameId	int	Game ID associated with the offer.
price	decimal	Price of the offer.
offerDuration	int	Duration of the offer in days.
title	string	Title of the offer.
offerDesc	string	HTML description of the offer.
offerId	int	Unique identifier of the offer.
isAgree	boolean	Whether the user has agreed to terms.
memberId	int	Member ID of the offer creator.
state	int	State of the offer (1 for active).
productType	string	Type of product (e.g., "topup").

iii. Error Response Example

Error Response

{
  "code": 10002,
  "message": "Offer not found.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

Common Error Codes

Parameter	Type	Description
code	int	Error code. Common values: 10002 (Invalid parameter), 50001 (Internal server error).
message	string	Detailed error message explaining what went wrong.
requestId	string	Unique identifier for the request, used for tracking.