B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERComment intégrer 1-2-Pay
Découvrez comment intégrer 1-2-Pay à B2CORE via PSS, notamment en configurant les connexions et en ajoutant des méthodes de dépôt et de retrait avec les devises prises en charge
1-2-Pay peut être connecté à B2CORE via PSS. Il prend en charge les dépôts via des codes QR et les retraits vers des comptes bancaires, traités en THB.
Suivez les instructions ci-dessous pour configurer les connexions 1-2-Pay 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 à 1-2-Pay.
Avant de suivre les instructions, vous devez vous être inscrit auprès de 1-2-Pay et disposer d'un compte actif.
Toutes les informations requises pour configurer les connexions à 1-2-Pay, y compris l'URL de base de démarrage de l'API, l'URL de base de synchronisation de l'API et les autres identifiants, doivent être demandées au support de 1-2-Pay.
Configurer les connexions à 1-2-Pay
Si vous prévoyez d'utiliser 1-2-Pay à 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 à 1-2-Pay :
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_1-2-PayouWithdrawals_1-2-Pay). -
Dans le champ Caption, saisissez une légende qui sera appliquée à 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 1-2-PAY.
Dans la section Credentials qui s'affiche, configurez les paramètres spécifiques à 1-2-Pay :
-
Dans la liste déroulante Sandbox, sélectionnez :
- Yes — pour l'environnement de test sandbox
- No — pour l'environnement de production
-
Dans le champ API start base URL, indiquez l'URL de base pour créer les demandes de paiement, fournie par 1-2-Pay.
-
Dans le champ API sync base URL, indiquez l'URL de base utilisée par B2CORE pour recevoir et valider les rappels, également fournie par 1-2-Pay.
Points clés concernant les URL
-
Les API start base URL et API sync base URL sont des points de terminaison différents et doivent être demandés directement à 1-2-Pay.
-
Veillez à toujours utiliser HTTPS, par exemple :
- API start base URL :
https://api.example.com/ - API sync base URL :
https://inquiry.example.com/
- API start base URL :
-
1-2-Pay fournit des URL spécifiques pour chaque environnement. Les URL de la sandbox diffèrent de celles de la production ; veillez donc à demander les deux ensembles et à utiliser ceux qui conviennent à votre configuration.
- Dans le champ Channel, saisissez le canal attribué à votre intégration par 1-2-Pay.
- Dans le champ Partner code, saisissez le code partenaire attribué à votre entreprise par 1-2-Pay.
- Dans le champ Auth key, saisissez la clé API permettant de signer les demandes, fournie par 1-2-Pay.
Cliquez sur Save pour créer la connexion.
La connexion 1-2-Pay s'affiche dans la liste des connexions externes.
Vérifiez l'état de la connexion.
Si la connexion est inactive (No s'affiche 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 1-2-Pay, suivez la même instruction pour créer une nouvelle connexion pour l'autre opération.
Ajouter une méthode de dépôt via 1-2-Pay
Pour ajouter et configurer une méthode permettant d'effectuer des dépôts via 1-2-Pay :
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 une légende pour la méthode. Cette légende sera attribuée à 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. Les dépôts via 1-2-Pay seront disponibles pour les comptes libellés dans les devises sélectionnées. Pour ces devises, les taux de conversion pour
THBdoivent être configurés. - Dans la liste déroulante Driver, sélectionnez 1-2-PAY.
- Dans la liste déroulante Connection, sélectionnez la connexion 1-2-Pay précédemment configurée.
Ignorez la section Configuration, car aucun paramètre n'est requis pour la méthode de dépôt 1-2-Pay.
Cliquez sur Save pour créer la méthode de dépôt.
La méthode de dépôt 1-2-Pay s'affiche 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-12paypour afficher l'icône prédéfinie de la méthode de dépôt 1-2-Pay 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 s'affiche dans le champ Enabled), activez-la en définissant la liste déroulante Enabled sur Yes.
-
Dans l'onglet PS Currencies, ajoutez
THB. -
Si nécessaire, configurez les commissions pour la méthode dans l'onglet Commissions (pour plus d'informations, 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'affiche sur la page.
Après avoir validé la configuration, cliquez sur Save.
La méthode de dépôt 1-2-Pay est désormais configurée dans le Back Office B2CORE.
Ajouter une méthode de retrait via 1-2-Pay
Pour ajouter et configurer une méthode permettant d'effectuer des retraits via 1-2-Pay :
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 une légende pour la méthode. Cette légende sera attribuée à 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 1-2-Pay seront disponibles depuis les comptes libellés dans les devises sélectionnées. Pour ces devises, les taux de conversion pour
THBdoivent être configurés. - Dans la liste déroulante Driver, sélectionnez 1-2-PAY.
- Dans la liste déroulante Connection, sélectionnez la connexion 1-2-Pay pour les retraits précédemment configurée.
Ignorez la section Configuration, car aucun paramètre n'est requis pour la méthode de retrait 1-2-Pay.
Cliquez sur Save pour créer la méthode de retrait.
La méthode de retrait 1-2-Pay s'affiche 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-12paypour afficher l'icône prédéfinie de la méthode de retrait 1-2-Pay 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 s'affiche dans le champ Enabled), activez-la en définissant la liste déroulante Enabled sur Yes.
-
Dans l'onglet PS Currencies, ajoutez
THB. -
Si nécessaire, configurez les commissions pour la méthode dans l'onglet Commissions (pour plus d'informations, 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'affiche sur la page.
Après avoir validé la configuration, cliquez sur Save.
La méthode de retrait 1-2-Pay est désormais configurée dans le Back Office B2CORE.
Configurer les webhooks dans 1-2-Pay
Pour recevoir les mises à jour de statut des dépôts et des retraits dans B2CORE, des webhooks de notification doivent être configurés du côté de 1-2-Pay.
Copier les URL des webhooks depuis le Back Office B2CORE
Vous aurez besoin d'URL de webhook distinctes pour les méthodes de dépôt et de retrait.
Dans le Back Office B2CORE, accédez à :
- System > Deposit system > Deposit methods
- System > Payout system > Payout methods
Recherchez la méthode de dépôt ou de retrait 1-2-Pay configurée et cliquez sur Edit pour ouvrir ses détails.
Accédez à l'onglet Webhooks.
Copiez l'URL affichée dans le champ Notification URL.
Fournir les URL à 1-2-Pay
Envoyez les URL de webhook copiées (pour les dépôts comme pour les retraits) au support de 1-2-Pay afin qu'il les configure de son côté.
Dernière mise à jour le