B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERComment intégrer PayRetailers
Découvrez comment intégrer PayRetailers à B2CORE via PSS pour activer les dépôts et les retraits dans les devises prises en charge
PayRetailers peut être connecté à B2CORE via PSS, avec prise en charge des dépôts et des retraits.
Suivez les instructions ci-dessous pour configurer les connexions PayRetailers et définir les méthodes de dépôt et de retrait dans le Back Office B2CORE. Ces instructions correspondent à la procédure générale d'ajout de méthodes pour les systèmes de paiement pris en charge par PSS, mais incluent des détails spécifiques à PayRetailers.
Avant de suivre les instructions, vous devez vous être inscrit auprès de PayRetailers et disposer d'un compte actif. Vous pouvez consulter la documentation officielle de PayRetailers ou contacter leur assistance si vous avez des questions.
Devises prises en charge
Le tableau ci-dessous répertorie les devises prises en charge pour les dépôts et les retraits via PayRetailers :
| 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 | ✔ | ✘ |
Configurer les connexions à PayRetailers
Si vous prévoyez d'utiliser PayRetailers à la fois pour les dépôts et les retraits, vous devez configurer deux connexions distinctes : une pour les dépôts et une autre pour les retraits.
Pour configurer une connexion à PayRetailers :
Dans le Back Office B2CORE, accédez à System > External connections.
Cliquez sur +Create dans l'angle 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_PayRetailersouWithdrawals_PayRetailers). -
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 PayRetailers.
Dans la section Credentials qui s'affiche, configurez les paramètres spécifiques à PayRetailers :
-
Dans le champ API base URL, indiquez :
https://api.payretailers.com— pour l'environnement de productionhttps://api-sandbox.payretailers.com— pour l'environnement de test sandbox
-
Dans le champ Shop ID, saisissez l'identifiant attribué à votre compte par PayRetailers.
-
Dans le champ Secret key, indiquez la clé secrète de votre compte PayRetailers.
-
Dans le champ Subscription key, indiquez la clé d'abonnement de votre compte PayRetailers.
Toutes ces informations sont fournies par PayRetailers lors du processus d'intégration et sont également disponibles dans la section Shops de votre compte PayRetailers.
Cliquez sur Save pour créer la connexion.
La connexion PayRetailers 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.
Si vous devez prendre en charge les dépôts et les retraits via PayRetailers, suivez la même procédure pour créer une nouvelle connexion pour l'autre opération.
Ajouter une méthode de dépôt via PayRetailers
Pour ajouter et configurer une méthode permettant d'effectuer des dépôts via PayRetailers :
Dans le Back Office B2CORE, accédez à System > Deposit system > Deposit methods.
Cliquez sur +Create dans l'angle 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 utilisateur 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. Les dépôts effectués via cette méthode seront disponibles pour les comptes libellés dans les devises sélectionnées.
- Dans la liste déroulante Driver, sélectionnez PayRetailers.
- Dans la liste déroulante Connection, sélectionnez la connexion PayRetailers pour les dépôts configurée précédemment.
Dans la section Configuration qui s'affiche, renseignez les champs suivants :
-
Dans la liste déroulante Channel, sélectionnez le canal de paiement :
- Online — pour les paiements en ligne
- Wallet — pour les paiements via des portefeuilles électroniques
- Credit card — pour alimenter les dépôts avec des cartes bancaires
- Cash — pour effectuer des paiements en espèces via des banques
-
Dans la liste déroulante Country, sélectionnez le pays dans lequel le paiement sera traité.
Cliquez sur Save pour créer la méthode de dépôt.
La méthode de dépôt PayRetailers 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-payretailerspour afficher l'icône prédéfinie de la méthode de dépôt PayRetailers dans l'interface utilisateur 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 la devise requise. Pour permettre à la méthode de traiter des dépôts dans une devise spécifique, assurez-vous qu'elle est ajoutée dans cet onglet.
Pour les dépôts PayRetailers, les devises utilisées pour traiter les dépôts sont liées au pays sélectionné dans la section Configuration de la méthode. Un même pays peut prendre en charge plusieurs devises de dépôt :
- Argentine → ARS, USD
- Brésil → BRL, USD
- Chili → CLP, USD
- Colombie → COP, USD
- Costa Rica → CRC, USD
- Équateur → USD
- Salvador → USD
- Mexique → MXN, USD
- Panama → USD
- Pérou → PEN, USD
- Rwanda → RWF, USD
- Tanzanie → TZS, USD
- Kenya → KES, USD
- Nigéria → NGN, USD
- Afrique du Sud → ZAR, USD
Par exemple, pour le Brésil, les dépôts peuvent être traités en BRL et en USD, qui peuvent tous deux être ajoutés dans l'onglet PS Currencies.
En outre, l'utilisation de la méthode peut être restreinte à un pays spécifique en appliquant des restrictions par pays (pour plus de détails, consultez Comment restreindre l'utilisation des méthodes de dépôt et de retrait).
- Si nécessaire, configurez les commissions de 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.
La méthode de dépôt PayRetailers est maintenant configurée dans le Back Office B2CORE.
Ajouter une méthode de retrait via PayRetailers
Pour ajouter et configurer une méthode permettant d'effectuer des retraits via PayRetailers :
Dans le Back Office B2CORE, accédez à System > Payout system > Payout methods.
Cliquez sur +Create dans l'angle 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 utilisateur 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 effectués via cette méthode seront disponibles depuis les comptes libellés dans les devises sélectionnées.
- Dans la liste déroulante Driver, sélectionnez PayRetailers.
- Dans la liste déroulante Connection, sélectionnez la connexion PayRetailers pour les retraits configurée précédemment.
Dans la section Configuration, sélectionnez le canal de paiement dans la liste déroulante Channel.
Cliquez sur Save pour créer la méthode de retrait.
La méthode de retrait PayRetailers 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-payretailerspour afficher l'icône prédéfinie de la méthode de retrait PayRetailers dans l'interface utilisateur 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 la devise requise. Pour permettre à la méthode de traiter des retraits dans une devise spécifique, assurez-vous qu'elle est ajoutée dans cet onglet.
Pour les retraits PayRetailers, chaque devise est liée à un pays spécifique selon une relation stricte un-à-un. Cela signifie qu'un retrait dans une devise donnée est disponible uniquement pour le pays correspondant. Par conséquent, les clients doivent sélectionner le pays approprié et fournir les coordonnées bancaires requises pour ce lieu.
Le mappage suivant indique le pays associé à chaque devise de retrait :
- Argentine → ARS
- Brésil → BRL
- Chili → CLP
- Colombie → COP
- Équateur → USD
- Mexique → MXN
- Pérou → PEN
- Si nécessaire, configurez les commissions de 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.
La méthode de retrait PayRetailers est maintenant configurée dans le Back Office B2CORE.
Dernière mise à jour le