Kostenlose Testversionen konfigurieren

Sie können eine Checkout-Sitzung so konfigurieren, dass das Abonnement eines Kunden/einer Kundin mit einer kostenlosen Testversion gestartet wird, indem Sie einen der folgenden Parameter übergeben:

• subscription_data.trial_period_days, die Dauer (in Tagen) Ihres kostenlosen Testzeitraums.
• subscription_data.trial_end, ein Unix-Zeitstempel, der das Ende des Testzeitraums darstellt.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30

Kostenlose Testversionen ohne Erfassung der Zahlungsmethode

Standardmäßig erfassen Checkout-Sitzungen eine Zahlungsmethode, die nach Ablauf des Testzeitraums verwendet werden soll. Sie können Kundinnen/Kunden für kostenlose Testversionen anmelden, ohne Zahlungsdetails zu erfassen, indem Sie payment_method_collection=if_required übergeben.

Wählen Sie, ob das Abonnement gekündigt oder unterbrochen werden soll, wenn der Kunde/die Kundin vor Ablauf des Testzeitraums keine Zahlungsmethode angibt, indem Sie trial_settings.end_behavior.missing_payment_method übergeben.

• Abonnement kündigen: Wenn das kostenlose Testabonnement ohne Zahlungsmethode endet, wird es sofort gekündigt. Sie können ein weiteres Abonnement erstellen, wenn der Kunde/die Kundin in Zukunft einen kostenpflichtigen Plan abonnieren möchte.
• Abonnementunterbrechen – Wenn das kostenlose Testabonnement ohne hinterlegte Zahlungsmethode endet, wird es unterbrochen und der Zyklus geht erst weiter, wenn es wieder aufgenommen wird. Wenn ein Abonnement unterbrochen wird, werden keine Rechnungen generiert (im Gegensatz dazu, wenn der Zahlungseinzug eines Abonnements unterbrochen wird). Wenn Ihr Kunde/Ihre Kundin seine/ihre Zahlungsmethode nach der Unterbrechung des Abonnements hinzufügt, können Sie dasselbe Abonnement wiederaufnehmen. Das Abonnement kann auf unbestimmte Zeit ausgesetzt bleiben.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30 \
  -d "subscription_data[trial_settings][end_behavior][missing_payment_method]"=cancel \
  -d payment_method_collection=if_required

Zahlungsdaten automatisch erfassen

Erfassen Sie Zahlungsdetails von Ihrem Kunden/Ihrer Kundin, bevor die Testversion abläuft.

Unter Benachrichtigungen für kostenlose Testversionen verwalten in Ihren E-Mail- und Abonnement-Einstellungen können Sie festlegen, dass automatisch eine Erinnerungs-E-Mail gesendet wird, kurz bevor die Testphase eines Kunden/einer Kundin abläuft.

Wählen Sie als Nächstes die Option Link zu einer von Stripe gehosteten Seite aus, damit die Kundinnen/Kunden ihre Zahlungsdetails hinzufügen oder aktualisieren können. In einer Sandbox versenden wir keine Erinnerungs-E-Mails für kostenlose Testversionen. Erfahren Sie mehr über die Einrichtung von Erinnerungen für kostenlose Testabonnements.

Wenn Sie Testversionen anbieten, müssen Sie die Anforderungen des Kartennetzwerks erfüllen. Erfahren Sie mehr über die Konformitätsanforderungen für Testphasen und Promoaktionen.

Zahlungsinformationen über das Kundenportal von Billing erfassen

You can also send the reminder email yourself, and redirect customers to the Billing customer portal to add their payment details.

First, configure the Billing customer portal to enable your customers to manage their subscriptions.

Next, collect billing information from your customers:

1. Listen to the customer.subscription.trial_will_end event.
2. If the subscription doesn’t have a default payment method, get the customer’s email using the Customers API and send them a message with a link to your site. It’s helpful to embed the customer ID in the email, for example https://example.com?...&customer={{CUSTOMER_ID}}.
3. When the customer lands on your site, create a customer portal session using the customer ID from the previous step.
4. Redirect the customer to the customer portal, where they can update their subscription with payment details.

Your customers can also resume their paused subscription in the customer portal by selecting Start subscription, then adding a payment method. View free trial periods to learn how to configure a subscription to pause or cancel when a free trial ends without a payment method attached.

Testversionen mit nutzungsbasierter Abrechnung kombinieren

Sie können Testphasen für Abonnements mit nutzungsbasierter Abrechnung nutzen. Während des Testzeitraums wird jegliche Nutzung nicht auf den Gesamtbetrag angerechnet, der dem Kunden/der Kundin am Ende des Abrechnungszyklus in Rechnung gestellt wird. Nach Ablauf des Testzeitraums wird die Nutzung summiert und am Ende des nächsten Abrechnungszyklus abgerechnet.

Testversionen und Gesamtnutzung

Wenn Sie den Parameter aggregate_usage verwenden und das Verhalten auf last_ever festlegen, wird Ihrem Kunden/Ihrer Kundin der letzte Nutzungsdatensatz in Rechnung gestellt, wenn dieser in den Testzeitraum fällt, auch wenn die Nutzung während des Testzeitraums stattgefunden hat.

Wenn Sie beispielsweise Speicherung von Daten anbieten, könnten Sie einen Monat lang kostenlosen Speicherplatz anbieten, dann aber den ersten Monat berechnen, wenn der Kunde/die Kundin weiterhin Dateien mit Ihrem Dienst speichert.