Xsolla-logo

Promocode einlösenClient-side

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

Löst einen Promocode aus einer Werbeaktion ein. Nach dem Einlösen eines Promocodes erhält der Benutzer kostenlose Artikel und/oder der Preis des Warenkorbs und/oder bestimmter Artikel wird reduziert.

SecurityAuthForCart
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
object or null
id
required
string
Default: "current"

Warenkorb-ID.

coupon_code
string [ 1 .. 128 ] characters
Default: "SUMMER2021"

Eindeutiger Code des Promocodes. 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

Promocode wurde erfolgreich eingelöst.

401

Authentifizierung nicht bestanden oder falsch.

403

Autorisierungs-Header nicht gesendet.

404

Geben Sie einen gültigen Promocode ein.

422

Ungültige Anfrage.

Request samples
application/json
{
  • "cart": {
    },
  • "coupon_code": "SUMMER2021",
  • "selected_unit_items": {
    }
}
Response samples
application/json
{
  • "cart_id": "cart_id",
  • "is_free": false,
  • "items": [],
  • "price": {
    },
  • "rewards": {
    }
}