Xsolla-logo

Promocode-Aktion aktualisierenServer-sideAdmin

put/v2/project/{project_id}/admin/promocode/{external_id}

Aktualisiert eine Promocode-Aktion.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
external_id
required
integer

Promotion external ID. Unique promotion identifier within the project.

Example: coupon_44056_1
Request Body schema: application/json
required
object
Default: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

Name der Werbeaktion. Sollte Schlüssel-Wert-Paare enthalten, wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}-[A–Z]{2}$" und der Wert ein String ist.

property name*
additional property
string
Array of objects or null
Array
quantity
number
Default: 1

Artikelmenge.

sku
string
Default: "elven_shield"

Artikel-SKU.

date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion endet. Möglich ist null. Wenn für date_end der Wert null festgelegt ist, läuft die Werbeaktion zeitlich unbegrenzt.

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion beginnt.

object or null
percent
string or null
Default: "10.00"

Prozentualer Rabatt. Der Preis des Warenkorbs wird um einen Wert verringert, der anhand dieses Prozentsatzes berechnet und dann auf zwei Dezimalstellen gerundet wird.

Array of objects or null

Liste der Artikel, die durch einen Promocode rabattiert werden.

Array
sku
required
string
Default: "elven_shield"

Artikel-SKU.

required
object
percent
required
string
Default: "10.00"

Prozentualer Rabatt.

Der Preis des Artikels im Warenkorb wird um einen Wert verringert, der anhand dieses Prozentsatzes berechnet und dann auf zwei Dezimalstellen gerundet wird.

redeem_code_limit
integer or null
Default: 10

Anzahl der Einlösungen pro Code.

redeem_total_limit
integer or null
Default: 10

Begrenzt die Gesamtzahl der Gutscheine.

redeem_user_limit
integer or null
Default: 10

Begrenzt, wie oft ein einzelner Benutzer Gutscheine einlösen darf.

Responses
204

Promocode wurde erfolgreich aktualisiert.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

404

Promocode nicht gefunden. Stellen Sie sicher, dass die external_id korrekt ist.

422

Ungültige Anfrage.

Request samples
application/json
{
  • "bonus": [
    ],
  • "date_end": "2020-04-15T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "discounted_items": [
    ],
  • "name": {
    },
  • "redeem_code_limit": 10,
  • "redeem_total_limit": 10,
  • "redeem_user_limit": 10
}
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}