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 \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30

Im Frontend enthält recurring.trial die Details zum Testzeitraum der Sitzung.

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 \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return" \
  -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

Sie können die Erinnerungs-E-Mail auch selbst senden und Kunden/innen an das Kundenportal von Billing verweisen, um ihre Zahlungsdetails hinzuzufügen.

Konfigurieren Sie zunächst das Billing-Kundenportal, damit Ihre Kundinnen/Kunden ihre Abonnements verwalten können.

Erfassen Sie als Nächstes die Rechnungsinformationen von Ihren Kund/innen:

1. Überwachen Sie das Ereignis customer.subscription.trial_will_end.
2. Wenn das Abonnement keine Standardzahlungsmethode hat, rufen Sie die E-Mail des Kunden/der Kundin über das Kunden-API ab und senden ihm/ihr einen Link zu Ihrer Website. Es ist hilfreich, die Kunden-ID in die E-Mail einzubetten, zum Beispiel https://example.com?...&customer={{CUSTOMER_ID}}.
3. Wenn der Kunde/die Kundin Ihre Website betritt, erstellen Sie eine Kundenportalsitzung mit der Kunden-ID aus dem vorherigen Schritt.
4. Leiten Sie Kundinnen/Kunden zum Kundenportal weiter, wo sie ihre Zahlungsdetails aktualisieren können.

Ihre Kundinnen/Kunden können ihr unterbrochenes Abonnement auch im Kundenportal wiederaufnehmen, indem sie auf Abonnement starten klicken und dann eine Zahlungsmethode hinzufügen. Zeigen Sie kostenlose Testphasen an, um zu erfahren, wie Sie ein Abonnement so konfigurieren können, dass es pausiert oder gekündigt wird, wenn eine kostenlose Testversion ohne verknüpfte Zahlungsmethode endet.

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.