# Bestellung mit einem kostenlosen Warenkorb anlegen

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

Endpoint: POST /v2/project/{project_id}/free/cart
Version: 2.0.0
Security: AuthForCart

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
    Example: 44056

## Request fields (application/json):

  - `currency` (string)
    Währung des Bestellpreises. Dreistelliger Währungscode pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Detaillierte Informationen zu [Von Xsolla unterstützte Währungen](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/).

  - `custom_parameters` (object)
    Projektspezifische Parameter.

  - `locale` (string)
    Antwortsprache.

  - `sandbox` (boolean)
    Legt eine Bestellung in der Testumgebung an. Die Option steht den Nutzern offen, die in der Liste der Firmennutzer aufgeführt sind.

  - `settings` (object)
    Einstellungen zum Konfigurieren des Bezahlvorgangs und des Zahlungsportals für einen Nutzer.

  - `settings.payment_method` (integer)
    Zahlungsmethoden-ID. Die ID steuert die Anzeige der Währung im Zahlungsportal, da einige Zahlungsmethoden möglicherweise nur bestimmte Währungen unterstützen.

  - `settings.redirect_policy` (object)

  - `settings.redirect_policy.delay` (integer)
    Verzögerung, nach der der Nutzer automatisch zur Rückgabe-URL weitergeleitet wird.

  - `settings.redirect_policy.redirect_button_caption` (string)
    Lokalisierte Beschriftungen der Weiterleiten-Schaltfläche.
    Example: "Text button"

  - `settings.redirect_policy.redirect_conditions` (string)
    Zahlungsstatus, der eine Benutzerweiterleitung zur Rückgabe-URL auslöst.
    Enum: "none", "successful", "successful_or_canceled", "any"

  - `settings.redirect_policy.status_for_manual_redirection` (string)
    Zahlungsstatus, der die Anzeige einer Schaltfläche auslöst, bei dessen Klick der Nutzer zur Rückgabe-URL weitergeleitet wird.
    Enum: "none", "vc", "successful", "successful_or_canceled", "any"

  - `settings.return_url` (string)
    Seite, auf die der Nutzer nach der Zahlung weitergeleitet wird. Die folgenden Parameter werden dem Link automatisch hinzugefügt: user_id, foreigninvoice, invoice_id, status.

  - `settings.ui` (object)
    Benutzeroberflächeneinstellungen.

  - `settings.ui.currency_format` (string)
    Damit ein Währungscode bestehend aus drei Buchstaben gemäß [ISO 4217](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/) im Zahlungsportal angezeigt wird, müssen Sie code als Wert festlegen. Standardmäßig wird das Währungssymbol anstelle des Währungscodes angezeigt.

  - `settings.ui.desktop` (object)
    Benutzeroberflächeneinstellungen für die Desktopversion.

  - `settings.ui.desktop.header` (object)
    Header-Einstellungen.

  - `settings.ui.desktop.header.close_button` (boolean)
    Ob in der Desktop-Version des Zahlungsportals eine Schließen-Schaltfläche angezeigt werden soll. Die Schaltfläche schließt das Zahlungsportal und leitet den Nutzer zu der im Parameter settings.return_url angegebenen URL weiter. Standardmäßig ist false voreingestellt.

  - `settings.ui.desktop.header.is_visible` (boolean)
    Ob der Header im Zahlungsportal angezeigt wird.

  - `settings.ui.desktop.header.type` (string)
    Wie der Header angezeigt wird. Möglich sind compact (Projektname und Benutzer-ID sind ausgeblendet) oder normal (Standard).
    Enum: "compact", "normal"

  - `settings.ui.desktop.header.visible_logo` (boolean)
    Wenn true wird das Logo im Header angezeigt. Um das Bild hochzuladen, öffnen Sie Ihr Projekt im [Kundenportal](https://publisher.xsolla.com/), und navigieren Sie zu Pay Station > Einstellungen.

  - `settings.ui.desktop.header.visible_name` (boolean)
    Ob der Projektname im Header angezeigt wird.

  - `settings.ui.desktop.header.visible_purchase` (boolean)
    Ob die Kaufbeschreibung (purchase.description.value) im Header angezeigt wird. true ist voreingestellt.

  - `settings.ui.header` (object)

  - `settings.ui.header.visible_virtual_currency_balance` (boolean)
    Ob dieses Element im Zahlungsportal ausgeblendet werden kann oder nicht.

  - `settings.ui.is_cart_open_by_default` (boolean)
    Wie die Artikelliste im Warenkorb beim Öffnen der mobilen Zahlungsportal-Version angezeigt wird. Wenn true festgelegt ist, wird die Liste ausgeklappt angezeigt. Wenn false (Standard) festgelegt ist oder der Parameter nicht übermittelt wird, wird die Liste zusammengeklappt angezeigt.

  - `settings.ui.is_independent_windows` (boolean)
    Ob Nutzer zum Bezahlen vom im Launcher eingebetteten Browser (WebView) zu ihrem Standardbrowser weitergeleitet werden sollen.

  - `settings.ui.is_payment_methods_list_mode` (boolean)
    Ob die Liste der im Land des Nutzers verfügbaren Zahlungsmethoden beim Öffnen des Zahlungsportals angezeigt wird. Ist false festgelegt (Standard), wird die im Parameter settings.payment_method übermittelte Zahlungsmethode oder die vom [PayRank-Algorithmus](https://developers.xsolla.com/de/solutions/payments/payment-ui-management/top-payment-methods-management/) ausgewählte Zahlungsmethode angezeigt.

  - `settings.ui.is_prevent_external_link_open` (boolean)
    Ob die Weiterleitung per Link zu einer externen Ressource deaktiviert ist oder nicht. Wenn Sie auf einen externen Link klicken, wird das Ereignis external-link-open über den postMessage-Mechanismus gesendet. Die Adresse für den Weiterleitungs-Link wird im Parameter url übermittelt.

  - `settings.ui.is_show_close_widget_warning` (boolean)
    Ob während der Transaktionsverarbeitung eine Warnmeldung angezeigt werden soll, wenn der Mauszeiger über das Schließen-Symbol (×) bewegt wird. Wird false oder kein Parameter übermittelt, wird die Warnmeldung nicht angezeigt.

  - `settings.ui.is_three_ds_independent_windows` (boolean)
    Ob die "3-D Secure"-Prüfung in einem neuen Browserfenster geöffnet wird. Legen Sie true fest, wenn Ihr Setup eine Content Security Policy (CSP) vorschreibt.

  - `settings.ui.layout` (string)
    Position der Hauptelemente des Zahlungsportals. Sie können das Zahlungsportal im Spiel öffnen und/oder die Spalte mit den Bestellinformationen und den Angaben zu den Zahlungsmethoden vertauschen. Ausführliche Informationen finden Sie in den [Anpassungsanweisungen](https://developers.xsolla.com/de/doc/pay-station/features/ui-theme-customization/#pay_station_ui_theme_customization_layout).
    Enum: "embed", "column_reverse", "embed_column_reverse"

  - `settings.ui.mobile` (object)

  - `settings.ui.mode` (string)
    Benutzeroberflächen-Modus im Zahlungsportal. Nur user_account ist möglich. Der Header enthält nur das Navigationsmenü, und der Nutzer kann kein Produkt auswählen oder eine Zahlung vornehmen. Dieser Modus ist nur für die Desktop-Version verfügbar.
    Enum: "user_account"

  - `settings.ui.theme` (string)
    Zahlungsportal-Theme. Möglich sind "63295a9a2e47fab76f7708e1" (helles Theme – voreingestellt) oder "63295aab2e47fab76f7708e3" (dunkles Theme). Sie können außerdem ein [individuelles Theme erstellen](https://developers.xsolla.com/de/doc/pay-station/features/ui-theme-customization/#pay_station_ui_theme_customization_in_token) und dessen ID im Parameter übermitteln.
    Enum: "63295a9a2e47fab76f7708e1", "63295aab2e47fab76f7708e3"

  - `settings.ui.user_account` (object)
    Benutzerkontodetails.

  - `settings.ui.user_account.info` (object)
    Seite Mein Konto.

  - `settings.ui.user_account.info.enable` (boolean, required)
    Ob das Untermenü angezeigt wird. false ist voreingestellt.

  - `settings.ui.user_account.info.order` (integer, required)
    Position des Untermenüs im Hauptmenü.

  - `settings.ui.user_account.payment_accounts` (object)
    Untermenü Meine Zahlungskonten.

  - `settings.ui.user_account.subscriptions` (object)
    Untermenü Abonnements verwalten.

## Response 200 fields (application/json):

  - `order_id` (integer)
    Bestell-ID.

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Example: 1401

  - `errorMessage` (string)
    Example: "[0401-1401]: Invalid cart"

  - `statusCode` (integer)
    Example: 422