# Bestellung mit einem bestimmten kostenlosen Warenkorb anlegen Legt eine Bestellung mit allen Artikeln aus dem jeweiligen kostenlosen Warenkorb an. Der angelegten Bestellung wird der Bestellstatus done zugewiesen. Endpoint: POST /v2/project/{project_id}/free/cart/{cart_id} Version: 2.0.0 Security: AuthForCart ## Path parameters: - `project_id` (integer, required) Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/. Example: 44056 - `cart_id` (string, required) Warenkorb-ID. Example: "custom_id" ## 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/). - `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.ui` (object) Benutzeroberflächeneinstellungen. - `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.desktop` (object) Benutzeroberflächeneinstellungen für die Desktopversion. - `settings.ui.desktop.header` (object) Header-Einstellungen. - `settings.ui.desktop.header.is_visible` (boolean) Ob der Header im Zahlungsportal angezeigt wird. - `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.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.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.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.user_account` (object) Benutzerkontodetails. - `settings.ui.user_account.payment_accounts` (object) Untermenü Meine Zahlungskonten. - `settings.ui.user_account.payment_accounts.enable` (boolean, required) Ob das Untermenü angezeigt wird. false ist voreingestellt. - `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.subscriptions` (object) Untermenü Abonnements verwalten. - `settings.ui.user_account.subscriptions.enable` (boolean, required) Ob das Untermenü angezeigt wird. false ist voreingestellt. - `settings.ui.user_account.subscriptions.order` (integer, required) Position des Untermenüs im Hauptmenü. - `settings.ui.header` (object) - `settings.ui.header.visible_virtual_currency_balance` (boolean) Ob dieses Element im Zahlungsportal ausgeblendet werden kann oder nicht. - `settings.ui.mobile` (object) - `settings.ui.mobile.header` (object) - `settings.ui.mobile.header.close_button` (boolean) Ob in der mobilgeräteoptimierten 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. - `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_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_independent_windows` (boolean) Ob Nutzer zum Bezahlen vom im Launcher eingebetteten Browser (WebView) zu ihrem Standardbrowser weitergeleitet werden sollen. - `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.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.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.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.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.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.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.redirect_policy` (object) - `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.delay` (integer) Verzögerung, nach der der Nutzer automatisch zur Rückgabe-URL weitergeleitet wird. - `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", "successful", "successful_or_canceled", "any" - `settings.redirect_policy.redirect_button_caption` (string) Lokalisierte Beschriftungen der Weiterleiten-Schaltfläche. Example: "Text button" - `custom_parameters` (object) Projektspezifische Parameter. ## Response 200 fields (application/json): - `order_id` (integer) Bestell-ID. ## Response 422 fields (application/json): - `errorCode` (integer) Example: 1401 - `statusCode` (integer) Example: 422 - `errorMessage` (string) Example: "[0401-1401]: Invalid cart"