Dynamische Aktualisierung der TestdauerPrivate Vorschau

Aktualisieren Sie die Dauer von Testversionen als Reaktion auf Änderungen, die während des Bezahlvorgangs vorgenommen wurden.

Private Vorschau

Diese Funktion befindet sich in der privaten Vorschau. Zugriff auf dynamische Testversionen 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).

SDK einrichten
Serverseitig

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

Server-SDK aktualisieren
Serverseitig

Um diese Beta-Version zu verwenden, aktualisieren Sie zunächst Ihr SDK, um die API-Version der privaten Vorschau und den Header checkout_server_update_beta=v1 für die Beta-Version zu verwenden.

Dynamische Aktualisierung der Testdauer
Serverseitig

Erstellen Sie einen neuen Endpoint auf Ihrem Server, um die Testdauer für einen jährlichen Upsell in der Checkout-Sitzung zu aktualisieren. Sie rufen dies in einem späteren Schritt vom Frontend aus auf.

Sicherheitshinweis

Clientseitiger Code wird in einer Umgebung ausgeführt, die vollständig vom Nutzer/von der Nutzerin kontrolliert wird. Böswillige Nutzer/innen können Ihre clientseitige Validierung umgehen, Anfragen abfangen und ändern oder sogar völlig neue Anfragen an Ihren Server erstellen.

Beim Entwerfen des Endpoints wird Folgendes empfohlen:

Entwerfen Sie Endpoints für spezifische Kundeninteraktionen, anstatt sie zu allgemein zu halten (z. B. „Testzeitraum für jährliches Upgrade verlängern“ statt einer allgemeinen „Update“-Aktion). Spezifische Endpoints helfen dabei, den Zweck klar zu halten und die Validierungslogik einfacher zu schreiben und zu pflegen.
Vermeiden Sie es, Sitzungsdaten direkt vom Client an Ihren Endpunkt zu übertragen. Böswillige Clients können Anforderungsdaten ändern, was sie zu einer unzuverlässigen Quelle für die Bestimmung des Checkout-Sitzungsstatus macht. Übergeben Sie stattdessen die Sitzungs-ID an Ihren Server und verwenden Sie sie, um die Daten sicher von der API Stripe abzurufen.

Sie können die Testdauer wie folgt aktualisieren:

trial_period_days: Eine ganze Zahl, 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 die Testphase enden soll, oder eine leere Zeichenfolge zum Entfernen der Testversion

Beachten Sie Folgendes:

Die Parameter trial_period_days und trial_end schließen sich gegenseitig aus. Sie können nur einen davon in einer einzigen Aktualisierungsanfrage angeben.
Wenn Sie eine Testversion entfernen, verwenden Sie dasselbe Feld, mit dem sie festgelegt wurde. Ein Test-Set mit dem Parameter trial_period_days kann nur mit trial_period_days: "" entfernt werden, und ein Test-Set mit trial_end kann nur mit trial_end: "" entfernt werden.

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'],
});

Serveraktualisierungen aufrufen
Clientseitig

Lösen Sie das Update von Ihrem Frontend aus, indem Sie eine Anfrage an Ihren Server stellen und diese in runServerUpdate einschließen. Wenn die Anfrage erfolgreich ist, wird das Session-Objekt mit der neuen Testdauer aktualisiert.

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: checkout.session().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.

Notiz

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.