Eine Zahlung über Stripe Elements und die Charges API annehmenCharges API
Nehmen Sie Online-Zahlungen von Kund/innen in den USA und Kanada an.
Legacy API
The content of this section refers to a Legacy feature. Use the Payment Intents API instead.
Die Charges API unterstützt die folgenden Funktionen nicht, von denen viele für die Einhaltung von Kreditkartenvorschriften erforderlich sind:
Mit Stripe Elements, unseren vordefinierten Nutzeroberflächenkomponenten, können Sie ein Zahlungsformular erstellen, mit dem Sie die Kartendaten Ihrer Kundinnen/Kunden sicher erfassen können, ohne die sensiblen Daten verarbeiten zu müssen. Die Kartendaten werden hierbei in ein repräsentatives Token konvertiert, das Sie sicher an Ihre Server übermitteln können. Mit diesem Token können Sie anschließend auf Ihrem Server eine Zahlung erstellen.
Stripe einrichten
Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.
Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:
Zahlungsformular erstellenClientseitig
Um Kartendaten von Ihren Kund/innen sicher zu erfassen, erstellt Stripe Elements UI-Komponenten für Sie, die auf Stripe gehostet werden. Diese Komponenten werden dann in Ihrem Zahlungsformular platziert, wodurch Sie sie nicht selbst erstellen müssen.
Stripe Elements einrichten
Token erstellenClientseitig
createToken akzeptiert auch einen optionalen zweiten Parameter, der die von den Kundinnen/Kunden erfassten zusätzlichen Kartendaten enthält. Dieser wird in diesem Beispiel nicht verwendet. Die Funktion liefert ein Promise
, das mit einem result
-Objekt aufgelöst wird. Dieses Objekt hat eines der folgenden Ergebnisse:
result.
: Es wurde erfolgreich ein Token erstellt.token result.
: Es ist ein Fehler aufgetreten. Hierzu zählen auch clientseitige Validierungsfehler. Eine Liste aller möglichen Fehler finden Sie in der API-Dokumentation.error
Wenn das Objekt ein result.
beinhaltet, übermitteln Sie es an Ihren Server. Ansonsten lassen Sie den Kund/innen eine Fehlermeldung anzeigen.
Token an Ihren Server übermittelnClientseitig
Übermitteln Sie den Token zusammen mit weiteren erfassten Informationen an Ihren Server:
Zahlung mit dem Token erstellenServerseitig
Nachdem der Client den Token an Ihren Server übermittelt hat, können Sie damit eine Zahlung erstellen. Den Stripe-Token finden Sie auf Ihrem Server unter den von Ihrem Formular übermittelten POST-Parametern. Um die Karte zu belasten, genügt dann ein API-Aufruf:
Die Reaktion auf die Erstellung einer Zahlung ist entweder eine Zahlung oder ein Fehler mit einem Fehlercode. Ist die Reaktion erfolgreich, wickeln Sie die Bestellung des Kunden/der Kundin ab und lassen Sie eine Bestätigungsseite anzeigen. Wenn nicht, lassen Sie eine Fehlerseite anzeigen.
Integration testen
Wenn Sie zuverlässig eine Testkarte in Ihrem HTML-Formular eingeben, die Daten an den Server übermitteln und sehen können, dass Ihr Server die Zahlung erstellt hat, ist Ihre Integration abgeschlossen.
Herzlichen Glückwunsch! Sie haben eine einfache Zahlungsintegration mit der Charges API erstellt. Diese API unterstützt keine expandierenden Unternehmen oder Kundinnen/Kunden, die ihren Sitz nicht in den USA oder Kanada haben. Für umfangreichere und globale Zahlungen sollten Sie sich mit der Payment Intents API vertraut machen.
Siehe auch
Erfahren Sie mehr über Elements und darüber, wie Sie mit der Charges API Karten speichern.