Kostenfreie Bestellungen

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

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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

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.

curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d percent_off=100 \
  -d duration=once

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

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

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 https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d coupon=
{{COUPON_ID}} \
  -d code=FREECODE

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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

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.

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.