Direct Charges erstellen

Für eine Apple-Händler-ID registrieren

Beantragen Sie eine Apple-Händler-ID, indem Sie sich auf der Apple Developer-Website für eine neue Kennung registrieren.

Tragen Sie eine Beschreibung und eine Kennung in das Formular ein. Die Beschreibung ist nur für Ihre internen Zwecke bestimmt und kann später geändert werden. Stripe empfiehlt, dass Sie den Namen Ihrer App als Kennung verwenden, zum Beispiel merchant.com.{{YOUR_APP_NAME}}.

Neues Apple Pay-Zertifikat erstellen

Erstellen Sie ein Zertifikat für Ihre App, um Zahlungsdaten zu verschlüsseln.

Gehen Sie zu den iOS-Zertifikateinstellungen im Dashboard, klicken Sie auf Neue Anwendung hinzufügen und befolgen Sie die Anleitung.

Laden Sie eine Certificate Signing Request (CSR)-Datei herunter, um ein sicheres Zertifikat von Apple zu erhalten, mit dem Sie Apple Pay verwenden können.

Eine CSR-Datei muss verwendet werden, um genau ein Zertifikat auszustellen. Wenn Sie Ihre Apple-Händler-ID wechseln, müssen Sie zu den iOS-Zertifikateinstellungen im Dashboard gehen, um eine neue CSR und ein Zertifikat zu erhalten.

Mit Xcode integrieren

Fügen Sie Ihrer App die Apple Pay-Funktion hinzu. Öffnen Sie in Xcode Ihre Projekteinstellungen, klicken Sie auf die Registerkarte Signing & Capabilities (Anmeldung und Funktionen) und fügen Sie die Apple Pay-Funktion hinzu. Möglicherweise werden Sie an dieser Stelle aufgefordert, sich bei Ihrem Entwicklerkonto anzumelden. Wählen Sie die zuvor erstellte Händler-ID aus. Ihre App sollte nun Apple Pay unterstützen.

Apple Pay-Funktion in Xcode aktivieren

Apple Pay hinzufügen

var configuration = PaymentSheet.Configuration()
configuration.applePay = .init(
  merchantId: "merchant.com.your_app_name",
  merchantCountryCode: "US"
)

Bestellverfolgung

Um Informationen zur Bestellverfolgung in iOS 16 oder höher hinzuzufügen, konfigurieren Sie einen authorizationResultHandler in Ihren PaymentSheet.ApplePayConfiguration.Handlers. Stripe ruft Ihre Implementierung auf, nachdem die Zahlung durchgeführt wurde, aber bevor iOS das Apple Pay-Formular schließt.

Rufen Sie in Ihrer authorizationResultHandler-Implementierung die Bestelldetails für die abgeschlossene Bestellung von Ihrem Server ab. Fügen Sie dem angegebenen PKPaymentAuthorizationResult die Details hinzu und rufen Sie den angegebenen Abschluss-Handler auf.

Weitere Informationen zur Bestellverfolgung finden Sie in der Dokumentation zu Wallet-Bestellungen von Apple.

let customHandlers = PaymentSheet.ApplePayConfiguration.Handlers(
    authorizationResultHandler: { result, completion in
        // Fetch the order details from your service
        MyAPIClient.shared.fetchOrderDetails(orderID: orderID) { myOrderDetails
            result.orderDetails = PKPaymentOrderDetails(
                orderTypeIdentifier: myOrderDetails.orderTypeIdentifier, // "com.myapp.order"
                orderIdentifier: myOrderDetails.orderIdentifier, // "ABC123-AAAA-1111"
                webServiceURL: myOrderDetails.webServiceURL, // "https://my-backend.example.com/apple-order-tracking-backend"
                authenticationToken: myOrderDetails.authenticationToken) // "abc123"
            // Call the completion block on the main queue with your modified PKPaymentAuthorizationResult
            completion(result)
        }
    }
)
var configuration = PaymentSheet.Configuration()
configuration.applePay = .init(merchantId: "merchant.com.your_app_name",
                               merchantCountryCode: "US",
                               customHandlers: customHandlers)

Um die Unterstützung für Kartenscans zu aktivieren, setzen Sie NSCameraUsageDescription (Datenschutz – Beschreibung Kameranutzung) in der Info.plist Ihrer Anwendung und geben Sie einen Grund für den Zugriff auf die Kamera an (zum Beispiel „zum Scannen von Karten“). Geräte mit iOS 13 oder höher unterstützen Kartenscans.

Alle Anpassungen werden mithilfe des PaymentSheet.Configuration-Objekts konfiguriert.

Erscheinungsbild

Passen Sie mit der Appearance API Farben, Schriftarten und mehr an das Erscheinungsbild Ihrer App an.

Layout der Zahlungsmethode

Konfigurieren Sie das Layout der Zahlungsmethoden im Formular mit paymentMethodLayout. Sie können sie horizontal oder vertikal anzeigen oder das Layout von Stripe automatisch optimieren lassen.

var configuration = PaymentSheet.Configuration()
configuration.paymentMethodLayout = .automatic

Adressen der Nutzer/innen erfassen

Erfassen Sie lokale und internationale Versand- und Rechnungsadressen von Ihren Kundinnen und Kunden mithilfe des Address Element.

Anzeigename des Händlers

Geben Sie einen kundenorientierten Unternehmensnamen an, indem Sie merchantDisplayName festlegen. Standardmäßig handelt es sich dabei um den Namen Ihrer App.

var configuration = PaymentSheet.Configuration()
configuration.merchantDisplayName = "My app, Inc."

Dunkelmodus

PaymentSheet passt sich automatisch an die systemweiten Erscheinungsbildeinstellungen des Nutzers/der Nutzerin an (heller und dunkler Modus). Wenn Ihre App den Dunkelmodus nicht unterstützt, können Sie den Stil auf den Modus alwaysLight oder alwaysDark einstellen.

var configuration = PaymentSheet.Configuration()
configuration.style = .alwaysLight

Standardabrechnungsdetails

Um Standardwerte für die im Zahlungsformular erfassten Rechnungsdetails festzulegen, konfigurieren Sie die Eigenschaft defaultBillingDetails. Die Felder von PaymentSheet werden vorab mit den von Ihnen angegebenen Werten ausgefüllt.

var configuration = PaymentSheet.Configuration()
configuration.defaultBillingDetails.address.country = "US"
configuration.defaultBillingDetails.email = "foo@bar.com"

Erfassung der Rechnungsdetails

Verwenden Sie billingDetailsCollectionConfiguration, um anzugeben, wie Sie Rechnungsdetails im Zahlungsformular erfassen möchten.

Sie können den Namen, die E-Mail-Adresse, die Telefonnummer und die Adresse Ihrer Kundinnen und Kunden erfassen.

Wenn Sie nur die für die Zahlungsmethode erforderlichen Rechnungsdetails angeben möchten, legen Sie billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod auf „true“ fest. In diesem Fall werden PaymentSheet.Configuration.defaultBillingDetails als Abrechnungsdetails der Zahlungsmethode festgelegt.

Wenn Sie zusätzliche Rechnungsdetails erfassen möchten, die für die Zahlungsmethode nicht unbedingt erforderlich sind, legen Sie billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod auf „false“ fest. In diesem Fall werden die über das PaymentSheet erfassten Rechnungsdetails als Rechnungsdetails der Zahlungsmethode festgelegt.

var configuration = PaymentSheet.Configuration()
configuration.defaultBillingDetails.email = "foo@bar.com"
configuration.billingDetailsCollectionConfiguration.name = .always
configuration.billingDetailsCollectionConfiguration.email = .never
configuration.billingDetailsCollectionConfiguration.address = .full
configuration.billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod = true

Sie können das Zahlungsformular anzeigen, um nur die Details einer Zahlungsmethode zu erfassen, und später eine confirm-Methode aufrufen, um die Zahlung in der Nutzeroberfläche Ihrer App abzuschließen. Dies ist nützlich, wenn Sie eine nutzerspezifische Kaufschaltfläche haben oder zusätzliche Schritte erforderlich sind, nachdem Sie die Zahlungsdetails erfasst haben.

Schließen Sie die Zahlung über die Nutzeroberfläche Ihrer App ab

PaymentSheet.FlowController.create(paymentIntentClientSecret: paymentIntentClientSecret, configuration: configuration) { [weak self] result in
  switch result {
  case .failure(let error):
    print(error)
  case .success(let paymentSheetFlowController):
    self?.paymentSheetFlowController = paymentSheetFlowController
    // Update your UI using paymentSheetFlowController.paymentOption
  }
}

paymentSheetFlowController.presentPaymentOptions(from: self) {
  // Update your UI using paymentSheetFlowController.paymentOption
}

paymentSheetFlowController.confirm(from: self) { paymentResult in
  // MARK: Handle the payment result
  switch paymentResult {
  case .completed:
    print("Payment complete!")
  case .canceled:
    print("Canceled!")
  case .failed(let error):
    print(error)
  }
}

Wenn das Ergebnis von PaymentSheetResult .completed lautet, informieren Sie den/die Nutzer/in, (zum Beispiel durch die Anzeige einer Bestellbestätigung).

Wenn Sie allowsDelayedPaymentMethods auf true festlegen, werden Zahlungsmethoden mit verzögerter Benachrichtigung wie US-Bankkonten zugelassen. Für diese Zahlungsmethoden ist der endgültige Zahlungsstatus nicht bekannt, wenn das PaymentSheet abgeschlossen wird. Stattdessen ist sie erfolgreich oder schlägt fehl. Wenn Sie diese Art von Zahlungsmethoden unterstützen, informieren Sie den Kunden/die Kundin darüber, dass seine/ihre Bestellung bestätigt ist, und führen seine/ihre Bestellung erst aus (z. B. das Produkt versenden), wenn die Zahlung erfolgreich ist.

Navigieren Sie im Dashboard zu Zahlungsmethoden für Ihre verbundenen Konten verwalten, um zu konfigurieren, welche Zahlungsmethoden Ihre verbundenen Konten akzeptieren. Änderungen an den Standardeinstellungen gelten für alle neuen und bestehenden verbundenen Konten.

Informationen zu den Zahlungsmethoden finden Sie in den folgenden Ressourcen:

• Ein Leitfaden zu Zahlungsmethoden, der Ihnen bei der Auswahl der richtigen Zahlungsmethoden für Ihre Plattform hilft.
• Kontofunktionen, um sicherzustellen, dass die gewählten Zahlungsmethoden für Ihre verbundenen Konten funktionieren.
• Zahlungsmethode und Produktsupport, um sicherzustellen, dass die gewählten Zahlungsmethoden für Ihre Stripe-Produkte und Zahlungsabläufe geeignet sind.

Für jede Zahlungsmethode können Sie eine der folgenden Dropdown-Optionen wählen:

Optionen für Zahlungsmethoden

Wenn Sie eine Änderung an einer Zahlungsmethode vornehmen, müssen Sie auf Änderungen überprüfen in der Leiste unten im Bildschirm klicken und auf Speichern und anwenden, um Ihre verbundenen Konten zu aktualisieren.

Dialogfeld „Speichern“

Verbundenen Konten die Verwaltung von Zahlungsmethoden gestatten

Stripe empfiehlt, dass Sie Ihren verbundenen Konten erlauben, ihre eigenen Zahlungsmethoden anzupassen. Diese Option ermöglicht jedem verbundenen Konto mit Zugriff auf das Stripe-Dashboard, seine Seite mit den Zahlungsmethoden anzuzeigen und zu aktualisieren. Nur Inhaber/innen der verbundenen Konten können ihre Zahlungsmethoden anpassen. Das Stripe-Dashboard zeigt die Standard-Zahlungsmethoden an, die Sie auf alle neuen und bestehenden verbundenen Konten angewendet haben. Ihre verbundenen Konten können diese Standardeinstellungen außer Kraft setzen, mit Ausnahme der von Ihnen blockierten Zahlungsmethoden.

Aktivieren Sie das Kontrollkästchen Anpassung des Kontos, um diese Option zu aktivieren. Sie müssen auf Änderungen überprüfen in der Leiste unten im Bildschirm klicken und dann Speichern und übernehmen auswählen, um diese Einstellung zu aktualisieren.

Kontrollkästchen „Anpassung des Kontos“

Funktionen der Zahlungsmethode

Damit Ihre verbundenen Konten zusätzliche Zahlungsmethoden akzeptieren können, müssen Sie sicherstellen, dass ihre verbundenen Konten aktive Funktionen für jede Zahlungsmethode haben. Die meisten Zahlungsmethoden haben die gleichen Verifizierungsanforderungen wie die Funktion card_payments, mit einigen Einschränkungen und Ausnahmen. In der Tabelle mit den Funktionen für Zahlungsmethoden sind die Zahlungsmethoden aufgeführt, die eine zusätzliche Verifizierung über Karten erfordern.