Create Currency Offer – PlayerAuctions Help Center

Posthttps://seller-api.playerauctions.com/api/v1/offers/currency

Create a new currency offer.

Related flow: Currency Offer Creation Flow

i. Request Example


{
    "gameId": 9479,
    "title": "this is a simple title",
    "offerDesc": "this is a simple description",
    "offerDuration": 30,
    "agreeCheck": true,
    "price": 5,
    "serverId": 9485,
    "categoryId": 9698,
    "instruction": "this is a simple instruction.",
    "deliveryGuarantee": 5,
    "totalUnit": 100,
    "minUnitPerOrder": 1,
    "currencyPerUnit": 100,
    "currencyTypeId": null,
    "discounts": [
        {
            "startPrice": 10,
            "discountRate": 2
        },
        {
            "startPrice": 20,
            "discountRate": 4
        },
        {
            "startPrice": 50,
            "discountRate": 8
        }
    ]
}

ii. Request Parameters

Body Parameters

Parameter	Type	Required	Description
gameId	int	Yes	Game ID.
price	decimal	Yes	Price per unit.
offerDuration	int	Yes	Offer duration in days. Available values: 3, 7, 14, 30.
agreeCheck	boolean	Yes	Indicates whether you agree to the [Secure Seller Delivery Agreement]. Only `true` is accepted.
title	string	Yes	Offer title.
offerDesc	string	No	Offer description.
minUnitPerOrder	int	Yes	Minimum units per order.
totalUnit	int	Yes	Total units available.
currencyPerUnit	int	Yes	Currency amount per unit.
currencyTypeId	int	No*	The ID of the currency type. Required only for games with multiple currency types. You can get the data from the api/v1/games/{gameId}/currencytypes endpoints.
instruction	string	No	Delivery instructions.
deliveryGuarantee	int	Yes	Delivery guarantee time. You can get the list of available options from the api/v1/games/{id}/{type}/deliveryTimes endpoint.
categoryId	int	Yes	Faction ID (The {id} of the leaf node). You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint.
serverId	int	Yes	Server ID {id}. You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint.
discounts	array	No	Discount rules for the offer.
└─ startPrice	int	Yes	Starting price for the discount.
└─ discountRate	int	Yes	Discount rate for the discount.

iii. Response Example

Success Response

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "offerId": 71394132,
    "navigateURL": "https://www.playerauctions.com/lol-riot-points/71394132c!simple-title/",
    "title": "Simple Title",
    "productType": "currency",
    "gameName": "League of Legends",
    "productName": "Currency",
    "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090157435744.png",
    "imageBlacklist": ""
  }
}

Error Response

{
  "code": 10002,
  "message": "Invalid parameter.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

iv. 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	Created offer URL.
data.title	string	Offer title.
data.productType	string	Product type.
data.gameName	string	Game name.
data.productName	string	Product name.
data.screenShot	string	Image URL for the offer.
data.imageBlacklist	string	Blacklisted offer image identifier. Empty indicates that it is not on the blacklist.