Create a new offer

configures automated price adjustments for an offerconfigures automated price adjustments for an offerconfigures automated price adjustments for an offeThe following API allow you to create a new offer/auction on Driffle.

POST /offer

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Response

Required arguments

Param	Param Type	Type	Required	Description
product	body	{ productId: number }	Yes	ProductId for which offer needs to be created
yourPrice	body	Number	No (Either yourPrice or retailPrice is required)	Selling price. Commission will be applied to this price.
retailPrice	body	Number	No (Either yourPrice or retailPrice is required)	Retail Price or Buy Box Price. Commission is subtracted from this price.

Optional arguments

Case - Declared Stock

1. Either keys or declaredStock number should be provided in the request.

2. Either yourPrice or retailPrice should be provided in the request.

Param	Param Type	Type	Required	Description
product	body	{ productId: number }	Yes	ProductId for which offer needs to be created
yourPrice	body	Number	No (Either yourPrice or retailPrice is required)	Selling price. Commission will be applied to this price.
retailPrice	body	Number	No (Either yourPrice or retailPrice is required)	Retail Price or Buy Box Price. Commission is subtracted from this price.
cogs	body	Number	No	Cost of purchasing a single key
keys	body	array<KeyUploadType>, see KeyUploadType	No	List of Keys to be uploaded - optional
declaredStock	body	Number	No	Number of keys to sell through declared stock feature - optional
wholesale	body	{"enabled":true,"tiers":[{"level":1,"discount":10},{"level":2,"discount":15}]}	No	Specifies wholesale enable status and tier-based discounts by purchase quantity. Wholesale Pricing Feature
automatePriceOptions	body	{"lowerPriceLimit":8.99,"upperPriceLimit":12.99,"priceChangeFactor":0.05,"priceChangeInterval":3600,"automatePriceStatus":"enable"}	No	configures automated price adjustments for an offer Automate Pricing

Case - Direct Topup webhook

Param	Param Type	Type	Required	Description
product	body	{ productId: number }	Yes	ProductId for which offer needs to be created
yourPrice	body	Number	No (Either yourPrice or retailPrice is required)	Selling price. Commission will be applied to this price.
retailPrice	body	Number	No (Either yourPrice or retailPrice is required)	Retail Price or Buy Box Price. Commission is subtracted from this price.
cogs	body	Number	No	Cost of purchasing a single key
declaredStock	body	Number	Yes	Number of direct topup allowed for sell
automatePriceOptions	body	{"lowerPriceLimit":8.99,"upperPriceLimit":12.99,"priceChangeFactor":0.05,"priceChangeInterval":3600,"automatePriceStatus":"enable"}	No	configures automated price adjustments for an offer Automate Pricing

Case - Pre-Order Product

Declared stock is now available for pre-order products.

For more details, see the Pre-Order-Declare-Stock documentation.

Param	Param Type	Type	Required	Description
product	body	{ productId: number }	Yes	ProductId for which offer needs to be created
yourPrice	body	Number	No (Either yourPrice or retailPrice is required)	Selling price. Commission will be applied to this price.
retailPrice	body	Number	No (Either yourPrice or retailPrice is required)	Retail Price or Buy Box Price. Commission is subtracted from this price.
cogs	body	Number	No	Cost of purchasing a single key
keys	body	array<KeyUploadType>, see KeyUploadType	No	List of Keys to be uploaded - optional
auctionedKeys	body	Number	Yes	Maximum number of orders you can accept for a product (Only in preReleased products)

KeyUploadType

Param	Type	Required	Description
key	string	Yes	Key in plain text or In case of image keys, Send a base64 encoded string. For more info Read RFC 2397.
name	string	Yes, in case of image key	Name of key
type	string	Yes	Key format. supported values: text, image

200

{
  "message": "string",
  "statusCode": 200,
  "offer": {
    "offerId": 0,
    "productId": 0,
    "yourPrice": 0,
    "finalSellingPrice": 0,
    "availableStock": 0
  }
}

400

401

403

500

post

Header parameters

AuthorizationstringRequired

Authorization token in Bearer format. Example: Bearer dvakycjgw8liyd278y

Body

application/json

or

Responses

200

Default Response

application/json

400

Bad Request. Wrong/Invalid params format.

application/json

401

UnAuthorized request. Invalid/Expired token

application/json

403

Forbidden Request. Action not allowed or Rate Limit exhausted.

application/json

500

Server Error.

application/json

post

/offer

HTTPcURLJavaScriptPython

POST /api/seller/legacy/offer HTTP/1.1
Host: services.driffle.com
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "product": {
    "productId": 1
  },
  "yourPrice": 1,
  "retailPrice": 1,
  "cogs": 1,
  "keys": [
    {
      "key": "text",
      "name": "text",
      "type": "text"
    }
  ],
  "auctionedKeys": null
}

{
  "message": "text",
  "statusCode": 1,
  "offer": {
    "offerId": 1,
    "productId": 1,
    "yourPrice": 1,
    "finalSellingPrice": 1,
    "availableStock": 1
  }
}