Create Promotion

Xsolla Developers

Create PromotionServer-sideAdmin

post/merchants/{merchant_id}/promotions

Create a new promotion.

Notice

This API call does not contain the project_id path-parameter, so you need to use the API key that is valid in all the company’s projects to set up authorization.

SecuritybasicAuth

Request

path Parameters

merchant_id

required

integer

Merchant ID.

Request Body schema: application/json

project_id

required

integer

Project ID.

technical_name

required

string

Technical name of the promotion.

object

Array of localized labels to show in the payment UI.

en	string English.
ru	string Russian.
cs	string Czech.
ar	string Arabic.
bg	string Bulgarian.
cn	string Chinese (Simplified).
tw	string Chinese (Traditional).
fr	string French.
de	string German.
he	string Hebrew.
it	string Italian.
ko	string Korean.
pl	string Polish.
pt	string Portuguese.
ro	string Romanian.
es	string Spanish.
th	string Thai.
tr	string Turkish.
vi	string Vietnamese.
ja	string Japanese.

object

Array of localized promotion names.

en	string English.
ru	string Russian.
cs	string Czech.
ar	string Arabic.
bg	string Bulgarian.
cn	string Chinese (Simplified).
tw	string Chinese (Traditional).
fr	string French.
de	string German.
he	string Hebrew.
it	string Italian.
ko	string Korean.
pl	string Polish.
pt	string Portuguese.
ro	string Romanian.
es	string Spanish.
th	string Thai.
tr	string Turkish.
vi	string Vietnamese.
ja	string Japanese.

object

Array of localized promotion descriptions.

en	string English.
ru	string Russian.
cs	string Czech.
ar	string Arabic.
bg	string Bulgarian.
cn	string Chinese (Simplified).
tw	string Chinese (Traditional).
fr	string French.
de	string German.
he	string Hebrew.
it	string Italian.
ko	string Korean.
pl	string Polish.
pt	string Portuguese.
ro	string Romanian.
es	string Spanish.
th	string Thai.
tr	string Turkish.
vi	string Vietnamese.
ja	string Japanese.

integer

read_only

boolean

show_banner

boolean

enabled

boolean

Responses

201

Created.

Request samples

application/json

{"description": {"en": "Promotion with 30% discount",
"ru": "Акция со скидкой 30%"
},
"label": {"en": "30%",
"ru": "30%"
},
"name": {"en": "30% discount",
"ru": "скидка 30%"
},
"project_id": 12345,
"technical_name": "Sale promotion"
}

Response samples

application/json

{"id": 17890
}