Testzeiträume dynamisch aktualisieren

Erfahren Sie, wie Sie Testzeiträume für Abos während des Bezahlvorgangs ändern können.

Private Vorschau

Dynamische Aktualisierungen von Testzeiträumen befinden sich in der privaten Vorschau. Zugriff auf dynamische Aktualisierungen von Testzeiträumen anfordern.

Erfahren Sie, wie Sie die Testdauer für Abonnement-Checkout-Sitzungen dynamisch aktualisieren.

Anwendungsszenarien

Dynamische Verwaltung von Testversionen: Fügen Sie Testversionen basierend auf Aktionsbedingungen oder Kundenaktionen hinzu oder entfernen Sie sie.
Testversionen für Upsells verlängern: Bieten Sie längere Testzeiträume an, wenn Kundinnen und Kunden Upgrades auf höherwertige Pläne durchführen (z. B. 7 Tage für monatliche Zahlungen werden auf 14 Tage für jährliche Zahlungen verlängert).

Payment Intents API

Wenn Sie die Payment Intents API verwenden, können Sie die Testeinstellungen mit der Subscriptions API anpassen.

SDK einrichten
Serverseitig

Verwenden Sie unsere offiziellen Bibliotheken, um von Ihrer Anwendung aus auf die Stripe API zuzugreifen:

Server-SDK aktualisieren
Serverseitig

Wenn Sie diese Beta verwenden möchten, aktualisieren Sie zunächst Ihr SDK, um die private API-Vorschauversion und den Beta-Header checkout_server_update_beta=v1 zu verwenden.

Testzeiträume dynamisch aktualisieren
Serverseitig

Erstellen Sie einen Endpoint auf Ihrem Server, um den Testzeitraum für ein jährliches Upselling in der Checkout-Sitzung zu aktualisieren. Sie rufen diesen in einem späteren Schritt über das Frontend auf.

Sicherheitshinweis

Client-seitiger Code wird in einer Umgebung ausgeführt, die von dem/der Nutzer/in kontrolliert wird. Böswillige Nutzer/innen können Ihre clientseitige Validierung umgehen, Anfragen abfangen und ändern oder neue Anfragen an Ihren Server erstellen.

Beim Erstellen eines Endpoints empfehlen wir Folgendes:

Erstellen Sie Endpoints für bestimmte Kundeninteraktionen, anstatt sie allgemein zu gestalten. Beispiel: „Testzeitraum für jährliches Upgrade verlängern“ statt einer allgemeinen „Aktualisieren“-Aktion. Spezifische Endpoints können beim Schreiben und Pflegen der Validierungslogik helfen.
Übergeben Sie Sitzungsdaten nicht direkt vom Client an Ihren Endpoint. Bösartige Clients können Anfragedaten ändern, was sie zu einer unzuverlässigen Quelle für die Bestimmung des Status der Checkout-Sitzung macht. Übergeben Sie stattdessen die Sitzungs-ID an Ihren Server und verwenden Sie diese, um die Daten sicher von der Stripe API abzurufen.

Sie können die Testzeiträume wie folgt aktualisieren:

trial_period_days: Eine Ganzzahl, die die Anzahl der Tage für den Testzeitraum darstellt, oder eine leere Zeichenfolge, um den Testzeitraum zu entfernen.
trial_end: Ein Unix-Zeitstempel, der angibt, wann der Testzeitraum enden soll, oder eine leere Zeichenfolge, um den Testzeitraum zu entfernen.

Beachten Sie Folgendes:

Die Parameter trial_period_days und trial_end schließen sich gegenseitig aus. Sie können nur einen von ihnen in einer einzigen Anfrage angeben.
Verwenden Sie beim Entfernen einer Testversion dasselbe Feld, mit dem sie festgelegt wurde. Sie können nur trial_period_days: "" verwenden, um eine Testversion mit trial_period_days zu entfernen. Sie können nur trial_end: "" verwenden, um eine Testversion mit trial_end zu entfernen.

Client-SDK aktualisieren
Clientseitig

Initialisieren Sie Stripe.js mit dem Beta-Header custom_checkout_server_updates_1.

checkout.js
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'
, {
  betas: ['custom_checkout_server_updates_1'],
});

Server-Aktualisierungen anfordern
Clientseitig

Senden Sie von Ihrem Frontend aus eine Aktualisierungsanfrage an Ihren Server und schließen Sie sie in runServerUpdate ein. Eine erfolgreiche Anfrage aktualisiert das Sitzungsobjekt mit dem neuen Testzeitraum.

index.html
<button id="extend-trial-yearly">
  Upgrade to a yearly subscription and get an extended trial
</button>

checkout.js
document.getElementById('extend-trial-yearly')
  .addEventListener("click", async (event) => {
    const updateCheckout = () => {
      return fetch("/extend-trial-for-yearly", {
        method: "POST",
        headers: {
          "Content-type": "application/json",
        },
        body: JSON.stringify({
          checkout_session_id: actions.getSession().id,
        })
      });
    };

    const response = await checkout.runServerUpdate(updateCheckout);
    if (!response.ok) {
      // Handle error state
      return;
    }

    // Update UI to reflect the extended trial
    event.target.textContent = "Trial extended to 14 days!";
    event.target.disabled = true;
  });

Integration testen

Testen Sie Ihre Integration, um sicherzustellen, dass Aktualisierungen der Testdauer korrekt funktionieren:

Erstellen Sie eine Checkout-Sitzung für ein Abonnement mit einem anfänglichen Testzeitraum.
Lösen Sie Ihren Server-Endpoint aus, indem Sie mit dem von Ihnen erstellten Nutzeroberflächenelement interagieren.
Überprüfen Sie, ob die Testdauer in der Checkout-Sitzung korrekt aktualisiert wurde.
Schließen Sie den Bezahlvorgang ab, um sicherzustellen, dass das Abonnement mit den korrekten Testeinstellungen erstellt wird.

Hinweis

Verwenden Sie zum Testen den Testmodus von Stripe, um die Erstellung von Live-Abonnements zu vermeiden. Sie können die Änderungen an der Testdauer überprüfen, indem Sie das Checkout Session-Objekt oder das erstellte Abonnement überprüfen.

Häufige Testszenarien

Verlängerung des Testzeitraums: Beginnen Sie mit einer 7-tägigen kostenlosen Testversion, verlängern Sie sie auf 14 Tage und überprüfen Sie, ob die Änderung in der Nutzeroberfläche und im Sitzungsobjekt angezeigt wird.
Bestehende Testversion entfernen: Beginnen Sie mit einer 7-tägigen kostenlosen Testversion, entfernen Sie diese und überprüfen Sie, ob die Änderung in der Nutzeroberfläche und im Sitzungsobjekt angezeigt wird. Entfernen Sie die Testversion mit demselben Feld, mit dem sie festgelegt wurde.
Fehlerbehebung: Testen Sie ungültige Anfragen, um sicherzustellen, dass Ihre Fehlerbehandlung korrekt funktioniert.