ePay als Zahlungsgateway einrichten

ePay ist eines der von Shoporama unterstützten Zahlungsgateways. Mit ePay können Sie Kartenzahlungen, MobilePay Online, Klarna, Forbrugsforeningen und eine breite Palette anderer Zahlungsmethoden akzeptieren. Hier finden Sie eine vollständige Anleitung zur Einrichtung.

Schritt 1: Gateway in Shoporama erstellen

1. Loggen Sie sich in Ihr Shoporama-Administrationspanel ein
2. Gehen Sie zu Shop " Integrationen " Payment gateways
3. Klicken Sie auf Neues Zahlungsgateway erstellen
4. Wählen Sie ePay
5. Geben Sie dem Gateway einen beschreibenden Namen, z.B. Credit card
6. Klicken Sie auf Speichern

Schritt 2: Füllen Sie die Händler-ID aus

Geben Sie im Feld Händler-ID Ihre Händler-ID von ePay ein. Sie finden sie im ePay-Administrationspanel oben rechts oder unter Einstellungen " Zahlungssystem. Es handelt sich in der Regel um eine 7-stellige Nummer.

Schritt 3: Geben Sie das Geheimnis ein (MD5-Geheimnis)

Das Feld Secret ist ein MD5-Geheimnis, das ePay zum Signieren von Rückrufen verwendet. Es stellt sicher, dass Shoporama verifizieren kann, dass eine Zahlungsnachricht tatsächlich von ePay und nicht von einer externen Partei stammt.

Sie finden es im ePay-Admin unter Einstellungen " Zahlungssystem " MD5-Stempel/Schlüssel. Sie wählen aus, welche Zeichenfolge Sie verwenden möchten. Wichtig ist, dass Sie in ePay und in Shoporama genau denselben Wert eingeben.

Schritt 4: Passwort (für die Erfassung)

Wenn Sie möchten, dass Shoporama automatisch Zahlungen einzieht, wenn eine Bestellung abgeschickt wird, müssen Sie das Feld Passwort (für die Erfassung) ausfüllen.

Dies ist ein sogenanntes Remote-Passwort, das Sie im ePay-Admin unter Einstellungen " Zahlungssystem " Remote-Passwort finden. Es wird verwendet, um die API-Aufrufe von Shoporama zu autorisieren, wenn eine Zahlung belastet oder rückerstattet werden soll.

Schritt 5: Fügen Sie Ihre Domain in ePay hinzu

ePay erfordert, dass Sie die Domains, die das Zahlungsfenster nutzen können, auf eine Whitelist setzen. Wenn Ihre Domain nicht zugelassen ist, erhalten Sie die Fehlermeldung "The referring domain is not allowed".

1. Loggen Sie sich in das ePay-Administrationspanel ein
2. Gehen Sie zu Einstellungen " Zahlungssystem
3. Suchen Sie das Feld mit den erlaubten Domains
4. Fügen Sie Ihre Domain hinzu (z.B. www.dinshop.dk)
5. Fügen Sie auch dinshop.shoporama.dk hinzu, wenn Sie noch die Shoporama-Subdomain verwenden.

Schritt 6: Automatische Erfassung (optional)

Wenn Sie möchten, dass das Geld automatisch eingezogen wird, wenn die Bestellung versandt oder abgeholt wird, können Sie "Geld automatisch einziehen, wenn der Artikel versandt oder abgeholt wird" ankreuzen. Dies setzt voraus, dass Sie das Passwort (für die Erfassung) eingegeben haben.

Der Betrag wird sofort auf der Karte des Kunden reserviert, aber erst abgebucht, wenn Sie die Bestellung als versandt oder abgeholt markieren. Diese Vorgehensweise wird für physische Waren empfohlen, da es nach dänischem Recht nicht zulässig ist, das Geld abzuheben, bevor die Waren versandt worden sind. Lesen Sie mehr in unserem Leitfaden zur Abbuchung von Zahlungen für Bestellungen.

Schritt 7: Speichern und testen

Klicken Sie in Shoporama auf Speichern. Testen Sie dann, ob die Zahlung funktioniert, indem Sie eine Testbestellung in Ihrem Online-Shop erstellen.

Um das echte Zahlungsfenster zu sehen, muss Ihr Shop auf Live geschaltet sein. Im Demo-Modus wird stattdessen ein vereinfachter Bildschirm angezeigt. Weitere Informationen finden Sie in den FAQ unten.

Erweiterte Einstellungen

Das ePay-Gateway verfügt über eine Reihe von erweiterten Einstellungen, die in den meisten Fällen nicht geändert werden müssen:

• Windowstate: steuert, wie das Zahlungsfenster angezeigt wird (1 = gleiches Fenster, 3 = Overlay, 4 = ganze Seite, empfohlen)
• Fenster-ID: ID für ein individuelles, in ePay erstelltes Zahlungsfensterdesign
• Gruppe: gruppiert Transaktionen unter einem gemeinsamen Namen in ePay
• Sprache: 1 = Dänisch, 2 = Englisch, 3 = Schwedisch
• Kartentyp: Beschränkung auf einen bestimmten Kartentyp (z.B. nur Dankort oder MobilePay Online). Leer lassen, um alle aktivierten Kartentypen zuzulassen
• Zahlungsgruppe: Filtern Sie die Zahlungsarten nach Kategorie (Karte, Geschenkkarte, Online-Banking, Rechnung, Handy usw.)
• Rechnungsdaten hinzufügen: Senden Sie Auftragszeilen und Kundendaten mit der Zahlung. Erforderlich bei Verwendung von Klarna
• CSS-URL: URL zu externem Stylesheet, das das Aussehen des Zahlungsfensters anpasst
• Google Tracker: Google Analytics Tracking-ID zur Verfolgung des Zahlungsflusses

Häufig gestellte Fragen

Welche Felder muss ich mindestens ausfüllen?

Als Minimum müssen Sie die Händler-ID und das Geheimnis ausfüllen. Wenn Sie Zahlungen automatisch einziehen und zurückerstatten möchten, müssen Sie auch das Passwort (für die Erfassung) ausfüllen. Die anderen Felder können leer bleiben und werden mit Standardwerten belegt.

Wo finde ich das MD5 Geheimnis in ePay?

Loggen Sie sich in den ePay-Admin ein und gehen Sie zu Einstellungen " Zahlungssystem. Hier finden Sie das Feld "MD5-Stempel/Schlüssel" (oder einfach "MD5-Schlüssel"). Sie können wählen, welche Zeichenfolge Sie verwenden möchten. Wichtig ist, dass Sie in ePay und Shoporama genau den gleichen Wert einstellen.

Kann ich MobilePay und Klarna über ePay anbieten?

Ja. ePay unterstützt MobilePay Online (Zahlungsart 29), Klarna (Zahlungsart 17), ViaBill und eine breite Palette anderer Methoden. Diese müssen zunächst in Ihrem ePay-Vertrag freigeschaltet werden. Bei der Verwendung von Klarna müssen Sie außerdem die Option Rechnungsdaten hinzufügen aktivieren, damit die Bestellzeilen mitgesendet werden.

Kann ich den Verbraucherverband über ePay akzeptieren?

Ja, das können Sie. Die Verbraucherzentrale wird als Kartentyp 11 in Ihrem ePay-Gateway aktiviert. Wenn Sie sowohl Karten als auch die Consumers' Union anbieten möchten, können Sie in Shoporama zwei ePay-Gateways mit denselben Schlüsseln, aber unterschiedlichen Kartentypen erstellen. Lesen Sie den vollständigen Leitfaden zur Verbraucherzentrale als Zahlungsmethode.

Wie erstatte ich eine Bestellung?

Wenn Sie das Passwort eingegeben haben (für die Erfassung), können Sie eine Zahlung direkt aus der Bestellansicht in Shoporama über eine Gutschrift erstatten. Lesen Sie unseren Leitfaden für Gutschriften und Rückerstattungen. Wenn Ihnen das Remote-Passwort fehlt, muss die Rückerstattung manuell in ePay-admin vorgenommen werden.

Warum sehe ich das Zahlungsfenster nicht?

Dafür kann es mehrere Gründe geben:

• Der Shop befindet sich im Demo-Modus. Das Zahlungsfenster erscheint nur, wenn der Shop auf live geschaltet ist. Im Demomodus sehen Sie stattdessen den Text "Pretend to pay".
• Fehlendes SSL. Das Checkout-Fenster erfordert, dass Ihr Shop über HTTPS läuft. Shoporama erstellt automatisch ein SSL-Zertifikat, wenn Ihre Domain korrekt eingerichtet ist.
• Falsche Händler-ID. Überprüfen Sie, ob Sie die richtige Händler-ID von ePay eingegeben haben.

Ich erhalte die Fehlermeldung "The referring domain is not allowed".

Dieser Fehler bedeutet, dass die von Ihnen verwendete Domain in der ePay-Verwaltung nicht zugelassen ist. Loggen Sie sich bei ePay ein und fügen Sie Ihre Domain unter Einstellungen " Zahlungssystem hinzu. Denken Sie daran, sowohl Ihre eigene Domain (z.B. www.dinshop.dk) als auch eventuell Ihre Shoporama-Subdomain (z.B. dinshop.shoporama.dk) hinzuzufügen.

Kann ich die Zahlung mit einer Testkarte testen?

ePay stellt Ihnen Test-Händlernummern und Test-Karten zur Verfügung, mit denen Sie den Zahlungsablauf testen können. Bitte beachten Sie jedoch, dass das Zahlungsfenster nur erscheint, wenn der Shop auf "live" gestellt ist, nicht im Demo-Modus.

Alternativ können Sie einen Testeinkauf mit einer echten Karte für ein günstiges Produkt tätigen und dann die Zahlung in der ePay-Verwaltung erstatten.

Was ist der Unterschied zwischen Demomodus und Live-Modus?

Im Demomodus simuliert Shoporama die Zahlung, so dass Sie den Rest des Checkout-Flows (Warenkorb, Lieferdetails, Bestellbestätigung) testen können, ohne ePay einzubeziehen. Im Live-Modus wird der Kunde zum echten ePay-Zahlungsfenster weitergeleitet, um mit Karte, MobilePay oder anderen Zahlungsmethoden zu bezahlen.

Ist es ePay, Bambora oder Worldline?

ePay wurde ursprünglich von Bambora übernommen, das später Teil von Worldline wurde. Seit Dezember 2024 ist ePay wieder ein eigenständiges Unternehmen. Der korrekte Name ist einfach ePay.

Bekomme ich das Geld direkt auf mein Konto?

Nein. ePay ist ein Payment-Gateway, kein Acquirer. Das Geld wird von Ihrem Acquirer (z.B. Nets, Clearhaus, Teller) zu einem vereinbarten Abrechnungsrhythmus auf Ihr Geschäftskonto überwiesen. ePay sendet lediglich die Kartendaten sicher an den Acquirer. Lesen Sie mehr darüber, wann Sie Ihr Geld ausbezahlt bekommen.