Update offer chain

Xsolla Developers

To Publisher Account

Update offer chainServer-sideAdmin

put/v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}

Updates a particular offer chain.

SecuritybasicAuth

Request

path Parameters

project_id required	integer Project ID. You can find this parameter in your Publisher Account next to the name of the project. Example: 44056
offer_chain_id required	integer Offer chain ID. Example: 101

Request Body schema: application/json

required

(two-letter (object or null)) or (five-letter (object or null))

Object with localizations for item’s name. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character language codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the documentation.

One of:

Two-letter lowercase language codes.

en	string or null English
ar	string or null Arabic
bg	string or null Bulgarian
cn	string or null Chinese (Simplified)
cs	string or null Czech
de	string or null German
es	string or null Spanish (Spain)
fr	string or null French
he	string or null Hebrew
it	string or null Italian
ja	string or null Japanese
ko	string or null Korean
pl	string or null Polish
pt	string or null Portuguese
ro	string or null Romanian
ru	string or null Russian
th	string or null Thai
tr	string or null Turkish
tw	string or null Chinese (Traditional)
vi	string or null Vietnamese
km	string or null Khmer
id	string or null Indonesian
lo	string or null Lao
my	string or null Burmese
ph	string or null Filipino
ne	string or null Nepali

date_start

required

string <date-time>

Date when the offer chain starts.

required

Array of objects

Array

step_number

required

integer >= 1

Step number.

is_free

required

boolean

Indicates whether the offer chain step is free:

If true, the step must be claimed using the Claim free offer chain step call.
If false, it must be purchased using the Create order for paid offer chain step call.

required

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ Unique item ID. The SKU may contain only lowercase and uppercase Latin alphanumeric characters, periods, dashes, and underscores.
quantity required	integer >= 1 Reward item quantity for this chain step.
order	integer or null >= 0 Reward order for the offer chain step.

step_id

integer or null >= 1

Unique chain step ID. Specify it during update to retain user progress for this step.

is_enabled

required

boolean

integer

Unique offer chain ID.

order

integer

Defines arrangement order.

(two-letter (object or null)) or (five-letter (object or null))

Object with localizations for item’s description. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character locale codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the documentation.

One of:

Two-letter lowercase language codes.

en	string or null English
ar	string or null Arabic
bg	string or null Bulgarian
cn	string or null Chinese (Simplified)
cs	string or null Czech
de	string or null German
es	string or null Spanish (Spain)
fr	string or null French
he	string or null Hebrew
it	string or null Italian
ja	string or null Japanese
ko	string or null Korean
pl	string or null Polish
pt	string or null Portuguese
ro	string or null Romanian
ru	string or null Russian
th	string or null Thai
tr	string or null Turkish
tw	string or null Chinese (Traditional)
vi	string or null Vietnamese
km	string or null Khmer
id	string or null Indonesian
lo	string or null Lao
my	string or null Burmese
ph	string or null Filipino
ne	string or null Nepali

date_end

string or null <date-time>

Date when the offer chain ends. Can be null. If date_end is null, the offer chain will not have a time limit.

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null))

Reset period of the offer chain.

One of:

Weekly reset of the offer chain.

interval_type required	string Frequency of the offer chain reset. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... The time when the offer chain is reset in the specified time zone (rounding to hours). For example, the reset time is set to 01:00 for the Kuala Lumpur time zone (GMT+8), the value of the `time` parameter is `01:00:00+08:00`.
day_of_week required	integer [ 1 .. 7 ] Day of the week when the offer chain is reset, where `1` is Monday and `7` is Sunday.

Responses

204

Offer chain was successfully updated.

401

Basic authentication not passed or wrong. Make sure you used basic authentication or correct credentials.

404

The offer chain was not found.

422

Invalid offer chain configuration.

Request samples

application/json

{"name": {"en": "Updated offer chain",
"ru": "Обновленная цепочка товаров"
},
"description": {"en": "Updated offer chain description"
},
"order": 4,
"date_start": "2023-04-15T18:16:00+05:00",
"date_end": null,
"is_enabled": true,
"steps": [{"step_number": 1,
"is_free": false,
"items": [{"sku": "vg_enabled_shown_in_store_1",
"quantity": 1
}
]
},
{"step_number": 2,
"is_free": false,
"items": [{"sku": "vg_enabled_shown_in_store_2",
"quantity": 1
}
]
},
{"step_id": 10,
"step_number": 3,
"is_free": true,
"items": [{"sku": "vg_not_shown_in_store",
"quantity": 1
}
]
},
{"step_id": 8,
"step_number": 4,
"is_free": false,
"items": [{"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg",
"quantity": 1
}
]
},
{"step_number": 5,
"is_free": true,
"items": [{"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1",
"quantity": 1
}
]
}
]
}

Response samples

application/json

{"statusCode": 401,
"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred"
}