Comment intégrer KoraPay

Dans le Back Office B2CORE, accédez à System > External connections.

Cliquez sur +Create dans le coin supérieur droit de la page.

Sur la page Create connection, renseignez les champs suivants :

• Dans le champ Name, saisissez un nom pour la connexion. Le nom doit être unique et ne peut contenir que des lettres latines, des chiffres, des tirets et des traits de soulignement (par exemple, Deposits_KoraPay ou Withdrawals_KoraPay).

• Dans le champ Caption, saisissez un libellé qui sera appliqué à la connexion dans le Back Office.

• Dans la liste déroulante Provider, sélectionnez :

  • PaymentSystemDeposit — pour ajouter une connexion qui sera utilisée pour une méthode de dépôt.
  • PaymentSystemWithdrawal — pour ajouter une connexion qui sera utilisée pour une méthode de retrait.

Dans la liste déroulante Driver qui s'affiche, sélectionnez :

• KoraPay — pour les dépôts.
• KoraPay bank account — pour les retraits vers des comptes bancaires.
• KoraPay mobile money — pour les retraits vers des portefeuilles mobiles via mobile money.

Dans la section Credentials qui s'affiche, configurez les paramètres propres à KoraPay :

• Dans le champ API base URL, indiquez https://api.korapay.com.
• Dans le champ Secret key, saisissez la clé secrète de votre compte KoraPay.
• Dans le champ Public key, saisissez la clé publique de votre compte KoraPay.

Pour trouver vos clés secrète et publique, connectez-vous à votre compte KoraPay, accédez à Settings, puis ouvrez l'onglet API Configuration.

Cliquez sur Save pour créer la connexion.

La connexion KoraPay apparaîtra dans la liste des connexions externes.

Vérifiez l'état de la connexion.

Si la connexion est inactive (No est affiché dans la colonne Enabled), cliquez sur le bouton Edit pour ouvrir les détails de la connexion et définissez la liste déroulante Enabled sur Yes.

Cliquez sur Save pour appliquer les modifications.

Dans le Back Office B2CORE, accédez à System > Deposit system > Deposit methods.

Cliquez sur +Create dans le coin supérieur droit de la page.

Sur la page Create a deposit method, renseignez les champs suivants :

• Dans le champ Name, saisissez un nom pour la méthode. Le nom doit être unique et ne peut contenir que des lettres latines, des chiffres, des tirets et des traits de soulignement.
• Dans le champ Caption, saisissez un libellé pour la méthode. Ce libellé sera attribué à la méthode dans le Back Office et sera visible par les clients dans l'interface B2CORE.
• Dans la liste déroulante Provider, sélectionnez PaymentSystemDeposit.

Après avoir sélectionné PaymentSystemDeposit, les champs suivants s'affichent :

• Dans la liste déroulante Available account currencies, sélectionnez une ou plusieurs devises prises en charge pour les dépôts, telles que NGN, GHS, KES, XAF et XOF. Les dépôts via KoraPay seront disponibles pour les comptes libellés dans les devises sélectionnées.
• Dans la liste déroulante Driver, sélectionnez KoraPay.
• Dans la liste déroulante Connection, sélectionnez la connexion KoraPay pour les dépôts précédemment configurée.

Dans la section Configuration, définissez l'option Merchant bears cost sur :

• Yes — le courtier (marchand) paie les frais de transaction.
• No — le trader (client) paie les frais de transaction.

Cliquez sur Save pour créer la méthode de dépôt.

La méthode de dépôt KoraPay apparaîtra dans la liste des méthodes de dépôt.

Cliquez sur Edit pour accéder aux détails de la méthode et renseignez les champs suivants :

• Dans l'onglet Settings, utilisez la liste déroulante Group pour sélectionner un ou plusieurs groupes dans lesquels la méthode doit être incluse.

• Dans le champ Icon, indiquez paymethod-korapay pour afficher l'icône prédéfinie de la méthode de dépôt KoraPay dans l'interface B2CORE. Pour utiliser une icône personnalisée, indiquez l'URL de l'image à afficher.

• Vérifiez l'état de la méthode.

  Si la méthode est inactive (No est affiché dans le champ Enabled), activez-la en définissant la liste déroulante Enabled sur Yes.

• Dans l'onglet PS Currencies, ajoutez les devises nécessaires. Pour permettre à la méthode de traiter les dépôts dans une devise spécifique, assurez-vous qu'elle est ajoutée dans cet onglet.

• Si nécessaire, configurez les commissions pour la méthode dans l'onglet Commissions (pour plus de détails, consultez Comment configurer les commissions pour les méthodes de dépôt et de retrait).

Cliquez sur Test configuration pour valider les paramètres de connexion de la méthode de dépôt.

Le résultat du test s'affichera sur la page.

Après avoir validé la configuration avec succès, cliquez sur Save.

Dans le Back Office B2CORE, accédez à System > Payout system > Payout methods.

Cliquez sur +Create dans le coin supérieur droit de la page.

Sur la page Create a payout method, renseignez les champs suivants :

• Dans le champ Name, saisissez un nom pour la méthode. Le nom doit être unique et ne peut contenir que des lettres latines, des chiffres, des tirets et des traits de soulignement.
• Dans le champ Caption, saisissez un libellé pour la méthode. Ce libellé sera attribué à la méthode dans le Back Office et sera visible par les clients dans l'interface B2CORE.
• Dans la liste déroulante Provider, sélectionnez PaymentSystemWithdrawal.

Après avoir sélectionné PaymentSystemWithdrawal, les champs suivants s'affichent :

• Dans la liste déroulante Available account currencies, sélectionnez une ou plusieurs devises. Les retraits via KoraPay seront disponibles depuis les comptes libellés dans les devises sélectionnées.

• Dans la liste déroulante Driver, sélectionnez :

  • KoraPay bank account — pour les retraits vers des comptes bancaires.

    Seuls les retraits vers des comptes bancaires nigérians sont pris en charge.

  • KoraPay mobile money — pour les retraits vers des portefeuilles mobiles via mobile money.

    Les retraits sont pris en charge pour les comptes mobile money kényans (KES), ghanéens (GHS), ivoiriens (XOF) et camerounais (XAF).

• Dans la liste déroulante Connection, sélectionnez la connexion KoraPay pour les retraits précédemment configurée.

Dans la section Configuration, renseignez les paramètres suivants :

Pour le pilote KoraPay bank account :

• Dans la liste déroulante Merchant bears cost, sélectionnez :

  • Yes — le courtier (marchand) paie les frais de transaction.
  • No — le trader (client) paie les frais de transaction.

Pour le pilote KoraPay mobile money :

• Configurez l'option Merchant bears cost comme décrit ci-dessus.
• Dans la liste déroulante Country, sélectionnez le pays dans lequel cette méthode de retrait sera disponible, par exemple le Kenya, le Ghana, la Côte d'Ivoire ou le Cameroun.

Cliquez sur Save pour créer la méthode de retrait.

La méthode de retrait KoraPay apparaîtra dans la liste des méthodes de retrait.

Cliquez sur Edit pour accéder aux détails de la méthode et renseignez les champs suivants :

• Dans l'onglet Settings, utilisez la liste déroulante Group pour sélectionner un ou plusieurs groupes dans lesquels la méthode doit être incluse.

• Dans le champ Icon, indiquez paymethod-korapay pour afficher l'icône prédéfinie de la méthode de retrait KoraPay dans l'interface B2CORE. Pour utiliser une icône personnalisée, indiquez l'URL de l'image à afficher.

  Si la méthode est inactive (No est affiché dans le champ Enabled), activez-la en définissant la liste déroulante Enabled sur Yes.

• Dans l'onglet PS Currencies, ajoutez les devises nécessaires. Pour permettre à la méthode de traiter les retraits dans une devise spécifique, assurez-vous qu'elle est ajoutée dans cet onglet.

• Si nécessaire, configurez les commissions pour la méthode dans l'onglet Commissions (pour plus de détails, consultez Comment configurer les commissions pour les méthodes de dépôt et de retrait).

Cliquez sur Test configuration pour valider les paramètres de connexion de la méthode de retrait.

Le résultat du test s'affichera sur la page.

Après avoir validé la configuration avec succès, cliquez sur Save.