Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Informationen zu Stripe Payments
Aktualisieren Sie Ihre Integration
Zahlungsanalysefunktionen
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Payment Links verwenden
Bezahlseite erstellen
Erweiterte Integration erstellen
In-App-Integration erstellen
    Übersicht
    Zahlungsformular
    Embedded Payment Element
      In-App-Zahlungen annehmen
      Erscheinungsbild anpassen
      Nutzerdefinierte Zahlungsmethoden hinzufügen
      Kartenmarken filtern
    Ausgehender Link für In-App-Käufe
    Adressen erfassen
    Karten in den USA und Kanada
Zahlungsmethoden
Zahlungsmethoden hinzufügen
Zahlungsmethoden verwalten
Schnellerer Bezahlvorgang mit Link
Zahlungsschnittstellen
Payment Links
Checkout
Web Elements
In-App-Elements
Zahlungsszenarien
Umgang mit mehreren Währungen
Nutzerdefinierte Zahlungsabläufe
Flexibles Acquiring
Orchestrierung
Präsenzzahlungen
Terminal
Mehr als Zahlungen
Unternehmensgründung
Krypto
Financial Connections
Climate
StartseiteZahlungenBuild an in-app integrationEmbedded Payment Element

In-App-Zahlungen annehmen

Erstellen Sie mit dem Embedded Payment Element eine benutzerdefinierte Zahlungsintegration in Ihrer iOS-, Android- oder React Native-App.

Das Embedded Payment Element ist eine anpassbare Komponente, die eine Liste von Zahlungsmethoden rendert, die Sie zu jedem Bildschirm in Ihrer App hinzufügen können. Wenn Kundinnen/Kunden mit Zahlungsmethoden in der Liste interagieren, öffnet die Komponente einzelne untere Blätter, um Zahlungsdetails zu erfassen.

Mit einem PaymentIntent-Ablauf können Sie eine Abbuchung in Ihrer App erstellen. Bei dieser Integration rendern Sie das Embedded Payment Element, erstellen einen PaymentIntent und bestätigen eine Zahlung in Ihrer App.

Stripe einrichten
Serverseitig
Clientseitig

Serverseitig

Diese Integration erfordert Endpoints auf Ihrem Server, die mit der Stripe-API kommunizieren können. Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrem Server aus:

Command Line
Ruby
# Available as a gem sudo gem install stripe
Gemfile
Ruby
# If you use bundler, you can add this line to your Gemfile gem 'stripe'

Client-seitig

Das Stripe iOS SDK ist Open Source, vollständig dokumentiert und kompatibel mit Apps, die iOS 13 oder höher unterstützen.

Führen Sie zur Installation des SDK die folgenden Schritte aus:

  1. Wählen Sie in Xcode Datei > Add Package Dependencies (Paketabhängigkeiten hinzufügen) aus und geben Sie als Repository-URL https://github.com/stripe/stripe-ios-spm ein.
  2. Wählen auf unserer Veröffentlichungsseite die neueste Version aus.
  3. Fügen Sie das Produkt StripePaymentSheet zum Ziel Ihrer App hinzu.

Notiz

Details zur aktuellen SDK-Version und zu vorherigen Versionen finden Sie auf der Seite Releases auf GitHub. Um bei Veröffentlichung einer neuen Version eine Benachrichtigung zu erhalten, achten Sie auf die Releases zum jeweiligen Repository.

Sie müssen auch Ihren veröffentlichbaren Schlüssel festlegen, damit das SDK API Aufrufe an Stripe tätigen kann. Zunächst können Sie den veröffentlichbaren Schlüssel während der Integration auf dem Client codieren, aber den veröffentlichbaren Schlüssel von Ihrem Server in der Produktion abrufen.

// Set your publishable key: remember to change this to your live publishable key in production // See your keys here: https://dashboard.stripe.com/apikeys STPAPIClient.shared.publishableKey =
"pk_test_TYooMQauvdEDq54NiTphI7jx"

Zahlungsmethoden aktivieren

Zeigen Sie Ihre Einstellungen für Zahlungsmethoden an und aktivieren Sie die Zahlungsmethoden, die Sie unterstützen möchten. Sie müssen mindestens eine Zahlungsmethode aktiviert haben, um einen PaymentIntent zu erstellen.

Standardmäßig aktiviert Stripe Karten und andere gängige Zahlungsmethoden, mit denen Sie mehr Kundinnen und Kunden erreichen können. Wir empfehlen jedoch, zusätzliche Zahlungsmethoden zu aktivieren, die für Ihr Unternehmen und Ihre Kundschaft relevant sind. Weitere Informationen zur Unterstützung von Produkten und Zahlungsmethoden finden Sie auf der Seite Unterstützte Zahlungsmethoden und der Preisseite für Gebühren.

Zahlungsdaten erfassen
Clientseitig

Das eingebettete Mobile Payment Element ist so konzipiert, dass es auf der Bezahlseite Ihrer nativen mobilen App platziert wird. Das Element zeigt eine Liste mit Zahlungsmethoden an, die Sie an das Erscheinungsbild Ihrer App anpassen können.

Wenn Kundinnen/Kunden auf die Zeile Karte tippen, wird ein Formular geöffnet, in dem sie ihre Zahlungsdetails eingeben können. Die Schaltfläche im Formular zeigt standardmäßig Fortfahren an und schließt das Formular, wenn darauf getippt wird, sodass Ihre Kundinnen/Kunden die Zahlung in Ihrem Bezahlvorgang abschließen können.

Eingebettetes Payment Element

Sie können die Schaltfläche auch so konfigurieren, dass die Zahlung sofort abgeschlossen wird, anstatt fortzufahren. Führen Sie dazu diesen Schritt aus, nachdem Sie der Anleitung gefolgt sind.

Eingebettetes Payment Element initialisieren

Rufen Sie create auf, um EmbeddedPaymentElement mit einer EmbeddedPaymentElement.Configuration und einer PaymentSheet.IntentConfiguration zu instanziieren.

Das Configuration-Objekt enthält allgemeine Konfigurationsoptionen für EmbeddedPaymentElement, die sich zwischen Zahlungen nicht ändern, wie z. B. returnURL. Das IntentConfiguration-Objekt enthält Details zu der jeweiligen Zahlung wie den Betrag und die Währung sowie einen confirmHandler-Rückruf. Lassen Sie die Implementierung vorerst leer. Legen Sie nach erfolgreicher Initialisierung die Eigenschaften presentingViewController und delegate fest.

import StripePaymentSheet class MyCheckoutVC: UIViewController { func createEmbeddedPaymentElement() async throws -> EmbeddedPaymentElement { let intentConfig = PaymentSheet.IntentConfiguration( mode: .payment(amount: 1099, currency: "USD") ) { [weak self] _, _, intentCreationCallback in self?.handleConfirm(intentCreationCallback) } var configuration = EmbeddedPaymentElement.Configuration() configuration.returnURL = "your-app://stripe-redirect" // Use the return url you set up in the previous step let embeddedPaymentElement = try await EmbeddedPaymentElement.create(intentConfiguration: intentConfig, configuration: configuration) embeddedPaymentElement.presentingViewController = self embeddedPaymentElement.delegate = self return embeddedPaymentElement } func handleConfirm(_ intentCreationCallback: @escaping (Result<String, Error>) -> Void) { // ...explained later } }

Ansicht „Eingebettetes Payment Element“ hinzufügen

Nachdem EmbeddedPaymentElement erfolgreich initialisiert wurde, stellen Sie seine Ansicht in die Nutzeroberfläche Ihres Bezahlvorgangs ein.

Notiz

Die Ansicht muss in einer UIScrollView oder einer anderen scrollbaren Ansicht enthalten sein. Dies liegt daran, dass sie keine feste Größe hat und sich ihre Höhe nach dem ersten Rendern ändern kann.

class MyCheckoutVC: UIViewController { // ... private(set) var embeddedPaymentElement: EmbeddedPaymentElement? private lazy var checkoutButton: UIButton = { let checkoutButton = UIButton(type: .system) checkoutButton.backgroundColor = .systemBlue checkoutButton.layer.cornerRadius = 5.0 checkoutButton.clipsToBounds = true checkoutButton.setTitle("Checkout", for: .normal) checkoutButton.setTitleColor(.white, for: .normal) checkoutButton.translatesAutoresizingMaskIntoConstraints = false checkoutButton.isEnabled = embeddedPaymentElement?.paymentOption != nil checkoutButton.addTarget(self, action: #selector(didTapConfirmButton), for: .touchUpInside) return checkoutButton }() // ... @objc func didTapConfirmButton() { // ...explained later } override func viewDidLoad() { super.viewDidLoad() Task { @MainActor in do { // Create a UIScrollView let scrollView = UIScrollView() scrollView.translatesAutoresizingMaskIntoConstraints = false self.view.addSubview(scrollView) // Create the Mobile Embedded Payment Element let embeddedPaymentElement = try await createEmbeddedPaymentElement() embeddedPaymentElement.delegate = self embeddedPaymentElement.presentingViewController = self self.embeddedPaymentElement = embeddedPaymentElement // Add its view to the scroll view scrollView.addSubview(embeddedPaymentElement.view) // Add your own checkout button to the scroll view scrollView.addSubview(checkoutButton) // Set up layout constraints embeddedPaymentElement.view.translatesAutoresizingMaskIntoConstraints = false NSLayoutConstraint.activate([ scrollView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor), scrollView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor), scrollView.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor), scrollView.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor), embeddedPaymentElement.view.topAnchor.constraint(equalTo: scrollView.topAnchor), embeddedPaymentElement.view.leadingAnchor.constraint(equalTo: scrollView.leadingAnchor), embeddedPaymentElement.view.trailingAnchor.constraint(equalTo: scrollView.trailingAnchor), checkoutButton.topAnchor.constraint(equalTo: embeddedPaymentElement.view.bottomAnchor, constant: 4.0), checkoutButton.leadingAnchor.constraint(equalTo: scrollView.safeAreaLayoutGuide.leadingAnchor, constant: 4.0), checkoutButton.trailingAnchor.constraint(equalTo: scrollView.safeAreaLayoutGuide.trailingAnchor, constant: -4.0), ]) } catch { // handle view not being added to view } } } }

An dieser Stelle können Sie Ihre App ausführen und das eingebettete Mobile Payment Element sehen.

Umgang mit Änderungen bei der Höhe

Die Ansicht des EmbeddedPaymentElement kann vergrößert oder verkleinert werden, was sich auf das Layout der Ansicht auswirken kann.

Verarbeiten Sie Höhenänderungen, indem Sie die Delegatmethode embeddedPaymentElementDidUpdateHeight implementieren. Die Ansicht von EmbeddedPaymentElement ruft diese Methode in einem Animationsblock auf, der seine Höhe aktualisiert. Es wird erwartet, dass Ihre Implementierung setNeedsLayout() und layoutIfNeeded() in der Bildlaufansicht aufruft, die die Ansicht des EmbeddedPaymentElement enthält, um eine reibungslose Animation der Höhenänderung zu ermöglichen.

extension MyCheckoutVC: EmbeddedPaymentElementDelegate { func embeddedPaymentElementDidUpdateHeight(embeddedPaymentElement: StripePaymentSheet.EmbeddedPaymentElement) { // Handle layout appropriately self.view.setNeedsLayout() self.view.layoutIfNeeded() } }

Wir empfehlen Ihnen, zu testen, ob Ihre Ansicht richtig auf Änderungen der Höhe reagiert. Rufen Sie dazu testHeightChange() für EmbeddedPaymentElement auf, um das Ein- und Ausblenden eines Mandats innerhalb des Elements zu simulieren. Stellen Sie sicher, dass sich Ihre Bildlaufansicht nach dem Aufruf von testHeightChange() problemlos anpasst.

class MyCheckoutVC: UIViewController { override func viewDidLoad() { // This is only for testing purposes: #if DEBUG Timer.scheduledTimer(withTimeInterval: 5.0, repeats: true) { [weak self] _ in Task { @MainActor in self?.embeddedPaymentElement?.testHeightChange() } } #endif } }

Optional Ausgewählte Zahlungsoption anzeigen

Wenn Sie auf Details zur vom Kunden ausgewählten Zahlungsoption zugreifen müssen, wie ein Label (z. B. „····4242“), ein Bild (z. B. ein VISA-Logo) oder Abrechnungsdetails, die in Ihrer Nutzeroberfläche angezeigt werden sollen, verwenden Sie die Eigenschaft paymentOption von EmbeddedPaymentElement.

Um benachrichtigt zu werden, wenn sich die paymentOption ändert, implementieren Sie die Delegatmethode embeddedPaymentElementDidUpdatePaymentOption.

extension MyCheckoutVC: EmbeddedPaymentElementDelegate { func embeddedPaymentElementDidUpdatePaymentOption(embeddedPaymentElement: EmbeddedPaymentElement) { print("The payment option changed: \(embeddedPaymentElement.paymentOption)") checkoutButton.isEnabled = embeddedPaymentElement.paymentOption != nil } }

Optional Zahlungsangaben aktualisieren

Wenn der Kunde/die Kundin Aktionen durchführt, die die Zahlungsdetails ändern (z. B. das Anwenden eines Rabattcodes), aktualisieren Sie die EmbeddedPaymentElement-Instanz, um die neuen Werte widerzugeben, indem Sie die update-Methode aufrufen. Bei einigen Zahlungsmethoden, wie Apple Pay und Google Pay, wird der Betrag in der Nutzeroberfläche angezeigt. Stellen Sie daher sicher, dass er immer korrekt und aktuell ist.

Wenn der Aktualisierungsaufruf abgeschlossen ist, aktualisieren Sie Ihre Nutzeroberfläche. Durch den Aktualisierungsaufruf kann sich die aktuell ausgewählte Zahlungsoption des Kunden/der Kundin ändern.

extension MyCheckoutVC { func update() { Task { @MainActor in var updatedIntentConfig = oldIntentConfig // Update the amount to reflect the price after applying the discount code updatedIntentConfig.mode = PaymentSheet.IntentConfiguration.Mode.payment(amount: 999, currency: "USD") let result = await embeddedPaymentElement?.update(intentConfiguration: updatedIntentConfig) switch result { case .canceled, nil: // Do nothing; this happens when a subsequent `update` call cancels this one break case .failed(let error): // Display error to user in an alert, let users retry case .succeeded: // Update your UI in case the payment option changed } } } }

Zahlung bestätigen

Wenn der/die Kund/in auf die Checkout-Schaltfläche tippt, rufen Sie embeddedPaymentElement.confirm() auf, um die Zahlung abzuschließen. Achten Sie darauf, die Nutzerinteraktion während der Bestätigung zu deaktivieren.

extension MyCheckoutVC { @objc func didTapConfirmButton() { Task { @MainActor in guard let embeddedPaymentElement else { return } self.view.isUserInteractionEnabled = false // Disable user interaction, show a spinner, and so on before calling confirm let result = await embeddedPaymentElement.confirm() switch result { case .completed: // Payment completed - show a confirmation screen. case .failed(let error): self.view.isUserInteractionEnabled = true // Encountered an unrecoverable error. You can display the error to the user, log it, etc. case .canceled: self.view.isUserInteractionEnabled = true // Customer canceled - you should probably do nothing. break } } } }

Implementieren Sie als Nächstes den Rückruf confirmHandler, den Sie zuvor an PaymentSheet.IntentConfiguration übergeben haben, um eine Anfrage an Ihren Server zu senden. Ihr Server erstellt einen PaymentIntent und gibt sein Client-Geheimnis zurück, wie unter PaymentIntent erstellen erläutert.

Wenn die Anfrage zurückkommt, rufen Sie intentCreationCallback mit dem Client-Geheimnis Ihrer Serverantwort auf oder geben Sie einen Fehler zurück. Das EmbeddedPaymentElement bestätigt den PaymentIntent mithilfe des Client-Geheimnisses oder zeigt die lokalisierte Fehlermeldung in seiner Nutzeroberfläche an (entweder errorDescription oder localizedDescription). Nach der Bestätigung kann EmbeddedPaymentElement nicht mehr verwendet werden. Leiten Sie die Nutzer/innen stattdessen zu einem Belegbildschirm oder ähnlichem weiter.

extension MyCheckoutVC { func handleConfirm(_ intentCreationCallback: @escaping (Result<String, Error>)-> Void) { // Make a request to your own server and receive a client secret or an error. let myServerResponse: Result<String, Error> = ... switch myServerResponse { case .success(let clientSecret): // Call the `intentCreationCallback` with the client secret intentCreationCallback(.success(clientSecret)) case .failure(let error): // Call the `intentCreationCallback` with the error intentCreationCallback(.failure(error)) } } }

OptionalAusgewählte Zahlungsoption löschen

OptionalMandat selbst anzeigen

OptionalLassen Sie den Kunden/die Kundin sofort im Formular bezahlen

PaymentIntent erstellen
Serverseitig

Erstellen Sie auf Ihrem Server a PaymentIntent durch Angabe eines Betrags und einer Währung. Sie können Zahlungsmethoden über das Dashboard verwalten. Stripe handhabt die Rückgabe geeigneter Zahlungsmethoden basierend auf Faktoren wie Betrag, Währung und Zahlungsablauf der Transaktion. Um zu verhindern, dass böswillige Kundinnen und Kunden ihre eigenen Preise wählen, sollten Sie den Preis immer auf der Serverseite (einer vertrauenswürdigen Umgebung) festlegen und nicht auf dem Client.

Wenn der Aufruf erfolgreich ist, geben Sie den PaymentIntent das Client-Geheimnis zurück. Wenn der Aufruf fehlschlägt, beheben Sie den Fehler und geben eine Fehlermeldung mit einer kurzen Erklärung an Ihre Kundin/Ihren Kunden zurück.

Notiz

Überprüfen Sie, ob alle IntentConfiguration-Eigenschaften mit Ihrem PaymentIntent (zum Beispiel setup_future_usage, amount und currency) übereinstimmen.

main.rb
Ruby
require 'stripe' Stripe.api_key =
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'
post '/create-intent' do data = JSON.parse request.body.read params = { amount: 1099, currency: 'usd', # In the latest version of the API, specifying the `automatic_payment_methods` parameter is optional because Stripe enables its functionality by default. automatic_payment_methods: {enabled: true}, } begin intent = Stripe::PaymentIntent.create(params) {client_secret: intent.client_secret}.to_json rescue Stripe::StripeError => e {error: e.error.message}.to_json end end

Rückgabe-URL einrichten
Clientseitig

Der Kunde/Die Kundin verlässt ggf. Ihre App, um sich zu authentifizieren (z. B. in Safari oder einer Banking-App). Damit sie nach der Authentifizierung automatisch zu Ihrer App zurückkehren können, konfigurieren Sie ein benutzerdefiniertes URL-Schema und richten Sie Ihren App-Delegate so ein, dass die URL an das SDK weitergeleitet wird. Stripe unterstützt keine universellen Links.

SceneDelegate.swift
Swift
// This method handles opening custom URL schemes (for example, "your-app://stripe-redirect") func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) { guard let url = URLContexts.first?.url else { return } let stripeHandled = StripeAPI.handleURLCallback(with: url) if (!stripeHandled) { // This was not a Stripe url – handle the URL normally as you would } }

Legen Sie außerdem die returnURL für Ihr EmbeddedPaymentElement.Configuration-Objekt auf die URL für Ihre App fest.

var configuration = EmbeddedPaymentElement.Configuration() configuration.returnURL = "your-app://stripe-redirect"

Ereignisse nach Zahlung verarbeiten
Serverseitig

Stripe sendet ein payment_intent.succeeded-Ereignis, wenn die Zahlung abgeschlossen ist. Verwenden Sie Webhook-Tool im Dashboard oder folgen Sie der Webhook-Anleitung, um diese Ereignisse zu empfangen und führen Sie Aktionen aus, wie beispielsweise das Senden einer Bestellbestätigung per E-Mail, das Protokollieren des Verkaufs in der Datenbank oder das Starten eines Versand-Workflows.

Überwachen Sie diese Ereignisse, statt auf einen Callback vom Client zu warten. Auf dem Client könnten die Kund/innen das Browserfenster schließen oder die App beenden, bevor der Callback erfolgt ist. Bösartige Clients könnten dann die Antwort manipulieren. Wenn Sie Ihre Integration so einrichten, dass sie asynchrone Ereignisse überwacht, können Sie verschiedene Arten von Zahlungsmethoden mit einer einzelnen Integration akzeptieren.

Neben der Abwicklung des payment_intent.succeeded-Ereignisses empfehlen wir die Abwicklung von diesen weiteren Ereignissen, wenn Sie Zahlungen mit dem Payment Element erfassen:

EreignisBeschreibungAktion
payment_intent.succeededWird gesendet, wenn Kundinnen und Kunden eine Zahlung erfolgreich abgeschlossen haben.Senden Sie den Kund/innen eine Auftragsbestätigung und wickeln Sie die Bestellung ab.
payment_intent.processingWird gesendet, wenn eine/e Kund/in eine Zahlung erfolgreich veranlasst hat, die Zahlung aber noch nicht abgeschlossen ist. Dieses Ereignis wird am häufigsten gesendet, wenn der Kunde/die Kundin eine Bankabbuchung veranlasst. In Zukunft folgt darauf entweder ein payment_intent.succeeded- oder ein payment_intent.payment_failed-Ereignis.Senden Sie eine Bestellbestätigung an die Kund/innen, in der angegeben ist, dass die Zahlung noch aussteht. Bei digitalen Waren können Sie die Bestellung abwickeln, bevor Sie darauf warten, dass die Zahlung erfolgt.
payment_intent.payment_failedWird gesendet, wenn ein Kunde/eine Kundin einen Zahlungsversuch durchführt, die Zahlung jedoch fehlschlägt.Wenn eine Zahlung von processing zu payment_failed übergeht, bieten Sie der Kundin/dem Kunden einen weiteren Zahlungsversuch an.

Integration testen

KartennummerSzenarioSo führen Sie den Test durch
Die Kartenzahlung ist erfolgreich und es ist keine Authentifizierung erforderlich.Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
Für die Kartenzahlung ist eine Authentifizierung erforderlich.Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
Die Karte wird mit einem Ablehnungscode wie insufficient_funds abgelehnt.Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
Die UnionPay-Karte hat eine variable Länge von 13 bis 19 Ziffern.Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.

Hier finden Sie weitere Informationen zum Testen Ihrer Integration.

OptionalKarten speichern
Serverseitig
Clientseitig

OptionalZahlungsmethoden mit Verzögerung zulassen
Clientseitig

OptionalApple Pay aktivieren

OptionalKartenscannen aktivieren

OptionalElement anpassen

OptionalAktiveren der Funktion zur erneuten Erfassung der Prüfziffer/CVC bei Bestätigung

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc