Multibanco-Zahlungen annehmen

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
    }
}

Stripe verwendet ein PaymentIntent-Objekt, um Ihre Absicht darzustellen, eine Kundenzahlung einzuziehen und Statusänderungen von der Erstellung des Multibanco-Gutscheins bis zum Zahlungsabschluss zu dokumentieren.

Serverseitig

Erstellen Sie einen PaymentIntent auf Ihrem Server mit einem Betrag und der Währung eur (Multibanco unterstützt keine anderen Währungen). Wenn Sie bereits eine Integration mit dem Payment Intents API haben, fügen Sie multibanco zur Liste der Zahlungsmethoden für Ihren PaymentIntent hinzu.

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

Der zurückgegebene PaymentIntent enthält ein Client-Geheimnis, das Sie verwenden werden, um den PaymentIntent zu bestätigen. Übermitteln Sie das Client-Geheimnis zurück an den Client, damit Sie es im nächsten Schritt verwenden können.

Clientseitig

Fordern Sie auf dem Client einen PaymentIntent von Ihrem Server an und speichern Sie das zugehörige Client-Geheimnis.

class CheckoutViewController: UIViewController {
    var paymentIntentClientSecret: String?

    // ...continued from previous step

    override func viewDidLoad() {
        // ...continued from previous step
        startCheckout()
    }

    func startCheckout() {
        // Request a PaymentIntent from your server and store its client secret
        // Click View full sample to see a complete implementation
    }
}

Erfassen Sie in Ihrer App die folgenden erforderlichen Rechnungsdetails der Kundin/des Kunden. Erstellen Sie ein STPPaymentIntentParams-Objekt mit den Rechnungsdetails.

let billingDetails = STPPaymentMethodBillingDetails()
billingDetails.email = "jenny@example.com"

Übermitteln Sie die Rechnungsdaten der Kundin/des Kunden, indem Sie STPPaymentHandler confirmPayment mit dem Client-Geheimnis des von Ihnen erstellten PaymentIntent Objekts aufrufen. Nun wird eine Webansicht präsentiert, in der der Multibanco-Gutschein angezeigt wird. Danach wird der Completion-Block mit dem Ergebnis der Zahlung aufgerufen.

let paymentIntentParams = STPPaymentIntentParams(clientSecret: paymentIntentClientSecret)
let multibancoParams = STPPaymentMethodMultibancoParams();
paymentIntentParams.paymentMethodParams = STPPaymentMethodParams(
    multibanco: multibancoParams,
    billingDetails: billingDetails,
    metadata: nil
)

STPPaymentHandler.shared().confirmPayment(paymentIntentParams, with: self) { (handlerStatus, paymentIntent, error) in
    switch handlerStatus {
    case .succeeded:
        // The Multibanco voucher was displayed successfully. The customer can now pay the Multibanco voucher
    case .canceled:
        // Handle cancelation
    case .failed:
        // Handle failure
    @unknown default:
        fatalError()
    }
}

Stripe sendet ein payment_intent.requires_action-Ereignis, wenn ein Multibanco-Gutschein erfolgreich erstellt wurde. Wenn Sie Ihren Kundinnen/Kunden den Link für Zahlungsanweisungen zum Gutschein per E-Mail senden müssen, können Sie die hosted_voucher_url bei payment_intent.next_action.multibanco_display_details.hosted_voucher_url ermitteln.

Multibanco ist eine Zahlungsmethode mit verzögerter Benachrichtigung. Ein Kunde/Eine Kundin bezahlt einen Multibanco-Gutschein außerhalb Ihres Bezahlvorgangs über das Online-Banking oder an einem Geldautomaten.

Nach Abschluss einer Multibanco-Zahlung sendet Stripe das Ereignis payment_intent.succeeded. Verwenden Sie das Dashboard oder erstellen Sie einen Webhook-Handler, um diese Ereignisse zu erhalten und Aktionen auszuführen. Beispiele für Aktionen sind u. a. das Senden einer E-Mail zur Bestellbestätigung an Ihre Kund/innen, das Protokollieren des Verkaufs in einer Datenbank oder das Starten eines Versand-Workflows.

Erfahren Sie mehr über den Ablaufzeitpunkt von Multibanco.

Ereignisse empfangen und Geschäftsaktionen ausfü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.

Erfahren Sie, wie Sie einen benutzerdefinierten Webhook erstellen.

Legen Sie in einer Sandbox STPPaymentMethodBillingDetails email auf die folgenden Werte fest, wenn Sie STPPaymentHandler confirmPayment aufrufen, um verschiedene Szenarien zu testen.