Revolut Gateway

Installation

Das Plugin kann einfach über den Shopware Plugin Manager unter Erweiterungen -> Meine Erweiterungen installiert werden.

Wie man beginnt

Um Zahlungen zu akzeptieren, müssen Sie vier einfache Schritte befolgen:

• Melden Sie sich bei Revolut Business an, wenn Sie noch kein Konto haben: https://business.revolut.com/signup
• Sobald Ihr Revolut Business-Konto genehmigt wurde, beantragen Sie ein Händlerkonto:  https://business.revolut.com/merchant
• Holen Sie sich Ihren Secret Key für die Production API und fügen Sie ihn in den Abschnitt „Production Merchant API“ ein: https://business.revolut.com/settings/merchant-api - Wenn Sie diese Seite zum ersten Mal besuchen, müssen Sie auf die Schaltfläche „Generieren“ klicken, um Ihre eindeutigen API-Schlüssel zu erstellen
• Klicken Sie auf die Schaltfläche “Öffentlichen API-Schlüssel abrufen” (oder kopieren Sie ihn von Revolut und fügen Sie ihn in das Feld “API-Public Key” ein).

Wie man testet

Um ein Sandbox-Konto zu erstellen, müssen Sie drei einfache Schritte befolgen:

• Melden Sie sich für ein Revolut Sandbox-Konto an: https://sandbox-business.revolut.com/signup
• Holen Sie sich Ihren Sandbox-API-Geheimschlüssel und fügen Sie ihn im Abschnitt “Sandbox Merchant API” ein: https://sandbox-business.revolut.com/settings/merchant-api - Wenn Sie diese Seite zum ersten Mal besuchen, müssen Sie auf die Schaltfläche „Generieren“ klicken, um Ihre eindeutigen API-Schlüssel zu erstellen
• Klicken Sie auf die Schaltfläche “Öffentlichen API-Schlüssel abrufen” (oder kopieren Sie ihn von Revolut und fügen Sie ihn in das Feld “API-Public Key” ein).

Um Ihre verschiedenen Zahlungsströme für unterschiedliche Szenarien zu testen, können Sie die hier verfügbaren Testkartennummern nutzen: https://developer.revolut.com/docs/guides/accept-payments/get-started/test-in-the-sandbox-environment/test-cards

WICHTIGER HINWEIS! Wenn der Sandbox-Modus aktiviert ist, können Sie nur Testzahlungen über “Revolut Card” oder “Revolut Pay” durchführen. Leider bietet Revolut derzeit keine Möglichkeit, Testzahlungen über “Apple Pay / Google Pay” zu tätigen.

So tätigen Sie eine Rückerstattung

• Gehen Sie zur Plugin-Konfiguration und stellen Sie sicher, dass im Abschnitt „Allgemeine Einstellungen“ die Option „Rückerstattung erlaubt“ aktiviert ist.
  
• Gehen Sie zu den Details der ausgewählten Bestellung, wo Sie im Tab „Allgemein“ den Abschnitt „Revolut-Bestellinformationen“ sehen, wenn die Bestellung mit Revolut bezahlt wurde
  
• Klicken Sie auf die Schaltfläche „Rückerstattungsmanager öffnen“ (bitte beachten Sie, dass Sie eine Rückerstattung für die Revolut-Bestellung nur veranlassen können, wenn sie sich im Status „ABGESCHLOSSEN“ befindet, andernfalls wird diese Schaltfläche nicht angezeigt.)
  
• Geben Sie im Popup-Fenster den Rückerstattungsbetrag ein und füllen Sie ggf. das Beschreibungsfeld aus
  
• Klicken Sie auf die Schaltfläche „Rückerstattung“
  

Konfiguration

Nach der Installation des Plugins werden automatisch 3 neue Zahlungsmethoden hinzugefügt und aktiviert:

• Revolut-Karte
• Revolut Pay
• Revolut Apple Pay / Google Pay

Um die Plugin-Einstellungen anzupassen, klicken Sie auf die Kontextmenü-Schaltfläche, um zu seiner Konfiguration zu gelangen. Nachfolgend finden Sie eine Beschreibung der wichtigsten Funktionen.

• Generelle Einstellungen

  • Rückerstattung zulässig - wenn diese Option aktiviert ist, können Rückerstattungen direkt aus der Bestellung über den Refund Manager vorgenommen werden
  • Sandbox-Modus - verwenden Sie den Test (Sandbox)-Gateway-Server, um Transaktionen zu verarbeiten
  • Erfassungsmodus:
    • Automatisch - die Bestellung wird automatisch nach der Zahlungsberechtigung erfasst 
    • Manuell - die Bestellung wird nicht automatisch erfasst. Sie müssen die Bestellung später manuell erfassen
    • Versandt - wenn der Bestelllieferstatus den Status “Versandt” erreicht, sendet das Plugin eine Anfrage an Revolut, um die Zahlung zu erfassen
  • Cookie-Modus:
    • Revolut-Cookies in der Gruppe "Technisch erforderlich" anzeigen - Nach Auswahl dieser Option ist es möglich, über Revolut zu bezahlen, ohne seine Cookies zu akzeptieren
    • Revolut-Cookies in der neuen Gruppe "Zahlungen" anzeigen - Die Möglichkeit, über Revolut zu bezahlen, wird blockiert, bis der Kunde die Revolut-Cookies akzeptiert
    • Revolut-Cookies nicht anzeigen - Nach Auswahl dieser Option ist es möglich, über Revolut zu bezahlen, ohne seine Cookies zu akzeptieren. Revolut-Cookies werden nicht in "Cookie-Einstellungen" angezeigt. Option nicht empfohlen, wenn Sie einen Shop in einem Land haben, in dem die DSGVO-Verordnungen gelten

• Debug-Modus

  • Aktiv - aktiver Debug-Modus zur Erstellung benutzerdefinierter Protokolle im Shopware-Protokollverzeichnis. Diese Funktion kann hilfreich sein, um Probleme zu lösen
  • Logdateien behalten (in Tagen) -  legen Sie die Anzahl der Tage fest, an denen die Protokolldateien im Shopware-Protokollverzeichnis aufbewahrt werden sollen

• Automatisierung | Bestellstatus → Revolut-Status

  • Automatische Stornierung - aktivieren Sie diese Option, um eine Bestellung automatisch in Revolut zu stornieren. Das bedeutet, dass das Plugin eine Anfrage an Revolut sendet, um eine vorhandene nicht erfasste Bestellung zu stornieren, sobald der Bestellstatus den Status “Storniert” erreicht
  • Automatische Rückerstattung - aktivieren Sie diese Option, um automatisch eine Rückerstattung in Revolut zu veranlassen. Das bedeutet, dass das Plugin eine Anfrage an Revolut sendet, um eine Rückerstattung für eine abgeschlossene Bestellung zu veranlassen, sobald der Bestellstatus den Status “Storniert” erreicht

• Automatisierung | Zahlungsstatus → Revolut-Status

  • Automatische Stornierung - aktivieren Sie diese Option, um eine Bestellung automatisch in Revolut zu stornieren. Das bedeutet, dass das Plugin eine Anfrage an Revolut sendet, um eine vorhandene nicht erfasste Bestellung zu stornieren, sobald der Zahlungsstatus den Status “Storniert” erreicht
  • Automatische Rückerstattung - aktivieren Sie diese Option, um automatisch eine Rückerstattung in Revolut zu veranlassen. Das bedeutet, dass das Plugin eine Anfrage an Revolut sendet, um eine Rückerstattung für eine abgeschlossene Bestellung zu veranlassen, sobald der Zahlungsstatus den Status “Rückerstattung” erreicht

• Automatisierung | Revolut-Status → Bestellstatus

  • Bestellstatus bei einer abgeschlossenen Transaktion - wählen Sie den Bestellstatus aus, der festgelegt wird, sobald der Transaktionsstatus den Status “abgeschlossen” erreicht
  • Bestellstatus bei einer autorisierten Transaktion - wählen Sie den Bestellstatus aus, der festgelegt wird, sobald der Transaktionsstatus den Status “autorisiert” erreicht
  • Bestellstatus bei einer fehlgeschlagenen Transaktion - wählen Sie den Bestellstatus aus, der festgelegt wird, sobald der Transaktionsstatus den Status “fehlgeschlagen” erreicht
    
  • Bestellstatus bei einer stornierten Transaktion - wählen Sie den Bestellstatus aus, der festgelegt wird, sobald der Transaktionsstatus den Status “storniert” erreicht
    
  • Bestellstatus bei einer ausstehenden Transaktion - wählen Sie den Bestellstatus aus, der festgelegt wird, sobald der Transaktionsstatus den Status “ausstehend” erreicht
    
  • Bestellstatus bei einer verarbeiteten Transaktion - wählen Sie den Bestellstatus aus, der festgelegt wird, sobald der Transaktionsstatus den Status “verarbeitet” erreicht
    
  • Bestellstatus bei einer rückerstatteten Transaktion - wählen Sie den Bestellstatus aus, der festgelegt wird, sobald der Transaktionsstatus den Status “rückerstattet” erreicht