Kostenfreie Bestellungen
Mit Checkout können Sie kostenfreie Bestellungen für einmalige Zahlungen bearbeiten, indem Sie kostenlose Positionen oder Rabatte für 100 % Rabatt verwenden. Wenn der Gesamtbetrag 0 ist, belastet Checkout die Zahlungsmethode des Kunden/der Kundin nicht.
Notiz
Um kostenlose Bestellungen mit der Checkout API zu verarbeiten, müssen Sie unbedingt die aktuelle API-Version 2023-08-16 oder höher verwenden.
Beschränkungen
Kostenlose Bestellungen unterstützen derzeit keine Gastkundinnen/Gastkunden.
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.
Erstellen Sie einen Rabatt, damit Kunden/Kundinnen ihre Bestellungen kostenlos abschließen können.
Gutscheine
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-Codes
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.
Kunden/Kundinnen 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.
Zahlung und Preistabellen Optional
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 sie nicht mehr deaktivieren. Bevor Sie die Funktion für Ihre Live-Zahlungslinks und Preistabellen aktivieren, testen Sie sie mit Ihrem Ausführungsablauf im Test-Modus.
Um kostenlose Bestellungen mit einem Zahlungslink im Test-Modus zu verwenden, geben Sie einen prefilled_email
URL-Parameter mit einer E-Mail-Adresse an, deren lokaler Teil das Suffix +no_cost_orders
enthält. Zum 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 im Test-Modus 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 den Gesamtbetrag der Bestellung auf Null reduziert.
Handhabung abgeschlossener Bestellungen
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, 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.