So integrieren Sie PayRetailers

Erfahren Sie, wie Sie PayRetailers über PSS in B2CORE integrieren, um Ein- und Auszahlungen in unterstützten Währungen zu ermöglichen

PayRetailers kann über PSS mit B2CORE verbunden werden und unterstützt Ein- und Auszahlungen.

Befolgen Sie die nachstehenden Anweisungen, um die PayRetailers-Verbindungen zu konfigurieren und die Ein- und Auszahlungsmethoden 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 spezifische Details zu PayRetailers.

Bevor Sie mit den Anweisungen fortfahren, müssen Sie sich bei PayRetailers registriert haben und über ein aktives Konto verfügen. Bei Fragen können Sie die offizielle PayRetailers-Dokumentation konsultieren oder den Support kontaktieren.

Unterstützte Währungen

Nachstehend finden Sie die Tabelle mit den Währungen, die für Ein- und Auszahlungen über PayRetailers unterstützt werden:

Alpha code Name Supported for deposits Supported for withdrawals
ARS Argentine peso ✔ ✔
BRL Brazilian real ✔ ✔
CLP Chilean peso ✔ ✔
COP Colombian peso ✔ ✔
CRC Costa Rican colon ✔ ✘
USD US dollar ✔ ✔
MXN Mexican peso ✔ ✔
PEN Peruvian sol ✔ ✔
RWF Rwandan franc ✔ ✘
TZS Tanzanian shilling ✔ ✘
KES Kenyan shilling ✔ ✘
NGN Nigerian naira ✔ ✘
ZAR South African rand ✔ ✘

Verbindungen zu PayRetailers konfigurieren

Wenn Sie PayRetailers sowohl für Ein- als auch für Auszahlungen verwenden möchten, müssen Sie zwei separate Verbindungen konfigurieren: eine für Einzahlungen und eine weitere für Auszahlungen.

So konfigurieren Sie eine Verbindung zu PayRetailers:

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

Klicken Sie in der oberen rechten Ecke der Seite 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_PayRetailers oder Withdrawals_PayRetailers).

  • Geben Sie im Feld Caption eine Bezeichnung ein, die im Back Office für die Verbindung verwendet wird.

  • Wählen Sie in der Dropdown-Liste Provider Folgendes aus:

    • PaymentSystemDeposit — um eine Verbindung hinzuzufügen, die für eine Einzahlungsmethode verwendet wird.
    • PaymentSystemWithdrawal — um eine Verbindung hinzuzufügen, die für eine Auszahlungsmethode verwendet wird.

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

Konfigurieren Sie im daraufhin angezeigten Bereich Credentials die PayRetailers-spezifischen Einstellungen:

  • Geben Sie im Feld API base URL Folgendes an:

    • https://api.payretailers.com — für die Produktionsumgebung
    • https://api-sandbox.payretailers.com — für die Sandbox-Testumgebung
  • Geben Sie im Feld Shop ID die von PayRetailers Ihrem Konto zugewiesene Kennung ein.

  • Geben Sie im Feld Secret key den geheimen Schlüssel aus Ihrem PayRetailers-Konto an.

  • Geben Sie im Feld Subscription key den Abonnementschlüssel aus Ihrem PayRetailers-Konto an.

All diese Angaben werden von PayRetailers während des Onboarding-Prozesses bereitgestellt und sind auch im Bereich Shops Ihres PayRetailers-Kontos zu finden.

PayRetailers — Menü „Shops“

Klicken Sie auf Save, um die Verbindung zu erstellen.

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

Überprüfen Sie den Verbindungsstatus.

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

Wenn Sie sowohl Ein- als auch Auszahlungen über PayRetailers unterstützen müssen, befolgen Sie dieselben Anweisungen, um eine neue Verbindung für den jeweils anderen Vorgang zu erstellen.

Eine Einzahlungsmethode über PayRetailers hinzufügen

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

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

Klicken Sie in der oberen rechten Ecke der Seite 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 diese Methode sind für Konten verfügbar, die in den ausgewählten Währungen geführt werden.
  • Wählen Sie in der Dropdown-Liste Driver die Option PayRetailers aus.
  • Wählen Sie in der Dropdown-Liste Connection die zuvor konfigurierte PayRetailers-Verbindung für Einzahlungen aus.

Füllen Sie im daraufhin angezeigten Bereich Configuration die folgenden Felder aus:

  • Wählen Sie in der Dropdown-Liste Channel den Zahlungskanal aus:

    • Online — für Online-Zahlungen
    • Wallet — für Zahlungen über E-Wallets
    • Credit card — für die Finanzierung von Einzahlungen mit Bankkarten
    • Cash — für Barzahlungen über Banken
  • Wählen Sie in der Dropdown-Liste Country das Land aus, in dem die Zahlung verarbeitet wird.

Klicken Sie auf Save, um die Einzahlungsmethode zu erstellen.

Die Einzahlungsmethode PayRetailers 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-payretailers an, um das vordefinierte Symbol für die PayRetailers-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.

    Wenn 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 benötigte Währung hinzu. Um der Methode die Verarbeitung von Einzahlungen in einer bestimmten Währung zu ermöglichen, stellen Sie sicher, dass diese auf dieser Registerkarte hinzugefügt wurde.

Bei PayRetailers-Einzahlungen sind die für die Verarbeitung von Einzahlungen verwendeten Währungen an das im Bereich Configuration der Methode ausgewählte Land gebunden. Ein einzelnes Land kann mehr als eine Einzahlungswährung unterstützen:

  • Argentinien → ARS, USD
  • Brasilien → BRL, USD
  • Chile → CLP, USD
  • Kolumbien → COP, USD
  • Costa Rica → CRC, USD
  • Ecuador → USD
  • El Salvador → USD
  • Mexiko → MXN, USD
  • Panama → USD
  • Peru → PEN, USD
  • Ruanda → RWF, USD
  • Tansania → TZS, USD
  • Kenia → KES, USD
  • Nigeria → NGN, USD
  • Südafrika → ZAR, USD

In Brasilien können Einzahlungen beispielsweise in BRL und USD verarbeitet werden; beide Währungen können auf der Registerkarte PS Currencies hinzugefügt werden.

Zusätzlich kann die Nutzung der Methode in einem bestimmten Land durch die Anwendung von Länderbeschränkungen eingeschränkt werden (weitere Informationen finden Sie unter So beschränken Sie die Nutzung von Ein- und Auszahlungsmethoden).

PayRetailers-Einzahlungsmethode — Registerkarte „Settings“

Klicken Sie auf Test configuration, um die Verbindungseinstellungen der Einzahlungsmethode zu überprüfen.

Das Testergebnis wird auf der Seite angezeigt.

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

Die Einzahlungsmethode PayRetailers ist jetzt im B2CORE Back Office konfiguriert.

Eine Auszahlungsmethode über PayRetailers hinzufügen

So fügen Sie eine Methode für Auszahlungen über PayRetailers hinzu und richten sie ein:

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

Klicken Sie in der oberen rechten Ecke der Seite auf +Create.

Füllen Sie auf der Seite Create a payout 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 PaymentSystemWithdrawal aus.

Nach der Auswahl von PaymentSystemWithdrawal werden die folgenden Felder angezeigt:

  • Wählen Sie in der Dropdown-Liste Available account currencies eine oder mehrere Währungen aus. Auszahlungen über diese Methode sind von Konten verfügbar, die in den ausgewählten Währungen geführt werden.
  • Wählen Sie in der Dropdown-Liste Driver die Option PayRetailers aus.
  • Wählen Sie in der Dropdown-Liste Connection die zuvor konfigurierte PayRetailers-Verbindung für Auszahlungen aus.

Wählen Sie im Bereich Configuration den Zahlungskanal in der Dropdown-Liste Channel aus.

Klicken Sie auf Save, um die Auszahlungsmethode zu erstellen.

Die Auszahlungsmethode PayRetailers wird in der Liste der Auszahlungsmethoden 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-payretailers an, um das vordefinierte Symbol für die PayRetailers-Auszahlungsmethode in der B2CORE UI anzuzeigen. Um ein benutzerdefiniertes Symbol zu verwenden, geben Sie die URL des anzuzeigenden Bildes an.

  • Überprüfen Sie den Methodenstatus.

    Wenn 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 benötigte Währung hinzu. Um der Methode die Verarbeitung von Auszahlungen in einer bestimmten Währung zu ermöglichen, stellen Sie sicher, dass diese auf dieser Registerkarte hinzugefügt wurde.

Bei PayRetailers-Auszahlungen ist jede Währung in einer strikten Eins-zu-eins-Beziehung an ein bestimmtes Land gebunden. Das bedeutet, dass eine Auszahlung in einer bestimmten Währung nur für das entsprechende Land verfügbar ist. Daher müssen Kunden das passende Land auswählen und die erforderlichen Bankdaten für diesen Standort angeben.

Die folgende Zuordnung zeigt, welches Land mit jeder Auszahlungswährung verknüpft ist:

  • Argentinien → ARS
  • Brasilien → BRL
  • Chile → CLP
  • Kolumbien → COP
  • Ecuador → USD
  • Mexiko → MXN
  • Peru → PEN
PayRetailers-Auszahlungsmethode — Registerkarte „Settings“

Klicken Sie auf Test configuration, um die Verbindungseinstellungen der Auszahlungsmethode zu überprüfen.

Das Testergebnis wird auf der Seite angezeigt.

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

Die Auszahlungsmethode PayRetailers ist jetzt im B2CORE Back Office konfiguriert.

Zuletzt aktualisiert am

Auf dieser Seite