Canjear código de cupón

Canjear código de cupónClient-side

post/v2/project/{project_id}/coupon/redeem

Canjea un código de cupón. El usuario recibe una bonificación tras canjear un cupón.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

ID del proyecto. Encontrará este parámetro en su cuenta Publisher junto al nombre del proyecto.

Example: 44056

Request Body schema: application/json

coupon_code

string [ 1 .. 128 ] characters

Default: "WINTER2021"

Código único de cupón. Contiene letras y números.

object

La recompensa que selecciona un usuario. La clave del objeto es un código de artículo (SKU) de una unidad, y el valor es un SKU de uno de los artículos de una unidad.

property name*

additional property

string

Responses

200

El cupón fue canjeado correctamente.

401

Autenticación no superada o errónea.

403

No se envió el encabezado de autorización.

404

Introduzca un código de cupón válido.

422

Solicitud no válida.

Request samples

application/json

{"coupon_code": "WINTER2021",
"selected_unit_items": {"game_1": "game_1_steam",
"game_2": "game_2_playstation"
}
}

Response samples

application/json

{"items": [{"attributes": [ ],
"description": "Take it, take it all! All of Xsolla's riches in one Mega Booster.",
"groups": [{"external_id": "powerups",
"name": "Power Ups"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": null
},
"is_free": true,
"name": "Xsolla Booster Mega",
"price": null,
"quantity": 1,
"sku": "booster_mega_1",
"type": "virtual_good",
"virtual_item_type": "consumable",
"virtual_prices": [ ]
}
]
}