POST api/v1/offers/topup
Create a new topup offer.
i. Request Example
{
"gameId": 3637,
"title": "Simple Title",
"offerDesc": "<p>Simple Description.</p>",
"offerDuration": 30,
"agreeCheck": true,
"price": 5,
"serverId": 3638,
"categoryId": 3638,
"instruction": "Simple Instruction.",
"deliveryGuarantee": 6,
"totalUnit": 2000,
"minUnitPerOrder": 10,
"currencyPerUnit": 10,
"topUpCategoryId": 102
}
ii. Request Parameters
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| gameId | int | Yes | Game ID. |
| price | decimal | Yes | Offer price. |
| offerDuration | int | Yes | Offer duration in days(3, 7, 14, 30). |
| agreeCheck | bool | Yes | Agreement check. |
| title | string | Yes | Offer title. |
| offerDesc | string | No | Offer description. |
| minUnitPerOrder | decimal | Yes | Minimum units per order. |
| totalUnit | int | Yes | Total units available. |
| currencyPerUnit | decimal | Yes | Currency amount per unit. |
| instruction | string | No | Delivery instructions. |
| deliveryGuarantee | int | Yes | Delivery guarantee time in minutes. |
| categoryId | int | Yes | Category ID. |
| serverId | int | Yes | Server ID. |
| topUpCategoryId | int | Yes | Topup category ID. |
| deliveryType | int | Yes | Delivery type: 1 (UID), 2 (Manual Top-Up). |
iii. Response Example
Success Response
{
"code": 10000,
"message": "",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"data": {
"offerId": 71394388,
"navigateURL": "https://www.playerauctions.com/lol-top-up/71394388t!simple-title/",
"title": "Simple Title",
"productType": "topup",
"imageBlacklist": ""
}
}
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.offerId | int | Created offer ID. |
| data.navigateURL | string | URL to navigate to the offer page. |
| data.title | string | Offer title. |
| data.productType | string | Product type: "topup" for topup offers. |
| data.imageBlacklist | string | Image blacklist. |
iv. Error Response Example
Error Response
{
"code": 10002,
"message": "Invalid parameter.",
"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. |