Xsolla-logo

Bestellung mit einem kostenlosen Warenkorb anlegen

post/v2/project/{project_id}/free/cart

Legt eine Bestellung mit allen Artikeln aus dem kostenlosen Warenkorb an. Der angelegten Bestellung wird der Bestellstatus done zugewiesen.

SecurityAuthForCart
Request
path Parameters
project_id
required
integer

Projekt-ID.

Example: 44056
Request Body schema: application/json
currency
string

Die Währung, in der die Preise angezeigt werden (standardmäßig: USD). Währungscode bestehend aus drei Buchstaben gemäß ISO 4217.

custom_parameters
object [ 1 .. 200 ] properties

Projektspezifische Parameter.

locale
string

Antwortsprache.

sandbox
boolean
Default: false

Legt eine Bestellung in der Testumgebung an. Die Option steht den Benutzern offen, die in der Liste der Firmennutzer aufgeführt sind.

object

Einstellungen zum Konfigurieren des Zahlungsvorgangs und des Zahlungsportals für einen Benutzer.

payment_method
integer >= 1

ID der Zahlungsmethode.

object
delay
integer

Verzögerung, nach der der Benutzer automatisch zur Rückgabe-URL weitergeleitet wird.

redirect_button_caption
string

Lokalisierte Beschriftungen der Weiterleiten-Schaltfläche.

redirect_conditions
string

Zahlungsstatus, der eine Benutzerweiterleitung zur Rückgabe-URL auslöst.

Enum: "none" "successful" "successful_or_canceled" "any"
status_for_manual_redirection
string

Zahlungsstatus, der die Anzeige einer Schaltfläche auslöst, bei dessen Klick der Benutzer zur Rückgabe-URL weitergeleitet wird.

Enum: "none" "vc" "successful" "successful_or_canceled" "any"
return_url
string <uri> <= 1000 characters

Seite, auf die der Benutzer nach der Zahlung weitergeleitet wird. Die folgenden Parameter werden dem Link automatisch hinzugefügt: user_id, foreigninvoice, invoice_id, status.

object

Benutzeroberflächeneinstellungen.

object

Benutzeroberflächeneinstellungen für die Desktopversion.

object

Header-Einstellungen.

close_button
boolean
Default: false

Ob eine Schließen-Schaltfläche in der Desktopversion der Bezahlstation angezeigt wird. Die Schaltfläche schließt die Bezahlstation und leitet den Benutzer an die im Parameter settings.return_url angegebene URL weiter. false ist voreingestellt.

is_visible
boolean

Ob der Header im Zahlungsportal angezeigt wird.

type
string
Default: "normal"

Wie der Header angezeigt wird. Möglich sind compact (Projektname und Benutzer-ID sind ausgeblendet) oder normal (Standard).

Enum: "compact" "normal"
visible_logo
boolean

Wenn true festgelegt ist, wird im Header Ihr Logo angezeigt (dafür müssen Sie das Bild zuerst Ihrem Account Manager übermitteln).

visible_name
boolean

Ob der Projektname im Header angezeigt wird.

visible_purchase
boolean
Default: true

Ob die Kaufbeschreibung (purchase.description.value) im Header angezeigt wird. true ist voreingestellt.

license_url
string

Link zur EULA.

object
object
is_visible
required
boolean

Ob der Footer in der mobilen Version des Zahlungsportals ausgeblendet ist.

object
close_button
required
boolean
Default: false

Ob eine Schließen-Schaltfläche in der mobilen Version der Bezahlstation angezeigt wird. Die Schaltfläche schließt die Bezahlstation und leitet den Benutzer an die im Parameter settings.return_url angegebene URL weiter. false ist voreingestellt.

mode
any

Ein Benutzer kann nur mit seinen gespeicherten Zahlungsmethoden bezahlen. Möglich istsaved_accounts.

Value: "saved_accounts"
mode
string

Benutzeroberflächenmodus in der Bezahlstation. Nur user_account ist möglich: Der Header enthält nur das Kontonavigationsmenü, der Benutzer kann weder Produkte auswählen noch bezahlen. Dieser Modus ist nur in der Desktopversion verfügbar.

Enum: "user_account" "without_purchase"
size
string

Größe des Zahlungsportals. Möglich sind:

  • small: die kleinstmögliche Größe des Zahlungsportals. Verwenden Sie diesen Wert, wenn die Fenstergröße streng begrenzt ist (Abmessungen: 620 x 630)
  • medium: empfohlene Größe. Verwenden Sie diesen Wert, um das Zahlungsportal in einer Lightbox anzuzeigen (Abmessungen: 740 x 760)
  • large: die optimale Größe für die Anzeige des Zahlungsportals in einem neuen Fenster oder Tab (Abmessungen: 820 x 840)
Enum: "large" "medium" "small"
theme
string [ 1 .. 20 ] characters
Default: "default"

Zahlungsportal-Theme. Möglich sind default, default_dark oder dark.

Enum: "default" "default_dark" "dark"
object

Benutzerkontodetails.

object

Untermenü "Historie".

enable
required
boolean
Default: false

Ob das Untermenü angezeigt wird. false ist voreingestellt.

order
required
integer >= 1

Position des Untermenüs im Hauptmenü.

object
Default: "Page **My account**."
enable
required
boolean
Default: false

Ob das Untermenü angezeigt wird. false ist voreingestellt.

order
required
integer >= 1

Position des Untermenüs im Hauptmenü.

object

Untermenü Meine Zahlungskonten.

enable
required
boolean
Default: false

Ob das Untermenü angezeigt wird. false ist voreingestellt.

order
required
integer >= 1

Position des Untermenüs im Hauptmenü.

object

Untermenü Abonnements verwalten.

enable
required
boolean
Default: false

Ob das Untermenü angezeigt wird. false ist voreingestellt.

order
required
integer >= 1

Position des Untermenüs im Hauptmenü.

version
string
Default: "desktop"

Gerätetyp. Möglich sind desktop (voreingestellt) oder mobile.

Enum: "desktop" "mobile"
object

Versanddaten des Benutzers.

country
required
string^[A-Z]{2}$
address1
required
string
address2
required
string
address3
required
string
state
required
string
first_name
required
string
last_name
required
string
city
required
string
postal_code
required
string
region
required
string
phone
required
string^\+
comment
string
email
string
object

Ausgewählte Versandmethode. Das Format hängt vom integrierten Kurierdienstleister ab.

property name*
additional property
any
Responses
200

Kostenlose Bestellung wurde erfolgreich angelegt.

422

Ungültiger Warenkorb. Prüfen Sie, ob der Warenkorb existiert, gefüllt ist und alle Artikel darin kostenpflichtig sind.

Request samples
application/json
{
  • "custom_parameters": {
    },
  • "sandbox": true,
  • "settings": {
    }
}
Response samples
application/json
{
  • "order_id": 641
}