Kostenfreie Bestellungen

Nehmen Sie Bestellungen für kostenlose Posten an oder gewähren Sie Rabatte in Höhe von 100 % für Einmalzahlungen.

Sie können kostenfreie Bestellungen für einmalige Zahlungen mit kostenfreien Posten oder Rabatte für 100 % Rabatt mit Gutscheinen und kundenseitigen Aktionscodes verarbeiten.

Notiz

Sie müssen die API-Version 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 mit einem unit_amount von 0 und übergeben Sie ihn an das Array line items der Checkout-Sitzung. Unter Produkte und Preise finden Sie weitere Informationen zur Erstellung von Preisen.

Sie können auch den Parameter 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.

Wenn die customer-Eigenschaft nicht festgelegt ist, erstellt die Checkout-Sitzung automatisch ein neues Kundenobjekt. Dies bedeutet, dass Gastkundinnen und -kunden 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, der Ihre Checkout-Sitzung kostenlos macht. Sie können zum Beispiel einen Gutschein für 100 % Rabatt erstellen.

Wenn Sie eine Sitzung mit einem angewendeten Rabatt erstellen, übergeben Sie die Gutschein-ID im Parameter coupon des Rabatte-Arrays.

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.

Mit dem Parameter 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.

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.

Abgeschlossene Bestellungen bearbeiten

Nach Abschluss der Checkout-Sitzung können Sie die finalisierten Posten und ihre Mengen anfordern. Wenn Ihr Kunde/Ihre Kundin einen Posten entfernt, wird dieser auch aus der Posten-Antwort entfernt. Im Leitfaden zur Bestellabwicklung erfahren Sie, wie Sie einen Ereignis-Handler erstellen können, um abgeschlossene Checkout-Sitzungen zu handhaben.

Häufiger Fehler

Um kostenlose Bestellungen auszuführen, sollten Sie das Ereignis checkout.session.completed und nicht das Ereignis PaymentIntent verarbeiten. Abgeschlossene Checkout-Sitzungen, die kostenlos sind, haben keinen zugehörigen PaymentIntent.

Sie können Ihre abgeschlossenen kostenfreien Bestellungen im Dashboard sehen. Die Registerkarte „Kostenfreie Bestellungen“ wird nur angezeigt, wenn Sie mindestens eine abgeschlossene kostenfreie Bestellung haben.

OptionalPayment 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 Ihres Dashboards aktivieren.

Vorsicht

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 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 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.