Die schwedische Zahlungsmethode Swish zählt zu den beliebtesten Zahlungsmethoden in Schweden.Mehr als die Hälfte der Bevölkerung nutzt die App auf ihrem Handy.Ursprünglich war Swish ein Joint Venture der bekanntesten schwedischen Banken und diente als reine P2P-Zahlungsmethode.Seit 2017 ist es auch für E-Commerce und am POS verfügbar.Bezahlen kann man entweder per Scan eines QR-Codes oder durch Angabe der Handy- oder Swish-Nummer.
Erste Schritte
Um Swish für Ihr Händlerkonto zu aktivieren, benötigen Sie zunächst das Zertifikat von Swish.Führen Sie die folgenden Schritte aus, um Ihr Swish-Zertifikat bereitzustellen:
Erhalten Sie Zugriff auf das Swish-Zertifikatverwaltungstool.Weitere Informationen finden Sie in der Swish-Dokumentation.
Wenden Sie sich an den
, um eine Zertifikatsignieranforderung (CSR) anzufordern.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Helpdesk-Name PageWithExcerpt Wording
generiert die CSR und sendet sie Ihnen zu.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Helpdesk-Name PageWithExcerpt Wording Laden Sie die erhaltene CSR in das Swish-Zertifikatverwaltungstool hoch.
Generieren und laden Sie das Zertifikat gemäß den Anweisungen (Abschnitt 2.6 der Swish-Dokumentation) herunter.Akzeptierte Formate: PEM oder PKCS#7.
Antworten Sie auf die CSR-E-Mail von
und fügen Sie das heruntergeladene Zertifikat im Anhang bei.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Helpdesk-Name PageWithExcerpt Wording
Sobald Ihr Zertifikat verarbeitet wurde, aktiviert
Swish für Ihre MID.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Helpdesk-Name PageWithExcerpt Wording
Integrationsoptionen
Swish wird ausschließlich über die Direktintegration unterstützt.
| Info |
|---|
Im Gegensatz zur üblichen DirektintegrationDirektintegration folgt Swish einem benutzerdefinierten Integrationsablauf.Beachten Sie die detaillierten Anweisungen unten, um die Integration korrekt durchzuführen. |
Prozessablauf
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Der Kunde geht mit Swish zur Kasse.
Ihr Frontend ruft Ihren Server auf, um die Swish-Zahlung fortzusetzen.
Ihr Server macht einen Aufruf Zahlung anlegenZahlung anlegen mit:
Code Block "paymentMethods": { "type": "SWISH", "integrationType": "DIRECT" }Das
startet eine Zahlungsanfrage an Swish.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording Swish gibt die notwendigen Informationen zurück, um den Kundenbestätigungsablauf über die Swish-App im Frontend zu orchestrieren.
sendet die Antwort an Ihren Server. Das providerToken ist nur für Zahlungen über die App verfügbar (channel=APP).Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording Ihr Server orchestriert den Ablauf der Kundenbestätigung in der Swish-App.
Der Kunde bestätigt die Zahlung in der Swish-App.
Das
erhält erhält die Bestätigung der abgeschlossenen Zahlung.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording Das
benachrichtigt die in der ursprünglichen Anfrage übermittelteMultiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording urls.notifymit derpayIdim Benachrichtigungstext.Ihr Server führt einen Aufruf Zahlungsdetails per Payment ID abrufenZahlungsdetails per Payment ID abrufen mit der
payIdaus, um den responseCode der Zahlung abzurufen.Das
antwortet antwortet mit dem responseCode der Zahlung zusammen mit weiteren Parametern.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording Basierend auf dem responseCode der Zahlung gibt Ihr Server eine Erfolgs- oder Fehlerseite zurück.
Stornierung
Wenn eine Swish-Zahlung vor der Verrechnung storniert werden muss, können Sie eine Stornierung veranlassen.
Um eine Swish-Zahlung zu stornieren, verwenden Sie den Endpunkt Zahlung stornierenZahlung stornieren mit der originalen payId.
Gutschrift
Swish unterstützt Gutschriften nach einer erfolgreichen und abgerechneten Zahlung.
Um eine Gutschrift zu veranlassen, verwenden Sie den Endpunkt Zahlung gutschreibenZahlung gutschreiben mit der originalen payId.