B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERSo integrieren Sie KoraPay
Erfahren Sie, wie Sie KoraPay über PSS in B2CORE integrieren, einschließlich der Konfiguration von Verbindungen und dem Hinzufügen von Ein- und Auszahlungsmethoden mit unterstützten Währungen
KoraPay kann über PSS mit B2CORE verbunden werden und unterstützt Einzahlungen, Auszahlungen auf Bankkonten sowie Auszahlungen auf mobile Wallets über Mobile Money.
Befolgen Sie die nachstehenden Anweisungen, um die KoraPay-Verbindung 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 PSS-unterstützte Zahlungssysteme, enthalten jedoch spezifische Details zu KoraPay.
Bevor Sie mit den Anweisungen fortfahren, müssen Sie sich bei KoraPay registriert haben und über ein aktives Konto verfügen. Bei Fragen können Sie die offizielle KoraPay-Dokumentation konsultieren oder den Support kontaktieren.
Unterstützte Währungen
Nachfolgend finden Sie die Tabelle mit den Währungen, die für Ein- und Auszahlungen über KoraPay unterstützt werden:
| Alpha code | Name | Supported for deposits | Supported for withdrawals (bank accounts) | Supported for withdrawals (mobile wallets via mobile money) |
|---|---|---|---|---|
| NGN | Nigerian naira | ✔ | ✔ (to Nigerian bank accounts only) | ✘ |
| GHS | Ghanaian cedi | ✔ | ✔ (to Nigerian bank accounts only) | ✔ |
| KES | Kenyan shilling | ✔ | ✔ (to Nigerian bank accounts only) | ✔ |
| XAF | Central African CFA franc | ✔ | ✘ | ✔ |
| XOF | West African CFA franc | ✔ | ✘ | ✔ |
Für die Währungen XAF und XOF werden Beträge gemäß den Anforderungen von KoraPay auf das nächstniedrigere Vielfache von 5 abgerundet. Wenn ein Kunde beispielsweise 2.573 XAF eingibt, wird der Betrag für die Transaktion auf 2.570 abgerundet.
Verbindungen zu KoraPay konfigurieren
Wenn Sie KoraPay sowohl für Einzahlungen als auch für Auszahlungen verwenden möchten, müssen Sie separate Verbindungen konfigurieren, die jeweils einer bestimmten Ein- oder Auszahlungsmethode zugeordnet sind.
Jede Verbindung muss mit dem entsprechenden Treiber konfiguriert werden, um den korrekten Betrieb der jeweiligen Ein- oder Auszahlungsmethode sicherzustellen.
So konfigurieren Sie eine Verbindung zu KoraPay:
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_KoraPayoderWithdrawals_KoraPay). -
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 angezeigten Dropdown-Liste Driver Folgendes aus:
- KoraPay — für Einzahlungen.
- KoraPay bank account — für Auszahlungen auf Bankkonten.
- KoraPay mobile money — für Auszahlungen auf mobile Wallets über Mobile Money.
Konfigurieren Sie im angezeigten Abschnitt Credentials die KoraPay-spezifischen Einstellungen:
- Geben Sie im Feld API base URL
https://api.korapay.coman. - Geben Sie im Feld Secret key den geheimen Schlüssel aus Ihrem KoraPay-Konto ein.
- Geben Sie im Feld Public key den öffentlichen Schlüssel aus Ihrem KoraPay-Konto ein.
Um Ihren geheimen und öffentlichen Schlüssel zu finden, melden Sie sich bei Ihrem KoraPay-Konto an, navigieren Sie zu Settings und öffnen Sie die Registerkarte API Configuration.
Klicken Sie auf Save, um die Verbindung zu erstellen.
Die Verbindung KoraPay 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 zusätzliche KoraPay-Verbindungen für andere Zahlungsmethoden benötigen, befolgen Sie dieselben Anweisungen, um eine neue Verbindung mit einem anderen Treiber zu erstellen.
Eine Einzahlungsmethode über KoraPay hinzufügen
So fügen Sie eine Methode für Einzahlungen über KoraPay 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 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, die für Einzahlungen unterstützt werden, z. B.
NGN,GHS,KES,XAFundXOF. Einzahlungen über KoraPay sind für Konten verfügbar, die in den ausgewählten Währungen geführt werden. - Wählen Sie in der Dropdown-Liste Driver KoraPay aus.
- Wählen Sie in der Dropdown-Liste Connection die zuvor konfigurierte KoraPay-Verbindung für Einzahlungen aus.
Setzen Sie im Abschnitt Configuration die Option Merchant bears cost auf:
- Yes — der Broker (Händler) zahlt die Transaktionsgebühr.
- No — der Trader (Kunde) zahlt die Transaktionsgebühr.
Klicken Sie auf Save, um die Einzahlungsmethode zu erstellen.
Die Einzahlungsmethode KoraPay wird in der Liste der Einzahlungsmethoden angezeigt.
Klicken Sie auf Edit, um die Methodendetails aufzurufen, und füllen Sie die folgenden Felder aus:
-
Wählen Sie auf der Registerkarte Settings über die Dropdown-Liste Group eine oder mehrere Gruppen aus, denen die Methode hinzugefügt werden soll.
-
Geben Sie im Feld Icon
paymethod-korapayan, um das vordefinierte Symbol für die KoraPay-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ötigten Währungen hinzu. Um die Methode für die Verarbeitung von Einzahlungen in einer bestimmten Währung zu aktivieren, stellen Sie sicher, dass diese auf dieser Registerkarte hinzugefügt wurde.
-
Konfigurieren Sie bei Bedarf auf der Registerkarte Commissions Provisionen für die Methode (Details finden Sie unter So konfigurieren Sie Provisionen für Ein- und Auszahlungsmethoden).
Klicken Sie auf Test configuration, um die Verbindungseinstellungen der Einzahlungsmethode zu validieren.
Das Testergebnis wird auf der Seite angezeigt.
Klicken Sie nach erfolgreicher Validierung der Konfiguration auf Save.
Die Einzahlungsmethode KoraPay ist nun im B2CORE Back Office konfiguriert.
Eine Auszahlungsmethode über KoraPay hinzufügen
So fügen Sie eine Methode für Auszahlungen über KoraPay 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 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 KoraPay sind von Konten verfügbar, die in den ausgewählten Währungen geführt werden.
-
Wählen Sie in der Dropdown-Liste Driver Folgendes aus:
-
KoraPay bank account — für Auszahlungen auf Bankkonten.
Es werden nur Auszahlungen auf nigerianische Bankkonten unterstützt.
-
KoraPay mobile money — für Auszahlungen auf mobile Wallets über Mobile Money.
Auszahlungen werden für kenianische (KES), ghanaische (GHS), ivorische (XOF) und kamerunische (XAF) Mobile-Money-Konten unterstützt.
-
-
Wählen Sie in der Dropdown-Liste Connection die zuvor konfigurierte KoraPay-Verbindung für Auszahlungen aus.
Vervollständigen Sie im Abschnitt Configuration die folgenden Einstellungen:
Für den Treiber KoraPay bank account:
-
Wählen Sie in der Dropdown-Liste Merchant bears cost Folgendes aus:
- Yes — der Broker (Händler) zahlt die Transaktionsgebühr.
- No — der Trader (Kunde) zahlt die Transaktionsgebühr.
Für den Treiber KoraPay mobile money:
- Konfigurieren Sie die Option Merchant bears cost wie oben beschrieben.
- Wählen Sie in der Dropdown-Liste Country das Land aus, in dem diese Auszahlungsmethode verfügbar sein soll, z. B. Kenia, Ghana, Côte d’Ivoire oder Kamerun.
Klicken Sie auf Save, um die Auszahlungsmethode zu erstellen.
Die Auszahlungsmethode KoraPay wird in der Liste der Auszahlungsmethoden angezeigt.
Klicken Sie auf Edit, um die Methodendetails aufzurufen, und füllen Sie die folgenden Felder aus:
-
Wählen Sie auf der Registerkarte Settings über die Dropdown-Liste Group eine oder mehrere Gruppen aus, denen die Methode hinzugefügt werden soll.
-
Geben Sie im Feld Icon
paymethod-korapayan, um das vordefinierte Symbol für die KoraPay-Auszahlungsmethode in der B2CORE UI anzuzeigen. Um ein benutzerdefiniertes Symbol zu verwenden, geben Sie die URL des anzuzeigenden Bildes an.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ötigten Währungen hinzu. Um die Methode für die Verarbeitung von Auszahlungen in einer bestimmten Währung zu aktivieren, stellen Sie sicher, dass diese auf dieser Registerkarte hinzugefügt wurde.
-
Konfigurieren Sie bei Bedarf auf der Registerkarte Commissions Provisionen für die Methode (Details finden Sie unter So konfigurieren Sie Provisionen für Ein- und Auszahlungsmethoden).
Klicken Sie auf Test configuration, um die Verbindungseinstellungen der Auszahlungsmethode zu validieren.
Das Testergebnis wird auf der Seite angezeigt.
Klicken Sie nach erfolgreicher Validierung der Konfiguration auf Save.
Die Auszahlungsmethode KoraPay ist nun im B2CORE Back Office konfiguriert. Um eine weitere Auszahlungsmethode über KoraPay mit einem anderen Treiber hinzuzufügen, befolgen Sie dieselben Anweisungen und wählen Sie den anderen Treiber aus.
Zuletzt aktualisiert am