Xsolla-logo

Gutscheincode einlösen

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

Löst einen Gutscheincode ein. Der Benutzer erhält nach dem Einlösen eines Gutscheins einen Bonus.

SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Example: 44056
Request Body schema: application/json
coupon_code
string [ 1 .. 128 ] characters
Default: "WINTER2021"

Eindeutiger Gutscheincode. Enthält Buchstaben und Ziffern.

object

Die von einem Benutzer ausgewählte Belohnung. Der Objektschlüssel ist eine SKU einer Einheit und der Wert ist eine SKU eines der Artikel in einer Einheit.

property name*
additional property
string
Responses
200

Gutschein wurde erfolgreich eingelöst.

401

Authentifizierung nicht bestanden oder falsch.

403

Autorisierungs-Header nicht gesendet.

404

Geben Sie einen gültigen Gutscheincode ein.

422

Ungültige Anfrage.

Request samples
application/json
{
  • "coupon_code": "WINTER2021",
  • "selected_unit_items": {
    }
}
Response samples
application/json
{
  • "items": [
    ]
}