So integrieren Sie BridgerPay

Erfahren Sie, wie Sie BridgerPay für Einzahlungen in B2CORE integrieren, einschließlich der Einrichtung von Verbindungen, dem Hinzufügen von Methoden, dem Testen von Konfigurationen sowie der Konfiguration von Webhooks und Weiterleitungs-URLs für nahtlose Transaktionen

BridgerPay kann über PSS mit B2CORE verbunden werden und unterstützt ausschließlich Einzahlungen.

Befolgen Sie die nachstehenden Anweisungen, um die BridgerPay-Verbindung zu konfigurieren und die Einzahlungsmethode im B2CORE Back Office einzurichten. Diese Anweisungen entsprechen dem allgemeinen Verfahren zum Hinzufügen von Methoden für von PSS unterstützte Zahlungssysteme, enthalten jedoch BridgerPay-spezifische Details.

Bevor Sie mit den Anweisungen fortfahren, müssen Sie bei BridgerPay registriert sein und über ein aktives Konto verfügen.

Einen Zahlungslink in Ihrem BridgerPay-Konto erstellen

Um einen Zahlungslink in BridgerPay zu erstellen, müssen Sie einen Checkout vom Typ Zahlungslink erstellen:

Melden Sie sich bei Ihrem BridgerPay-Konto an.

Navigieren Sie im Hauptmenü zu Checkouts.

Klicken Sie auf das Symbol plus, um einen neuen Checkout hinzuzufügen, und füllen Sie anschließend die folgenden Felder aus:

Geben Sie im Feld Title einen Titel für den Checkout ein.
Wählen Sie in der Dropdown-Liste Type die Option Payment link aus.

Klicken Sie auf Create.

Nachdem der Checkout vom Typ Zahlungslink erfolgreich erstellt wurde, werden die erforderlichen Zugangsdaten zur Konfiguration der Einzahlungsmethode im B2CORE Back Office verfügbar.

Eine Verbindung zu BridgerPay konfigurieren

So konfigurieren Sie eine Verbindung zu BridgerPay für Einzahlungen:

Navigieren Sie im B2CORE Back Office zu System > External connections.

Klicken Sie in der oberen rechten Seitenecke auf +Create.

Füllen Sie auf der Seite Create connection die folgenden Felder aus:

Geben Sie im Feld Name einen Namen für die Verbindung ein. Der Name muss eindeutig sein und darf nur lateinische Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten (z. B. Deposits_BridgerPay).
Geben Sie im Feld Caption eine Bezeichnung ein, die für die Verbindung im Back Office verwendet wird.
Wählen Sie in der Dropdown-Liste Provider die Option PaymentSystemDeposit aus.

Wählen Sie in der daraufhin angezeigten Dropdown-Liste Driver die Option BridgerPay aus.

Konfigurieren Sie im daraufhin angezeigten Abschnitt Credentials die BridgerPay-spezifischen Einstellungen:

Geben Sie im Feld API base URL https://api.bridgerpay.com an.
Geben Sie in den Feldern API user name und API password Ihre Zugangsdaten für den Zugriff auf die BridgerPay-API ein.
Geben Sie im Feld API key den API-Schlüssel ein, der in Ihrem BridgerPay-Konto generiert wurde.

Klicken Sie auf Save, um die Verbindung zu erstellen.

Die Verbindung BridgerPay wird in der Liste der externen Verbindungen angezeigt.

Überprüfen Sie den Verbindungsstatus.

Falls die Verbindung inaktiv ist (No wird in der Spalte Enabled angezeigt), klicken Sie auf die Schaltfläche Edit, um die Verbindungsdetails zu öffnen, und setzen Sie die Dropdown-Liste Enabled auf Yes.

Klicken Sie auf Save, um die Änderungen zu übernehmen.

Eine Einzahlungsmethode über BridgerPay hinzufügen

So fügen Sie eine Methode für Einzahlungen über BridgerPay hinzu und richten sie ein:

Navigieren Sie im B2CORE Back Office zu System > Deposit system > Deposit methods.

Klicken Sie in der oberen rechten Seitenecke auf +Create.

Füllen Sie auf der Seite Create a deposit method die folgenden Felder aus:

Geben Sie im Feld Name einen Namen für die Methode ein. Der Name muss eindeutig sein und darf nur lateinische Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten.
Geben Sie im Feld Caption eine Bezeichnung für die Methode ein. Diese Bezeichnung wird der Methode im Back Office zugewiesen und ist für Kunden in der B2CORE UI sichtbar.
Wählen Sie in der Dropdown-Liste Provider die Option PaymentSystemDeposit aus.

Nach der Auswahl von PaymentSystemDeposit werden die folgenden Felder angezeigt:

Wählen Sie in der Dropdown-Liste Available account currencies eine oder mehrere Währungen aus. Einzahlungen über BridgerPay sind für Konten verfügbar, die auf die ausgewählten Währungen lauten.
Wählen Sie in der Dropdown-Liste Driver die Option BridgerPay aus.
Wählen Sie in der Dropdown-Liste Connection die zuvor konfigurierte BridgerPay-Verbindung aus.

Vervollständigen Sie im daraufhin angezeigten Abschnitt Configuration die folgende Einstellung:

Geben Sie im Feld Cashier key die von BridgerPay bereitgestellte eindeutige Kennung an.

Klicken Sie auf Save, um die Einzahlungsmethode zu erstellen.

Die Einzahlungsmethode BridgerPay wird in der Liste der Einzahlungsmethoden angezeigt.

Klicken Sie auf Edit, um die Methodendetails aufzurufen, und vervollständigen Sie die folgenden Felder:

Verwenden Sie auf der Registerkarte Settings die Dropdown-Liste Group, um eine oder mehrere Gruppen auszuwählen, in denen die Methode enthalten sein soll.
Geben Sie im Feld Icon paymethod-bridgerpay an, um das vordefinierte Symbol für die BridgerPay-Einzahlungsmethode in der B2CORE UI anzuzeigen. Um ein benutzerdefiniertes Symbol zu verwenden, geben Sie die URL des anzuzeigenden Bildes an.
Überprüfen Sie den Methodenstatus.

Falls die Methode inaktiv ist (No wird im Feld Enabled angezeigt), aktivieren Sie sie, indem Sie die Dropdown-Liste Enabled auf Yes setzen.
Fügen Sie auf der Registerkarte PS Currencies die erforderlichen Währungen hinzu. Um die Methode für die Verarbeitung von Einzahlungen in einer bestimmten Währung zu aktivieren, stellen Sie sicher, dass diese Währung auf dieser Registerkarte hinzugefügt wurde (eine Beschreibung der Registerkarte finden Sie unter Deposit methods).
Konfigurieren Sie bei Bedarf auf der Registerkarte Commissions Gebühren für die Methode (Details finden Sie unter So konfigurieren Sie Provisionen für Ein- und Auszahlungsmethoden).

BridgerPay deposit method — Settings tab

Klicken Sie auf Test configuration, um die Verbindungseinstellungen der Einzahlungsmethode zu überprüfen. Der Test wird anhand der im Methodenformular angegebenen Einstellungen und der Daten durchgeführt, die in der ausgewählten externen Verbindung bereitgestellt werden.

Das Testergebnis wird auf der Seite angezeigt.

Klicken Sie nach erfolgreicher Überprüfung der Konfiguration auf Save.

Die Einzahlungsmethode BridgerPay ist nun im B2CORE Back Office konfiguriert.

Webhooks in Ihrem BridgerPay-Konto einrichten

Um Statusaktualisierungen für initiierte Einzahlungen in B2CORE zu erhalten, müssen Sie in BridgerPay Benachrichtigungs-Webhooks für PSPs einrichten.

Die Webhook-URL aus dem B2CORE Back Office kopieren

Navigieren Sie im B2CORE Back Office zu System > Deposit system > Deposit methods.

Suchen Sie die konfigurierte Einzahlungsmethode BridgerPay und klicken Sie auf Edit, um die Methodendetails aufzurufen.

Wechseln Sie zur Registerkarte Webhooks.

Kopieren Sie die im Feld Notification URL angezeigte URL.

BridgerPay deposit method — Webhooks tab

Die Webhook-URL zu PSPs in BridgerPay hinzufügen

Melden Sie sich bei Ihrem BridgerPay-Konto an.

Navigieren Sie im Hauptmenü zu Checkouts.

Wählen Sie den hinzugefügten PSP aus und klicken Sie darauf, um seine Details zu öffnen.

Klicken Sie in den Details auf Settings.

Wechseln Sie zur Registerkarte URLs.

Fügen Sie die aus dem B2CORE Back Office kopierte Webhook-URL in das Feld Webhook Notification URL ein.

Add the webhook URL to a PSP in BridgerPay

Speichern Sie Ihre Änderungen.

Wiederholen Sie diese Schritte für jeden PSP, der in Ihrem BridgerPay-Konto hinzugefügt und konfiguriert wurde.

Weiterleitungs-URLs für PSPs in BridgerPay angeben

Um eine ordnungsgemäße Weiterleitung sicherzustellen, nachdem eine Einzahlung abgeschlossen, fehlgeschlagen oder abgebrochen wurde, richten Sie die entsprechenden Weiterleitungs-URLs für PSPs in BridgerPay ein.

So richten Sie Weiterleitungs-URLs ein:

Navigieren Sie in Ihrem BridgerPay-Konto im Hauptmenü zu Checkouts.

Wählen Sie den hinzugefügten PSP aus und klicken Sie darauf, um seine Details zu öffnen.

Klicken Sie in den Details auf Settings.

Wechseln Sie zur Registerkarte URLs.

Geben Sie die folgenden URLs an:

Geben Sie bei Success Redirect URL https://{your-Front-Office-URL}/en/payment/success an.
Geben Sie in den Feldern Failure Redirect URL und Cancel Redirect URL https://{your-Front-Office-URL}/en/payment/failed an.

Stellen Sie sicher, dass Sie {your-Front-Office-URL} durch die Domain Ihrer B2CORE UI ersetzen.

Add redirect URLs for a PSP in BridgerPay

Speichern Sie Ihre Änderungen.

Wiederholen Sie diese Schritte für jeden PSP, der in Ihrem BridgerPay-Konto hinzugefügt und konfiguriert wurde.

Die Option „Notify with original amount“ für PSPs in BridgerPay aktivieren

Die Option Notify with original amount für PSPs in BridgerPay stellt sicher, dass Zahlungsbenachrichtigungen die ursprünglichen Einzahlungsbeträge ohne Änderungen oder zusätzliche Gebühren enthalten.

So aktivieren Sie diese Option:

Navigieren Sie in Ihrem BridgerPay-Konto im Hauptmenü zu Checkouts.

Wählen Sie den hinzugefügten PSP aus und klicken Sie darauf, um seine Details zu öffnen.

Klicken Sie in den Details auf Settings.

Aktivieren Sie im Abschnitt PSP Specific Settings die Option Notify with original amount.

Speichern Sie Ihre Änderungen.

Wiederholen Sie diese Schritte für jeden PSP, der in Ihrem BridgerPay-Konto hinzugefügt und konfiguriert wurde.

Die Einzahlungsmethode BridgerPay ist nun vollständig konfiguriert und für Kunden verfügbar, die Einzahlungen in der B2CORE UI vornehmen.

So integrieren Sie BridgerPay

Auf dieser Seite