Zahlungen per Sofort akzeptieren

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Serverseitig

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

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Clientseitig

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

Konfigurieren Sie das SDK mit Ihrem veröffentlichbaren Schlüssel von Stripe, um es beim Start der App auszuführen. Dadurch kann Ihre App Anfragen an die Stripe-API senden.

import UIKit
import StripePaymentsUI

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        StripeAPI.defaultPublishableKey = 
"pk_test_TYooMQauvdEDq54NiTphI7jx"
        // do any other necessary launch configuration
        return true
    }
}

Ein PaymentIntent stellt Ihre Absicht dar, Zahlungen von Kundinnen und Kunden einzuziehen, und dokumentiert den gesamten Zahlungsvorgang.

Serverseitig

Erstellen Sie eine PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden amount und die Währung eur an (Sofort unterstützt keine anderen Währungen). Wenn Sie über eine bestehende Payment Intents-Integration verfügen, fügen Sie sofort der Liste der Arten der Zahlungsmethoden hinzu.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=sofort

Bevorzugte Sprache ändern

Die Autorisierungsseite für Sofort zeigt Stripe standardmäßig in der Sprache an, die dem angegebenen Ländercode entspricht. Sie können diese Spracheinstellung an die bevorzugte Sprache der Kundin/des Kunden anpssen, indem Sie sie in der Anfrage übermitteln und den Wert der Eigenschaft preferred_language ändern. Die unterstützten Werte sind de, en, es, it, fr, nl und pl.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=sofort \
  -d "payment_method_options[sofort][preferred_language]"=de

Statt das gesamte PaymentIntent-Objekt an Ihre App zu übergeben, übergeben Sie nur das Client-Geheimnis. Das Client-Geheimnis des PaymentIntent ist ein eindeutiger Schlüssel, mit dem Sie die Zahlung bestätigen und Zahlungsdetails auf dem Client aktualisieren können, ohne dass eine Manipulation vertraulicher Daten, wie beispielsweise des Zahlungsbetrags, möglich ist.

Clientseitig

Fordern Sie auf dem Client einen PaymentIntent von Ihrem Server an und speichern Sie sein Client-Geheimnis.

class CheckoutViewController: UIViewController {
var paymentIntentClientSecret: String?

func startCheckout() {
  // Request a PaymentIntent from your server and store its client secret
}
}

Wenn ein Kunde auf „Zahlung mit Sofort“ klickt, bestätigen Sie die PaymentIntent, um die Zahlung abzuschließen. Konfigurieren Sie ein STPPaymentIntentParams Objekt mit dem Client-Geheimnis PaymentIntent von Ihrem Server. Sofort verlangt, dass Sie den Ländercode der Bank Ihrer Kundin/Ihres Kunden erfassen und in STPPaymentMethodSofortParams übergeben.

Anstatt das gesamte PaymentIntent-Objekt an den Client zu senden, wird die Verwendung des Client-Geheimnisses empfohlen. Dies unterscheidet sich von Ihren API-Schlüsseln, die Stripe-API-Anfragen authentifizieren. Das Client-Geheimnis ist eine Zeichenkette, mit der Ihre App auf wichtige Felder aus dem PaymentIntent zugreifen kann (z. B. status), während sensible Felder verborgen bleiben (z. B. customer).

Rückgabe-URL einrichten

Das iOS SDK kann zur Durchführung einer Zahlung per Sofort eine Webansicht in Ihrer App anzeigen. Wenn die Authentifizierung abgeschlossen ist, muss Ihre Kundin/Ihr Kunde sie nicht schließen, sondern dies geschieht automatisch. Um dieses Verhalten zu aktivieren, konfigurieren Sie ein benutzerdefiniertes URL-Schema oder einen Universal-Link und richten Sie Ihre App so ein, dass die URL an das SDK weitergeleitet wird.

// This method handles opening custom URL schemes (for example, "your-app://stripe-redirect")
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    let stripeHandled = StripeAPI.handleURLCallback(with: url)
    if (stripeHandled) {
        return true
    } else {
        // This was not a Stripe url – handle the URL normally as you would
    }
    return false
}

// This method handles opening universal link URLs (for example, "https://example.com/stripe_ios_callback")
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
        if let url = userActivity.webpageURL {
            let stripeHandled = StripeAPI.handleURLCallback(with: url)
            if (stripeHandled) {
                return true
            } else {
                // This was not a Stripe url – handle the URL normally as you would
            }
        }
    }
    return false
}

Rufen Sie STPPaymentHandler confirmPayment auf, um die Zahlung abzuschließen.

let paymentIntentParams = STPPaymentIntentParams(clientSecret: paymentIntentClientSecret)

let sofort = STPPaymentMethodSofortParams()
sofort.country = "DE"

paymentIntentParams.paymentMethodParams = STPPaymentMethodParams(sofort: sofort, billingDetails: nil, metadata: nil)

paymentIntentParams.returnURL = "payments-example://stripe-redirect"
STPPaymentHandler.shared().confirmPayment(paymentIntentParams, with: self) { (handlerStatus, paymentIntent, error) in
    switch handlerStatus {
    case .succeeded:
        // Payment succeeded
        // ...

    case .canceled:
        // Payment canceled
        // ...

    case .failed:
        // Payment failed
        // ...

    @unknown default:
        fatalError()
    }
}

As Sofort is a delayed notification payment method, the PaymentIntent’s status remains in a payment_intent.processing state for up to 14 days from its creation (also known as the cutoff date). In a sandbox, the PaymentIntent’s status remains in the processing state for three minutes to simulate this.

• Stripe empfiehlt, Bestellungen während des Verarbeitungszustands abzuwickeln. Im Durchschnitt können Sie davon ausgehen, dass etwa 0,2 % der Sofort-Zahlungsversuche nach dem Wechsel in den Verarbeitungszustand fehlschlagen. Dies gilt nur für Sofort-Zahlungen aufgrund der geringen Fehlerquote und nicht für andere Zahlungsmethoden mit verzögerter Benachrichtigung.
• Möglicherweise ziehen Sie es vor, Bestellungen erst nach Erhalt des payment_intent.succeeded-Ereignisses auszuführen. Stripe sendet dieses Ereignis, nachdem der Zahlungsversuch bestätigt wurde und die Gelder garantiert sind.
• Falls eine Kundin/ein Kunde nicht bezahlt, sendet Stripe das payment_intent.failed-Ereignis, und der PaymentIntent wechselt wieder in den Status requires_payment_method.

Verwenden Sie das Dashboard, einen benutzerdefinierten Webhook oder eine Partnerlösung, um diese Ereignisse zu empfangen und Aktionen, wie das Versenden einer Bestellbestätigung per E-Mail, das Erfassen des Verkaufs in einer Datenbank oder das Initiieren eines Versandworkflows, auszuführen.

Manuell

Im Stripe-Dashboard können Sie alle Stripe-Zahlungen anzeigen, Zahlungsbelege per E-Mail versenden, Auszahlungen abwickeln oder fehlgeschlagene Zahlungen erneut durchführen.

• Testzahlungen im Dashboard anzeigen

Benutzerdefinierter Code

Erstellen Sie einen Webhook-Handler, um Ereignisse zu überwachen und benutzerdefinierte asynchrone Zahlungsabläufe zu erstellen. Mit der Stripe-CLI können Sie Ihre Webhook-Integration lokal testen und Fehler beheben.

• Nutzerdefinierten Webhook erstellen

Vorgefertigte Apps

Verarbeiten Sie häufige Geschäftsereignisse, wie Automatisierung oder Marketing und Vertrieb durch Integration einer Partneranwendung.