Swish-ZahlungenNur auf Einladung
Erfahren Sie, wie Sie Zahlungen per Swish, einer beliebten Zahlungsmethode in Schweden, akzeptieren.
Swish ist eine in Schweden verwendete Zahlungsmethoden zum einmaligen Gebrauch. Sie bietet Kundinnen und Kunden die Möglichkeit, Zahlungen mit der mobilen Swish-App und der schwedischen mobilen BankID-App zu authentifizieren und zu genehmigen.
Sie erhalten eine sofortige Benachrichtigung, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.
Erforderliche Hinweise
Um die Swish-Regeln einzuhalten, müssen Sie in Ihrem Zahlungsablauf den folgenden Text anzeigen, bevor die Kundin/der Kunde die Swish-Zahlung autorisiert:
- Für englische Lokalisierungen: „Stripe Technology Europe Limited („Stripe“) has acquired the claim for payment. Therefore your payment will be made to Stripe.“
- Für schwedische Lokalisierungen: „Stripe Technology Europe Limited („Stripe“) har övertagit fordran på betalning. Din betalning görs därför till Stripe.”
- Für andere Sprachen eine gleichwertige Übersetzung des Vorstehenden.
Wenn Sie Swish über ein von Stripe gehostetes Zahlungsformular oder eine von Stripe gehostete Nutzeroberfläche wie Checkout oder das Payment Element integrieren, zeigt Stripe Ihnen diesen Hinweis an.
Wir empfehlen die Verwendung des mobilen Payment Element. Bei diesem handelt es sich um ein Zahlungsformular, über das Sie Swish und weitere Zahlungsmethoden mit wenig Aufwand zu Ihrer Integration hinzufügen können.
In diesem Leitfaden erfahren Sie, wie Sie Swish über Ihre native Mobilanwendung akzeptieren, wenn Sie Ihr eigenes benutzerdefiniertes Zahlungsformular verwenden möchten.
Wenn Sie Swish über Ihre native mobile App akzeptieren, werden Ihre Kundinnen/Kunden zur Authentifizierung an die mobile Swish-App weitergeleitet. Die Zahlung wird bei der Weiterleitung authentifiziert. Der Abschluss des Kaufs erfordert keine zusätzlichen Aktionen in der mobilen Swish-App, und die Kundinnen/Kunden werden auf Ihre Seite zurückgeleitet.
Stripe einrichtenServerseitigClientseitig
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:
Clientseitig
Das Stripe iOS SDK ist Open Source, vollständig dokumentiert und kompatibel mit Apps, die iOS 13 oder höher unterstützen.
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.
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.
Notiz
Verwenden Sie Ihre Testschlüssel beim Testen und Entwickeln Ihrer App und Ihre Live-Modus-Schlüssel beim Veröffentlichen Ihrer App.
Erstellen Sie ein PaymentIntentServerseitigClientseitig
Serverseitig
Ein PaymentIntent ist ein Objekt, das Ihre Absicht, eine Kundenzahlung einzuziehen, repräsentiert und den gesamten Zahlungsvorgang dokumentiert.
So erstellen und bestätigen Sie einen PaymentIntent
auf Ihrem Server:
- Geben Sie den einzuziehenden Betrag und die Währung an.
- Fügen Sie
swish
zur Liste der Zahlungsmethoden für IhrenPaymentIntent
hinzu. Vergewissern Sie sich, dass Swish im Dashboard aktiviert ist. - Setzen Sie
payment_
aufmethod_ data[type] swish
, um eine PaymentMethod zu erstellen und diese sofort mit diesem PaymentIntent zu verwenden.
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 sein Client-Geheimnis.
Zahlung an Stripe sendenClientseitig
Wenn Kundinnen/Kunden die Schaltfläche zum Bezahlen mit Swish antippen, bestätigen Sie den PaymentIntent
, um die Zahlung abzuschließen. Konfigurieren Sie ein STPPaymentIntentParams
-Objekt mit dem Client-Geheimnis des PaymentIntent
.
Das Client-Geheimnis unterscheidet sich von Ihren API-Schlüsseln, die die Stripe API-Anfragen authentifizieren. Achten Sie auf einen vorsichtigen Umgang mit dem Client-Geheimnis, da mit ihm die Zahlungen abgeschlossen werden können. Es darf nicht protokolliert, in URLs eingebettet oder anderen Personen zugänglich gemacht werden.
Rückgabe-URL einrichten
Das iOS SDK zeigt zur Durchführung einer Zahlung per Swish eine Webansicht in Ihrer App an. Wenn die Authentifizierung abgeschlossen ist, muss Ihre Kundin/Ihr Kunde sie nicht schließen, da dies automatisch geschieht. 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.
Übergeben Sie die URL als return_
, wenn Sie den PaymentIntent bestätigen. Nach Abschluss der Authentifizierung über die Webansicht leitet Stripe die Nutzer/innen an die return_
weiter.
Swish-Zahlung bestätigen
Führen Sie durch Aufrufen von STPPaymentHandler confirmPayment
die Zahlung durch. Dies entspricht einer Webansicht, über die die Kundinnen/Kunden die Zahlung per Swish durchführen können. Danach wird der Completion-Block mit dem Ergebnis der Zahlung aufgerufen.
Fehlgeschlagene Zahlungen
Swish verwendet mehrere Datenpunkte, um zu entscheiden, wann eine Transaktion abgelehnt wird (zum Beispiel ist das Kundenguthaben auf dem Bankkonto nicht ausreichende oder die Kundin/der Kunde hat in der App auf Abbrechen geklickt).
In diesen Fällen wird die PaymentMethod getrennt und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_
.
Anders als bei einer abgelehnten Zahlung müssen Kundinnen/Kunden bei einem Swish-PaymentIntent mit dem Status requires_
die Zahlung innerhalb von 3 Minuten nach abschließen. Wenn nach 3 Minuten keine Aktion erfolgt ist, wird die PaymentMethod getrennt, und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_
.