# Kostenfreie Bestellungen Nehmen Sie Bestellungen für kostenlose Posten an oder gewähren Sie Rabatte in Höhe von 100 % für Einmalzahlungen. # Gehostete Seite > This is a Gehostete Seite for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/no-cost-orders?payment-ui=stripe-hosted. Sie können kostenfreie Bestellungen für einmalige Zahlungen mit [kostenfreien Posten](https://docs.stripe.com/payments/checkout/no-cost-orders.md#no-cost-line-items) oder Rabatte für 100 % Rabatt mit [Gutscheinen und kundenseitigen Aktionscodes](https://docs.stripe.com/payments/checkout/no-cost-orders.md#full-cost-discounts) verarbeiten. > Sie müssen die API-Version [2023-08-16](https://docs.stripe.com/upgrades.md#2023-08-16) oder höher verwenden, um kostenlose Bestellungen über die Checkout Sessions API bearbeiten zu können. ## Checkout-Sitzung mit kostenfreien Posten erstellen Erstellen Sie einen [Preis](https://docs.stripe.com/api/prices.md) mit einem [unit_amount](https://docs.stripe.com/api/prices/object.md#price_object-unit_amount) von 0 und übergeben Sie ihn an das Array [line items](https://docs.stripe.com/api/checkout/sessions/line_items.md) der Checkout-Sitzung. Unter [Produkte und Preise](https://docs.stripe.com/invoicing/products-prices.md) finden Sie weitere Informationen zur Erstellung von Preisen. Sie können auch den Parameter [price_data](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price_data) des Arrays `line_items` verwenden, um einen kostenlosen Preis zu übergeben. Wenn der Gesamtbetrag 0 ist, belastet Checkout die Zahlungsmethode vom Kunden/von der Kundin nicht. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][unit_amount]=0" \ -d "line_items[0][price_data][product_data][name]=Free t-shirt" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` Wenn die `customer`-Eigenschaft nicht festgelegt ist, erstellt die Checkout-Sitzung automatisch ein neues Kundenobjekt. Dies bedeutet, dass [Gastkundinnen und -kunden](https://docs.stripe.com/payments/checkout/guest-customers.md) nicht unterstützt werden. ## Rabatt erstellen Alternativ können Sie auch einen Gutschein und einen Aktionscode erstellen, damit Kundinnen/Kunden ihre Bestellungen kostenlos abschließen können. ### Gutschein erstellen Erstellen Sie einen [Gutschein](https://docs.stripe.com/api/coupons.md), der Ihre Checkout-Sitzung kostenlos macht. Sie können zum Beispiel einen Gutschein für 100 % Rabatt erstellen. ```curl curl https://api.stripe.com/v1/coupons \ -u "<>:" \ -d percent_off=100 \ -d duration=once ``` Wenn Sie eine Sitzung mit einem angewendeten Rabatt erstellen, übergeben Sie die [Gutschein-ID](https://docs.stripe.com/api/coupons/object.md#coupon_object-id) im Parameter `coupon` des [Rabatte](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts)-Arrays. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][unit_amount]=2000" \ -d "line_items[0][price_data][product_data][name]=T-shirt" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][quantity]=1" \ -d "discounts[0][coupon]={{COUPON_ID}}" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` Sie können auch eine kostenlose Checkout-Sitzung erstellen, indem Sie einen Gutschein über einen Betrag anwenden, der dem Gesamtbetrag der Checkout-Sitzung entspricht oder diesen übersteigt. ### Promo-Code erstellen Promo-Codes sind kundenseitige Codes, die zusätzlich zu Gutscheinen erstellt werden. Sie können diese Codes an Ihre Kunden/Kundinnen weitergeben, die sie an der Kasse eingeben können, um einen Rabatt zu erhalten. Wenn Sie einen Aktionscode auf der Grundlage eines 100 % Promo-Codes erstellen, können Kunden/Kundinnen Bestellungen kostenlos erstellen. ```curl curl https://api.stripe.com/v1/promotion_codes \ -u "<>:" \ -d "coupon={{COUPON_ID}}" \ -d code=FREECODE ``` Mit dem Parameter [allow_promotion_codes](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-allow_promotion_codes) können Sie nutzerseitig einlösbare Promo-Codes in einer Checkout Session erstellen. Dadurch wird in Checkout ein Feld freigegeben, in das Nutzer/innen Promo-Codes eingeben können. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][unit_amount]=2000" \ -d "line_items[0][price_data][product_data][name]=T-shirt" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d allow_promotion_codes=true \ --data-urlencode "success_url=https://example.com/success" ``` Kundinnen und Kunden können auch kostenlos prüfen, ob der von Ihnen angewendete Aktionscode dem Gesamtbetrag der Checkout-Sitzung entspricht oder diesen übersteigt. Weitere Möglichkeiten zur Anwendung von Rabatten finden Sie unter [Rabatte hinzufügen](https://docs.stripe.com/payments/checkout/discounts.md). ## Abgeschlossene Bestellungen bearbeiten Nach Abschluss der Checkout-Sitzung können Sie die finalisierten [Posten](https://docs.stripe.com/api/checkout/sessions/line_items.md) und ihre Mengen anfordern. Wenn Ihr Kunde/Ihre Kundin einen Posten entfernt, wird dieser auch aus der Posten-Antwort entfernt. Im [Leitfaden zur Bestellabwicklung](https://docs.stripe.com/checkout/fulfillment.md) erfahren Sie, wie Sie einen Ereignis-Handler erstellen können, um abgeschlossene Checkout-Sitzungen zu handhaben. > Um kostenlose Bestellungen auszuführen, sollten Sie das Ereignis `checkout.session.completed` und nicht das Ereignis [PaymentIntent](https://docs.stripe.com/payments/payment-intents.md) verarbeiten. Abgeschlossene Checkout-Sitzungen, die kostenlos sind, haben keinen zugehörigen [PaymentIntent](https://docs.stripe.com/payments/payment-intents.md). Sie können Ihre abgeschlossenen kostenfreien Bestellungen im [Dashboard](https://dashboard.stripe.com/no-cost-orders) sehen. Die Registerkarte „Kostenfreie Bestellungen“ wird nur angezeigt, wenn Sie mindestens eine abgeschlossene kostenfreie Bestellung haben. ## Optional: Payment Links und Preistabellen Zahlungslinks und Preistabellen unterstützen standardmäßig kostenfreie Bestellungen, wenn Ihr Konto nach dem 17. August 2023 erstellt wird. Für Konten, die vor diesem Datum erstellt wurden, können Sie kostenfreie Bestellungen für Ihre Zahlungslinks und Preistabellen in den [Checkout-Einstellungen](https://dashboard.stripe.com/settings/checkout) Ihres Dashboards aktivieren. > Wenn Sie diese Funktion aktivieren, können Sie sie innerhalb von drei Tagen deaktivieren. Nach 3 Tagen können Sie es nicht mehr deaktivieren. Bevor Sie die Funktion für Ihre Live-Zahlungslinks und Preistabellen aktivieren, testen Sie es mit Ihrem Ausführungsablauf in einer Sandbox. Um kostenlose Bestellungen mit einem Zahlungslink in einer Sandbox zu verwenden, geben Sie den [URL-Parameter](https://docs.stripe.com/payment-links/customize.md#customize-checkout-with-url-parameters) `prefilled_email` mit einer E-Mail-Adresse an, deren lokaler Teil das Suffix `+no_cost_orders` enthält. Beispiel: `j.appleseed+no_cost_orders@example.com`. In der daraus resultierenden Checkout-Sitzung können Sie einen Rabatt anwenden, der die Gesamtsumme der Bestellung auf Null reduziert. Um kostenlose Bestellungen mit einer Preistabelle in einer Sandbox zu verwenden, setzen Sie die [Eigenschaft](https://docs.stripe.com/payments/checkout/pricing-table.md#customer-email) `customer-email` der Preistabelle auf eine E-Mail-Adresse, deren lokaler Teil das Suffix `+no_cost_orders` enthält. Beispiel: `j.appleseed+no_cost_orders@example.com`. In der daraus resultierenden Checkout-Sitzung können Sie einen Rabatt anwenden, der die Gesamtsumme der Bestellung auf Null reduziert. # Eingebettete Seite > This is a Eingebettete Seite for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/no-cost-orders?payment-ui=embedded-form. Sie können kostenfreie Bestellungen für einmalige Zahlungen mit [kostenfreien Posten](https://docs.stripe.com/payments/checkout/no-cost-orders.md#no-cost-line-items) oder Rabatte für 100 % Rabatt mit [Gutscheinen und kundenseitigen Aktionscodes](https://docs.stripe.com/payments/checkout/no-cost-orders.md#full-cost-discounts) verarbeiten. > Sie müssen die API-Version [2023-08-16](https://docs.stripe.com/upgrades.md#2023-08-16) oder höher verwenden, um kostenlose Bestellungen über die Checkout Sessions API bearbeiten zu können. ## Checkout-Sitzung mit kostenfreien Posten erstellen Erstellen Sie einen [Preis](https://docs.stripe.com/api/prices.md) mit einem [unit_amount](https://docs.stripe.com/api/prices/object.md#price_object-unit_amount) von 0 und übergeben Sie ihn an das Array [line items](https://docs.stripe.com/api/checkout/sessions/line_items.md) der Checkout-Sitzung. Unter [Produkte und Preise](https://docs.stripe.com/invoicing/products-prices.md) finden Sie weitere Informationen zur Erstellung von Preisen. Sie können auch den Parameter [price_data](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price_data) des Arrays `line_items` verwenden, um einen kostenlosen Preis zu übergeben. Wenn der Gesamtbetrag 0 ist, belastet Checkout die Zahlungsmethode vom Kunden/von der Kundin nicht. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][unit_amount]=0" \ -d "line_items[0][price_data][product_data][name]=Free t-shirt" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` Wenn die `customer`-Eigenschaft nicht festgelegt ist, erstellt die Checkout-Sitzung automatisch ein neues Kundenobjekt. Dies bedeutet, dass [Gastkundinnen und -kunden](https://docs.stripe.com/payments/checkout/guest-customers.md) nicht unterstützt werden. ## Rabatt erstellen Alternativ können Sie auch einen Gutschein und einen Aktionscode erstellen, damit Kundinnen/Kunden ihre Bestellungen kostenlos abschließen können. ### Gutschein erstellen Erstellen Sie einen [Gutschein](https://docs.stripe.com/api/coupons.md), der Ihre Checkout-Sitzung kostenlos macht. Sie können zum Beispiel einen Gutschein für 100 % Rabatt erstellen. ```curl curl https://api.stripe.com/v1/coupons \ -u "<>:" \ -d percent_off=100 \ -d duration=once ``` Wenn Sie eine Sitzung mit einem angewendeten Rabatt erstellen, übergeben Sie die [Gutschein-ID](https://docs.stripe.com/api/coupons/object.md#coupon_object-id) im Parameter `coupon` des [Rabatte](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts)-Arrays. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][unit_amount]=2000" \ -d "line_items[0][price_data][product_data][name]=T-shirt" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][quantity]=1" \ -d "discounts[0][coupon]={{COUPON_ID}}" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` Sie können auch eine kostenlose Checkout-Sitzung erstellen, indem Sie einen Gutschein über einen Betrag anwenden, der dem Gesamtbetrag der Checkout-Sitzung entspricht oder diesen übersteigt. ### Promo-Code erstellen Promo-Codes sind kundenseitige Codes, die zusätzlich zu Gutscheinen erstellt werden. Sie können diese Codes an Ihre Kunden/Kundinnen weitergeben, die sie an der Kasse eingeben können, um einen Rabatt zu erhalten. Wenn Sie einen Aktionscode auf der Grundlage eines 100 % Promo-Codes erstellen, können Kunden/Kundinnen Bestellungen kostenlos erstellen. ```curl curl https://api.stripe.com/v1/promotion_codes \ -u "<>:" \ -d "coupon={{COUPON_ID}}" \ -d code=FREECODE ``` Mit dem Parameter [allow_promotion_codes](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-allow_promotion_codes) können Sie nutzerseitig einlösbare Promo-Codes in einer Checkout Session erstellen. Dadurch wird in Checkout ein Feld freigegeben, in das Nutzer/innen Promo-Codes eingeben können. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][unit_amount]=2000" \ -d "line_items[0][price_data][product_data][name]=T-shirt" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d allow_promotion_codes=true \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` Kundinnen und Kunden können auch kostenlos prüfen, ob der von Ihnen angewendete Aktionscode dem Gesamtbetrag der Checkout-Sitzung entspricht oder diesen übersteigt. Weitere Möglichkeiten zur Anwendung von Rabatten finden Sie unter [Rabatte hinzufügen](https://docs.stripe.com/payments/checkout/discounts.md). ## Abgeschlossene Bestellungen bearbeiten Nach Abschluss der Checkout-Sitzung können Sie die finalisierten [Posten](https://docs.stripe.com/api/checkout/sessions/line_items.md) und ihre Mengen anfordern. Wenn Ihr Kunde/Ihre Kundin einen Posten entfernt, wird dieser auch aus der Posten-Antwort entfernt. Im [Leitfaden zur Bestellabwicklung](https://docs.stripe.com/checkout/fulfillment.md) erfahren Sie, wie Sie einen Ereignis-Handler erstellen können, um abgeschlossene Checkout-Sitzungen zu handhaben. > Um kostenlose Bestellungen auszuführen, sollten Sie das Ereignis `checkout.session.completed` und nicht das Ereignis [PaymentIntent](https://docs.stripe.com/payments/payment-intents.md) verarbeiten. Abgeschlossene Checkout-Sitzungen, die kostenlos sind, haben keinen zugehörigen [PaymentIntent](https://docs.stripe.com/payments/payment-intents.md). Sie können Ihre abgeschlossenen kostenfreien Bestellungen im [Dashboard](https://dashboard.stripe.com/no-cost-orders) sehen. Die Registerkarte „Kostenfreie Bestellungen“ wird nur angezeigt, wenn Sie mindestens eine abgeschlossene kostenfreie Bestellung haben.