Lynck-Backoffice einrichten

Verwenden Sie diese Anleitung, um Lynck (CrefoPay) mit KORONA Event zu verbinden und die URLs zu konfigurieren, über die Kunden zu Ihrem Shop zurückgeleitet werden und Zahlungsaktualisierungen übermittelt werden. Sie müssen die Einstellungen sowohl in KORONA Event als auch im Lynck-Händlerportal speichern.

Bevor Sie beginnen

• Sie verfügen über Administratorrechte für die Zahlungseinstellungen in KORONA Event sowie Zugriff auf den entsprechenden Shop in Lynck.
• Entscheiden Sie, ob Sie Test- oder Live-Zahlungen einrichten möchten. Verwenden Sie die Lynck-Sandbox für Testzugangsdaten und Ihr Lynck-Produktionskonto für Live-Zugangsdaten.
• Halten Sie die HTTPS-Adresse Ihres Online-Shops und die kontospezifische API-Adresse aus den Zahlungseinstellungen von KORONA Event bereit.
• Bitte klären Sie mit Lynck, welche Zahlungsmethoden für Ihren Shop zugelassen sind.

1. Zugangsdaten hinterlegen

1. Öffnen Sie in Lynck Einstellungen → Shop Informationen → API Zugangsdaten. Vergewissern Sie sich, dass Sie den gewünschten Shop ausgewählt haben.
2. Öffnen Sie in KORONA Event den Menüpunkt Verwaltung → Zahlungen → Lynck (CrefoPay).
3. Geben Sie die entsprechenden Zugangsdaten unter Test-Zugangsdaten oder Live-Zugangsdaten ein:

Der private Schlüssel ist geheim. Kopieren Sie ihn ausschließlich in das entsprechende Feld in KORONA Event für Anmeldedaten; geben Sie ihn nicht in Screenshots oder Support-Nachrichten weiter. Ihr Passwort für den Zugang zum Händlerportal ist nicht der private Schlüssel.

1. Speichern Sie die Einstellungen für KORONA Event. Lassen Sie den Live-Modus deaktiviert, solange Sie Anmeldedaten aus der Sandbox verwenden.

Google Pay benötigt außerdem die Google Pay Console-Händler-ID in KORONA Event. Hierbei handelt es sich um eine andere Kennung als die Lynck-Händler-ID. Die Verfügbarkeit der Wallet hängt zudem von der Genehmigung durch den Anbieter, der Domain-Einrichtung und dem Gerät des Kunden ab. Weitere Informationen finden Sie in der Referenz zu Zahlungsmethoden in der Übersicht zur Zahlungskonfiguration.

2. Konfigurieren Sie die Shop-URLs

Suchen Sie in KORONA Event auf der Seite „Lynck-Zahlungseinstellungen“ den Eintrag Lynck Backoffice-Konfiguration. Öffnen Sie im Lynck-Portal Einstellungen → Shop Konfiguration → URL und wählen Sie unter URL-Konfiguration die Option Ändern aus.

KORONA Event verwendet SecureFields in seinem eigenen Checkout-Prozess. Für diese Konfiguration müssen Sie keine von Lynck gehostete Seite einrichten. Das separate Amazon Pay-Feld entspricht nicht der allgemeinen Bestätigungs-URL.

Vorlagen für Rückleitungs-URLs

In diesen Vorlagen werden die zu kopierenden Werte erläutert. Ersetzen Sie YOUR-API-DOMAIN durch den kontospezifischen API-Hostnamen aus Ihren KORONA Event-Einstellungen. Verwenden Sie an dieser Stelle nicht den Hostnamen Ihres Shops oder Ihres Backoffice.

Erfolgs-URL:

https://YOUR-API-DOMAIN/payments/lynck/success?orderID=-ORDERID-&mac=-MAC-

Fehler-URL:

https://YOUR-API-DOMAIN/payments/lynck/failure?orderID=-ORDERID-&resultCode=-RESULTCODE-&merchantReference=-MERCHANTREF-&recoverable=-RECOVERABLE-&mac=-MAC-

Behalten Sie die Namen der Abfrageparameter, Großbuchstaben, Bindestriche und Platzhalter genau so bei, wie sie angegeben sind. Lynck füllt diese bei der Rückleitung des Kunden automatisch aus. Ersetzen Sie diese nicht durch eine tatsächliche Vorgangsnummer, einen Schlüssel oder einen manuell berechneten Wert.

merchantReference identifiziert den Zahlungsversuch, damit ein Kunde nach einer weiteren fehlgeschlagenen Authentifizierung sicher erneut bezahlen kann. recoverable übermittelt die Angabe von Lynck, ob ein erneuter Versuch möglich ist. mac authentifiziert den Callback. Alle drei müssen in der Fehlervorlage verbleiben.

Verwenden Sie für die Amazon Pay-Bestätigungs-URL den Wert, den Sie aus KORONA Event kopiert haben. Die Struktur lautet wie folgt:

https://YOUR-SHOP-DOMAIN/de/accelerated/lynck/amazon-return?orderID=-ORDERID-&sessionID=-PAYMENTREFERENCE-&paymentMethod=-PAYMENTMETHOD-

Hier steht YOUR-SHOP-DOMAIN für den Online-Shop und de für eine Beispielsprache des Shops. Behalten Sie das Sprachsegment in der URL bei, das durch Ihre KORONA Event-Einstellungen vorgegeben wird.

Wählen Sie in Lynck nach der Eingabe Ihrer Werte die Option Speichern aus.

3. Statusbenachrichtigungen konfigurieren

Mithilfe von Statusbenachrichtigungen kann Lynck Zahlungsaktualisierungen auch dann versenden, wenn der Kunde den Browser schließt. Die oben genannten Rückleitungs-URLs ersetzen diese Konfiguration nicht.

Suchen Sie unter Einstellungen → Shop Konfiguration → URL den Eintrag Systembenachrichtigungen. Falls für Ihr KORONA Event-Konto bereits ein Benachrichtigungsziel vorhanden ist, öffnen Sie dieses und aktualisieren Sie den Eintrag. Andernfalls wählen Sie Hinzufügen. Vermeiden Sie es, doppelte Ziele für dasselbe Konto und dieselbe Umgebung anzulegen.

https://YOUR-API-DOMAIN/payments/lynck/notify

Verwenden Sie den API-Hostnamen Ihres Kontos. Fügen Sie dieser URL keine vom Browser zurückgegebenen Abfrageparameter hinzu. Die Authentifizierung erfolgt über den MAC von Lynck; geben Sie Ihre Lynck-Anmeldedaten nicht in die Felder Benutzername oder Passwort ein.

Wählen Sie Speichern. Das Benachrichtigungsziel sollte in der Liste als Aktiv angezeigt werden.

4. Ihre Domain für Apple Pay einrichten

Wenn Sie Apple Pay anbieten, richten Sie die Domain ein, auf der Ihre Kunden tatsächlich bezahlen. Die API-Domain für Rückmeldungen ist nicht die Shop-Domain für Apple Pay.

Standard-Shop-Domain von KORONA Event

Wählen Sie in den Domain-Einstellungen des Backoffice für die Standard-Shop-Domain im Dropdown Apple Pay-Datei die Option Lynck. KORONA Event stellt damit die mitgelieferte Lynck-Domain-Zuordnungsdatei bereit. Sie müssen diese Datei nicht selbst herunterladen und hochladen.

Die Auswahl Lynck stellt die Verifizierungsdatei bereit; sie registriert die Domain nicht bei Lynck. Führen Sie diese Prüfungen auch für die Standard-Domain durch:

1. Öffnen Sie https://YOUR-SHOP-DOMAIN/.well-known/apple-developer-merchantid-domain-association. Ersetzen Sie den Platzhalter durch den Hostnamen Ihrer Standard-Shop-Domain und prüfen Sie, ob die Datei erreichbar ist.
2. Öffnen Sie im Lynck-Händlerbereich Settings → Apple Pay → Web, Hosted Pages & Subscriptions und prüfen Sie, ob der genaue Shop-Hostname für das vorgesehene Konto registriert ist.
3. Falls er noch nicht registriert ist, geben Sie den Hostnamen ein und wählen Sie Register. Prüfen Sie vor dem Apple Pay-Test, ob die Registrierung erfolgreich war.

Eigene Shop-Domain

1. Starten Sie im Lynck-Händlerbereich die Apple Pay-Domain-Registrierung für den genauen Hostnamen Ihrer eigenen Shop-Domain. Verwenden Sie das vorgesehene Sandbox- oder Live-Konto.
2. Laden Sie die von Lynck für diese Einrichtung bereitgestellte Domain-Zuordnungsdatei herunter.
3. Öffnen Sie im KORONA Event-Backoffice die Einstellungen derselben Domain. Wählen Sie als Quelle der Apple Pay-Datei die Option Benutzerdefinierter Upload und laden Sie die heruntergeladene Datei hoch. Speichern Sie die Datei, ohne ihren Inhalt zu bearbeiten.
4. Prüfen Sie, ob die Datei unter https://YOUR-SHOP-DOMAIN/.well-known/apple-developer-merchantid-domain-association öffentlich erreichbar ist. Ersetzen Sie den Domain-Platzhalter durch den Hostnamen Ihres Shops.
5. Schließen Sie die Registrierung oder Verifizierung bei Lynck ab. Prüfen Sie vor dem Apple Pay-Test, ob die Domain erfolgreich registriert wurde.

Das Hochladen der Datei und der Abschluss der Registrierung bei Lynck sind getrennte Schritte. Wiederholen Sie die Domain-Einrichtung bei einem Wechsel des Hostnamens. Kopieren Sie keine Datei eines anderen Shops.

Im Beta-Backoffice finden Sie die Domain-Verifizierung unter Administration → Zahlungen → Einrichtung der Wallet-Domains. Einzelheiten zum Datei-Upload stehen unter Fehlerbehebung bei Wallet-Zahlungen. Falls die benötigte Upload-Funktion nicht verfügbar ist, wenden Sie sich an den KORONA Event-Support, um die Einrichtung Ihrer eigenen Domain abzuschließen.

5. Zahlungen für den Start vorbereiten

Überprüfen Sie die zugelassenen Zahlungsmethoden unter Lyncks Einstellungen → Zahlungsmethoden Konfiguration und aktivieren Sie anschließend die gewünschten Online-Zahlungsmethoden in KORONA Event. Passen Sie die automatische Erfassung an Ihren vereinbarten Zahlungsprozess an; ändern Sie das Erfassungsverhalten nicht nur, um die URL-Einrichtung abzuschließen.

Nutzen Sie Ihren Testshop und die Lynck-Sandbox, bevor Sie auf Live-Zahlungen umstellen. Führen Sie eine erfolgreiche Testzahlung sowie eine abgebrochene Authentifizierung mit anschließendem erneuten Versuch durch. Befolgen Sie die Anleitung Überprüfen Sie den Checkout-Prozess vor dem Start für die umfassende Vorbereitung des Checkout-Prozesses.

Wählen Sie für die Inbetriebnahme den entsprechenden Produktionsshop in Lynck aus, konfigurieren Sie dessen URLs und Benachrichtigungsziel und speichern Sie die entsprechenden Live-Zugangsdaten in KORONA Event. Aktivieren Sie den Live-Modus erst, wenn die Live-Einrichtung und die Genehmigung durch den Anbieter abgeschlossen sind. Durch das Speichern der Sandbox-Einstellungen wird Ihr Produktionsshop nicht konfiguriert.

Falls die Einrichtung nicht funktioniert

Sollte die Konfiguration abgeschlossen sein, die Zahlungen jedoch weiterhin nicht funktionieren, wenden Sie sich bitte an den KORONA Event-Support. Lösen Sie eine Zahlung, deren Ergebnis noch aussteht, nicht wiederholt aus.

Verwandte Artikel

• Übersicht über die Zahlungskonfiguration
• Überprüfen Sie den Bezahlvorgang vor der Einführung für Kunden
• Zahlungslink versenden oder kopieren