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

After the Checkout Session completes, you can make a request for the finalized line items and their quantities. If your customer removes a line item, it also removes it from the line items response. See the Fulfillment guide to learn how to create an event handler to handle completed Checkout Sessions.

You can see your completed no-cost orders in the Dashboard. The no-cost orders tab only appears if you have at least one completed no-cost order.