Migrationsleitfaden für Checkout
In der Legacy-Version von Checkout wurde Kund/innen ein modales Dialogfeld angezeigt, das Karteninformationen erfasst und ein Token oder eine Quelle an Ihre Website zurückgegeben hat. Im Gegensatz dazu ist die neue Checkout-Version eine intelligente, von Stripe gehostete Zahlungsseite, die Zahlungen und Abonnements erstellen kann. Sie unterstützt neben vielen anderen Funktionen Apple Pay und dynamisches 3D Secure.
Die aktuelle Checkout-Version bietet mehr Flexibilität, Unterstützung für dynamische Einzelposten, Connect, die Wiederverwendung bestehender Kund/innen und erweiterte Abonnementfunktionen. Sie können auch die Client-only-Integration verwenden, die für den Einstieg und für einfachere Produktkataloge besser geeignet ist.
Um von der älteren Version auf die aktuelle umzustellen, folgen Sie dem Leitfaden, der Ihr Geschäftsmodell am ehesten repräsentiert. Jeder Leitfaden empfiehlt einen Integrationspfad mit einem Beispielcode.
Dynamischer Produktkatalog und Preise
Wenn Sie einen großen Produktkatalog haben oder Unterstützung für dynamisch generierte Einzelposten (wie Spenden oder Steuern) benötigen.
Wenn Sie ein SaaS-Anbieter sind, der Nutzer/innen abrechnet und Unterstützung bei erweiterten Funktionen benötigen.
Connect-Plattformen und -Marktplätze
Wenn Sie einen Marktplatz betreiben, auf dem Sie Dienstanbieter und Kund/innen miteinander vernetzen.
Zahlungsmethoden für spätere Verwendung speichern
Wenn Sie ein Unternehmen betreiben, das die Kund/innen erst abrechnet, wenn die Dienstleistung ausgeführt wurde.
Einfacher Produktkatalog mit festen Preisen
Wenn Sie einige Produkte mit vorab bestimmten Preisen verkaufen.
Wenn Sie ein SaaS-Anbieter mit monatlichem Abonnementplan sind.
Wenn Sie den entsprechenden Migrationsleitfaden befolgen, können Sie auch auf die Konversionstabelle verweisen, um eine Zuordnung bestimmter Parameter und Konfigurationsoptionen zwischen den beiden Versionen von Checkout zu erhalten.
Dynamischer Produktkatalog und Preise
Wenn Sie Produkte verkaufen, für die der Betrag oder die Einzelposten dynamisch festgelegt werden (z. B. bei einem großen Produktkatalog oder für Spenden), lesen Sie Annahme von Einmalzahlungen.
Möglicherweise haben Sie mit der älteren Checkout-Version einen Token oder eine Quelle auf dem Client erstellt und diese/n für spätere Nutzung an Ihren Server übergeben. Die aktuelle Version der Server-Integration von Checkout kehrt diesen Vorgang jedoch um. Sie müssen zunächst eine Session auf Ihrem Server erstellen, deren ID an Ihren Client übergeben und dann Ihren Kunden/Ihre Kundin an Checkout weiterleiten, der/die bei Erfolg wieder zu Ihrer Anwendung zurückgeleitet wird.
Vor
Mit der älteren Version von Checkout würden Sie den dynamischen Betrag und die Beschreibung anzeigen und Karteninformationen von Ihrem Kunden/Ihrer Kundin erfassen.
<form action="/purchase" method="POST"> <script src="https://checkout.stripe.com/checkout.js" class="stripe-button" data-key=
data-name="Custom t-shirt" data-description="Your custom designed t-shirt" data-amount="{{ORDER_AMOUNT}}" data-currency="usd"> </script> </form>"pk_test_TYooMQauvdEDq54NiTphI7jx"
Als Nächstes würden Sie den resultierenden Token oder die Quelle an Ihren Server senden und abrechnen.
Nach
Mit der aktuellen Checkout-Version erstellen Sie zuerst eine Checkout Session auf Ihrem Server.
Notiz
Wenn Sie eine unserer Client-Bibliotheken verwenden, sollten Sie ein Upgrade auf die neueste Bibliotheksversion durchführen, damit Sie die Checkout Sessions API nutzen können.
Als Nächstes übergeben Sie die Session-ID an Ihren Client und leiten den Kunden/die Kundin zu Checkout um, um die Zahlung abzuschließen.
const stripe = Stripe(
); const checkoutButton = document.getElementById('checkout-button'); checkoutButton.addEventListener('click', () => { stripe.redirectToCheckout({ // Make the id field from the Checkout Session creation API response // available to this file, so you can provide it as argument here // instead of the {{CHECKOUT_SESSION_ID}} placeholder. sessionId: '{{CHECKOUT_SESSION_ID}}' }) // If `redirectToCheckout` fails due to a browser or network // error, display the localized error message to your customer // using `error.message`. });'pk_test_TYooMQauvdEDq54NiTphI7jx'
Der Kunde/Die Kundin wird an die success_url
weitergeleitet, sobald die Zahlung erfolgt ist.
Wenn Sie nach der Zahlung gekaufte Ware abwickeln müssen, lesen Sie Kaufabwicklung in Checkout.
Dynamische Abonnements
Wenn Sie Abonnementdienste anbieten, die dynamisch festgelegt werden oder Support für andere erweiterte Funktionen benötigen, finden Sie weitere Informationen unter Einrichten eines Abonnements.
Möglicherweise haben Sie mit der älteren Checkout-Version einen Token oder eine Quelle auf dem Client erstellt und diese/n an Ihren Server übergeben, um einen Kunden/eine Kundin oder ein Abonnement zu erstellen. Die neue Version der Serverintegration von Checkout kehrt diesen Vorgang jedoch um. Sie müssen zunächst eine Sitzung auf Ihrem Server erstellen, deren ID an Ihren Client übergeben und dann Ihren Kunden/Ihre Kundin an Checkout weiterleiten, der/die bei Erfolg wieder zu Ihrer Anwendung zurückgeleitet wird.
Vor
Mit der älteren Version von Checkout würden Sie die Abonnementinformationen anzeigen und Karteninformationen von Ihrem Kunden/Ihrer Kundin erfassen.
<form action="/subscribe" method="POST"> <script src="https://checkout.stripe.com/checkout.js" class="stripe-button" data-key=
data-name="Gold Tier" data-description="Monthly subscription with 30 days trial" data-amount="2000" data-label="Subscribe"> </script> </form>"pk_test_TYooMQauvdEDq54NiTphI7jx"
Als Nächstes würden Sie den resultierenden Token oder die Quelle an Ihren Server senden, um einen Kunden/eine Kundin und ein Abonnement zu erstellen.
Nach
Mit der aktuellen Checkout-Version erstellen Sie zuerst eine Checkout Session auf Ihrem Server.
Notiz
Wenn Sie eine unserer Client-Bibliotheken verwenden, sollten Sie ein Upgrade auf die neueste Bibliotheksversion durchführen, damit Sie die Checkout Sessions API nutzen können.
Als Nächstes übergeben Sie die Session-ID an Ihren Client und leiten den Kunden/die Kundin zu Checkout um, um die Zahlung abzuschließen.
const stripe = Stripe(
); const checkoutButton = document.getElementById('checkout-button'); checkoutButton.addEventListener('click', () => { stripe.redirectToCheckout({ // Make the id field from the Checkout Session creation API response // available to this file, so you can provide it as argument here // instead of the {{CHECKOUT_SESSION_ID}} placeholder. sessionId: '{{CHECKOUT_SESSION_ID}}' }) // If `redirectToCheckout` fails due to a browser or network // error, display the localized error message to your customer // using `error.message`. });'pk_test_TYooMQauvdEDq54NiTphI7jx'
Der Kunde/Die Kundin wird an die success_url
weitergeleitet, sobald der Kunde/die Kundin und das Abonnement erstellt wurden.
Wenn Sie nach der Zahlung Dienstleistungen abwickeln müssen, lesen Sie Kaufabwicklung in Checkout.
Sie können mit Checkout auch Abonnementinformationen aktualisieren.
Connect-Plattformen und -Marktplätze
Wenn Sie eine Connect-Plattform oder einen Connect-Marktplatz betreiben und Zahlungen mit verbundenen Konten erstellen, sollten Sie die aktuelle Version der Server-Integration von Checkout verwenden. Befolgen Sie die Anweisungen im Connect-Leitfaden, um Ihre Integration entsprechend zu migrieren.
Das folgende Beispiel zeigt, wie Sie die Checkout Sessions API verwenden, um eine Direct Charge zu verarbeiten. Im Connect-Leitfaden finden Sie Details zum Erstellen von Destination Charges.
Vor
Mit der älteren Version von Checkout würden Sie Karteninformationen von Ihrem Kunden/Ihrer Kundin auf dem Client erfassen.
<form action="/purchase" method="POST"> <script src="https://checkout.stripe.com/checkout.js" class="stripe-button" data-key=
data-name="Food Marketplace" data-description="10 cucumbers from Roger's Farm" data-amount="2000"> </script> </form>"pk_test_TYooMQauvdEDq54NiTphI7jx"
Als Nächstes würden Sie den resultierenden Token oder die Quelle an Ihren Server senden und im Namen des verbundenen Kontos abrechnen.
Nach
Mit der aktuellen Checkout-Version erstellen Sie zuerst im Namen des verbundenen Kontos eine Checkout Session auf Ihrem Server.
Notiz
Wenn Sie eine unserer Client-Bibliotheken verwenden, sollten Sie ein Upgrade auf die neueste Bibliotheksversion durchführen, damit Sie die Checkout Sessions API nutzen können.
Als Nächstes übergeben Sie die Session-ID an Ihren Client und leiten den Kunden/die Kundin zu Checkout um, um die Zahlung abzuschließen. Vergessen Sie nicht, die ID des verbundenen Kontos anzugeben, wenn Sie Stripe.js initiieren.
// Initialize Stripe.js with the same connected account ID used when creating // the Checkout Session. const stripe = Stripe(
, { stripeAccount:'pk_test_TYooMQauvdEDq54NiTphI7jx'}); const checkoutButton = document.getElementById('checkout-button'); checkoutButton.addEventListener('click', () => { stripe.redirectToCheckout({ // Make the id field from the Checkout Session creation API response // available to this file, so you can provide it as argument here // instead of the {{CHECKOUT_SESSION_ID}} placeholder. sessionId: '{{CHECKOUT_SESSION_ID}}' }) // If `redirectToCheckout` fails due to a browser or network // error, display the localized error message to your customer // using `error.message`. });'{{CONNECTED_ACCOUNT_ID}}'
Der Kunde/Die Kundin wird an die success_url
weitergeleitet, sobald die Zahlung erfolgt ist.
Wenn Sie nach der Zahlung gekaufte Waren oder Dienstleistungen abwickeln müssen, lesen Sie Kaufabwicklung in Checkout.
Zahlungsmethoden für spätere Verwendung speichern
Wenn Sie Dienstleistungen anbieten, bei denen Kund/innen nicht sofort abgerechnet werden, lesen Sie den Abschnitt Einrichten zukünftiger Zahlungen.
Möglicherweise haben Sie mit der älteren Checkout-Version einen Token oder eine Quelle auf dem Client erstellt und diese/n für spätere Nutzung an Ihren Server übergeben. Die aktuelle Version der Server-Integration von Checkout kehrt diesen Vorgang jedoch um. Sie müssen zunächst eine Session auf Ihrem Server erstellen, deren ID an Ihren Client übergeben und dann Ihren Kunden/Ihre Kundin an Checkout weiterleiten, der/die bei Erfolg wieder zu Ihrer Anwendung zurückgeleitet wird.
Vor
Mit der älteren Version von Checkout würden Sie die Zahlungsinformationen anzeigen und Karteninformationen von Ihrem Kunden/Ihrer Kundin erfassen.
<form action="/subscribe" method="POST"> <script src="https://checkout.stripe.com/checkout.js" class="stripe-button" data-key=
data-name="Cleaning Service" data-description="Charged after your home is spotless" data-amount="2000"> </script> </form>"pk_test_TYooMQauvdEDq54NiTphI7jx"
Als Nächstes würden Sie den resultierenden Token oder die Quelle an Ihren Server senden, um schließlich eine Zahlung zu erstellen.
Nach
Mit der aktuellen Checkout-Version erstellen Sie zuerst mit dem Einrichtungsmodus eine Checkout-Sitzung auf Ihrem Server.
Notiz
Wenn Sie eine unserer Client-Bibliotheken verwenden, sollten Sie ein Upgrade auf die neueste Bibliotheksversion durchführen, damit Sie die Checkout Sessions API nutzen können.
Als Nächstes übergeben Sie die Session-ID an Ihren Client und leiten den Kunden/die Kundin zu Checkout weiter, um die Details der Zahlungsmethode zu erfassen.
const stripe = Stripe(
); const checkoutButton = document.getElementById('checkout-button'); checkoutButton.addEventListener('click', () => { stripe.redirectToCheckout({ // Make the id field from the Checkout Session creation API response // available to this file, so you can provide it as argument here // instead of the {{CHECKOUT_SESSION_ID}} placeholder. sessionId: '{{CHECKOUT_SESSION_ID}}' }) // If `redirectToCheckout` fails due to a browser or network // error, display the localized error message to your customer // using `error.message`. });'pk_test_TYooMQauvdEDq54NiTphI7jx'
Der/die Kund/in wird an die success_url
weitergeleitet, sobald der Vorgang abgeschlossen ist.
Von dort aus können Sie aus dem Checkout-Ablauf den Setup Intent abrufen und damit Ihre Transaktion vorbereiten.
Einfacher Produktkatalog mit festen Preisen
Wenn Sie Produkte mit festen Preisen (wie T-Shirts oder E-Books) verkaufen, lesen Sie den Leitfaden zu Einmalzahlungen, um zu erfahren, wie Sie einen Codeausschnitt generieren und zu Ihrer Website hinzufügen.
Möglicherweise haben Sie mit der älteren Checkout-Version einen Token oder eine Quelle auf dem Client erstellt und diese/n an Ihren Server übergeben, um eine Zahlung zu erstellen. Die neue Version von Checkout erstellt die Zahlung jedoch automatisch für Sie, ohne dass eine Server-Integration erforderlich wäre.
Code auf Client-Seite
Code auf Server-Seite
Die folgende Konversionstabelle enthält eine Zuweisung der Konfigurationsoptionen zwischen den beiden Versionen von Checkout. Eine vollständige Liste der Konfigurationsoptionen für die neue Version finden Sie in der Referenz redirectToCheckout
.
Einfache Abonnements
Wenn Sie einen einfachen Abonnementdienst (wie den monatlichen Zugriff auf eine Software) anbieten, lesen Sie den Leitfaden zu Abonnements, um zu erfahren, wie Sie einen Plan im Dashboard erstellen und einen Codeausschnitt generieren und zu Ihrer Website hinzufügen.
Möglicherweise haben Sie mit der älteren Checkout-Version einen Token oder eine Quelle auf dem Client erstellt und diese/n an Ihren Server übergeben, um einen Kunden/eine Kundin und ein Abonnement zu erstellen. Die neue Version von Checkout erstellt den Kunden/die Kundin und das Abonnement jedoch automatisch für Sie, ohne dass eine Serverintegration erforderlich wäre.
Code auf Client-Seite
Code auf Server-Seite
Die folgende Konversionstabelle enthält eine Zuweisung der Konfigurationsoptionen zwischen den beiden Versionen von Checkout. Eine vollständige Liste der Konfigurationsoptionen für die neue Version finden Sie in der Referenz redirectToCheckout
.
Parameter-Konversion
Die aktuelle Version von Checkout unterstützt die meisten Funktionen der älteren Version. Die beiden Versionen verwenden jedoch nicht dieselbe API. In der folgenden Tabelle sind Parameter und Konfigurationsoptionen zwischen der älteren und der neuen Version aufgeführt.
Eine vollständige Liste der von der neuen Checkout-Version akzeptierten Konfigurationsoptionen finden Sie in der Stripe.js-Referenz und in der API-Referenz für Checkout-Sitzungen.
Ältere Version | Aktuelle Version | Tipps für die Integration |
---|---|---|
allowRememberMe |
| Die Merkfunktion wird von der neuen Checkout-Version nicht unterstützt. Um bestehende Kund/innen wiederzuverwenden, sollten Sie beim Erstellen einer Checkout-Sitzung den Parameter customer angeben. |
amount |
| Der Gesamtbetrag ist die Summe der Einzelposten, die Sie an Checkout übergeben. |
billingAddress |
| Checkout erfasst die Rechnungsadresse automatisch, wenn dies zur Betrugsprävention oder für aufsichtsbehördliche Zwecke erforderlich ist. Setzen Sie diesen Parameter auf required , um immer die Rechnungsadresse zu erfassen. |
billingAddress |
| Checkout erfasst die Rechnungsadresse automatisch, wenn dies zur Betrugsprävention oder für aufsichtsbehördliche Zwecke erforderlich ist. Setzen Sie diesen Parameter auf required , um immer die Rechnungsadresse zu erfassen. |
closed |
| Wenn ein/e Kund/in Checkout schließen möchte, kann er/sie entweder die Registerkarte im Browser schließen oder zur cancelUrl navigieren. |
currency |
| |
description |
| Wenn Sie einen Preis angeben, zeigt Checkout eine automatisch berechnete Beschreibung der Häufigkeit Ihrer Zahlungen an. Wenn Sie Session.line_items angeben, zeigt Checkout für jeden Einzelposten den name an. |
email |
| Wenn Sie die Kunden-E-Mail-Adresse bereits kennen, geben Sie sie hier an, sodass sie nicht erneut eingegeben werden muss. |
image |
| Checkout verwendet bestimmte Bilder für das Branding Ihres Unternehmens und für die Produkte, die Sie verkaufen. Checkout zeigt standardmäßig Ihr Unternehmenslogo an und greift neben dem Namen Ihres Unternehmens auf das Symbol zurück. |
key |
| |
locale |
| Sie können beim Erstellen einer Checkout-Sitzung einen unterstützten Standort angeben. |
name |
| Wenn Sie einen Preis angeben, zeigt Checkout dem Kunden/der Kundin den Namen des Produkts an, zu dem der Preis gehört. Wenn Sie Session.line_items angeben, zeigt Checkout für jeden Einzelposten den name an. |
panelLabel |
| Checkout passt den Schaltflächentext automatisch an die Artikel an, die Sie verkaufen. Verwenden Sie für Einmalzahlungen submit_type, um den Schaltflächentext anzupassen. |
shippingAddress |
| Erfassen Sie Versandadressinformationen, indem Sie ein Array von allowed_countries übergeben, in die Sie liefern möchten. |
token oder source |
| In JavaScript gibt es nach abgeschlossener Zahlung keinen Rückruf mehr. Da Ihr/e Kund/in auf einer anderen Seite zahlt, richten Sie successUrl so ein, dass er/sie nach Abschluss der Zahlung umgeleitet wird. |
zipCode |
| Checkout erfasst die Postleitzahl automatisch, wenn dies zur Betrugsprävention oder für aufsichtsbehördliche Zwecke erforderlich ist. |