REST API Swish

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:

1. Erhalten Sie Zugriff auf das Swish-Zertifikatverwaltungstool. Weitere Informationen finden Sie in der Swish-Dokumentation.

2. Wenden Sie sich an den The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro, um eine Zertifikatsignieranforderung (CSR) anzufordern.

3. The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro generiert die CSR und sendet sie Ihnen zu.

4. Laden Sie die erhaltene CSR in das Swish-Zertifikatverwaltungstool hoch.

5. Generieren und laden Sie das Zertifikat gemäß den Anweisungen (Abschnitt 2.6 der Swish-Dokumentation) herunter. Akzeptierte Formate: PEM oder PKCS#7.

6. Antworten Sie auf die CSR-E-Mail von The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro und fügen Sie das heruntergeladene Zertifikat im Anhang bei.

Sobald Ihr Zertifikat verarbeitet wurde, aktiviert The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro Swish für Ihre MID.

Integrationsoptionen

Swish wird ausschließlich über die Direktintegration unterstützt.

Prozessablauf

1. Der Kunde geht mit Swish zur Kasse.

2. Ihr Frontend ruft Ihren Server auf, um die Swish-Zahlung fortzusetzen. 

3. Ihr Server macht einen Aufruf Zahlung anlegenZahlung anlegen mit: 

   "paymentMethods": {
     "type": "SWISH",
     "integrationType": "DIRECT"
   }

4. Das The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro startet eine Zahlungsanfrage an Swish.

5. Swish gibt die notwendigen Informationen zurück, um den Kundenbestätigungsablauf über die Swish-App im Frontend zu orchestrieren.

6. The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro sendet die Antwort an Ihren Server. Das providerToken ist nur für Zahlungen über die App verfügbar (channel=APP).

7. Ihr Server orchestriert den Ablauf der Kundenbestätigung in der Swish-App.

8. Der Kunde bestätigt die Zahlung in der Swish-App.

9. Das The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro erhält die Bestätigung der abgeschlossenen Zahlung.

10. Das The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro benachrichtigt die in der ursprünglichen Anfrage übermittelte urls.notify mit der payId im Benachrichtigungstext.

11. Ihr Server führt einen Aufruf Zahlungsdetails per Payment ID abrufenZahlungsdetails per Payment ID abrufen mit der payId aus, um den responseCode der Zahlung abzurufen.

12. Das The page Wording 1 was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro antwortet mit dem responseCode der Zahlung zusammen mit weiteren Parametern.

13. 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.