Comment intégrer B2BINPAY

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_B2BINPAY ou Withdrawals_B2BINPAY).

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

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

  • PaymentSystemStaticDeposit — pour ajouter une connexion qui sera utilisée pour une méthode de dépôt prenant en charge les coordonnées de paiement statiques.
  • PaymentSystemWithdrawal — pour ajouter une connexion qui sera utilisée pour une méthode de retrait.

Dans la liste déroulante Driver qui apparaît, sélectionnez B2BINPAY V3.

Dans la section Credentials qui apparaît, configurez les paramètres spécifiques à B2BINPAY :

• Dans le champ API base URL, indiquez l’URL de base fournie par B2BINPAY pour votre environnement d’intégration.
• Dans le champ Client ID, saisissez votre identifiant client fourni par B2BINPAY.
• Dans le champ Client secret, saisissez la clé secrète associée à votre identifiant client.
• Dans le champ Callback secret, saisissez la clé utilisée pour vérifier les notifications de rappel de B2BINPAY.

Pour plus de détails, reportez-vous à la section How to access the API de la documentation B2BINPAY.

Cliquez sur Save pour créer la connexion.

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

Vérifiez le statut 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.

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

Après avoir sélectionné PaymentSystemStaticDeposit, les champs suivants apparaissent :

• Dans la liste déroulante Available account currencies, sélectionnez une ou plusieurs devises. La méthode sera disponible pour déposer des fonds sur les portefeuilles clients dans B2CORE libellés dans les devises ajoutées dans cet onglet.
• Dans la liste déroulante Driver, sélectionnez B2BINPAY V3.
• Dans la liste déroulante Connection, sélectionnez la connexion B2BINPAY pour les dépôts précédemment configurée.

Après avoir sélectionné la connexion, le formulaire Configuration apparaît. Le message Configuration form is temporarily unavailable. peut s’afficher. Attendez un court instant que le formulaire devienne disponible.

Dans la section Configuration, renseignez les champs suivants :

• Dans la liste déroulante Wallet, sélectionnez votre portefeuille B2BINPAY qui sera utilisé pour traiter les transactions. Pour chaque portefeuille de la liste, l’identifiant attribué par B2BINPAY, le type de portefeuille (Merchant ou Enterprise), la devise du portefeuille et le libellé (s’il est indiqué dans B2BINPAY) sont affichés.

  Pour plus de détails, reportez-vous à la section Sélection de la blockchain pour les portefeuilles Merchant et Enterprise.

• Le champ Collect personal data affiche No, qui ne peut pas être modifié, car la Travel rule n’est actuellement pas prise en charge pour cette intégration B2BINPAY.

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

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

Cliquez sur Edit pour ouvrir les 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-b2binpay pour afficher l’icône prédéfinie de la méthode dans l’interface B2CORE. Pour utiliser une icône personnalisée, indiquez l’URL de l’image à afficher.

• Dans la liste déroulante Rates provider, sélectionnez B2BINPAY comme fournisseur de taux privilégié pour traiter les dépôts avec conversions. Pour ce faire, B2BINPAY doit d’abord être ajouté comme fournisseur de taux de change dans Currencies > Rates (pour plus de détails, reportez-vous à Comment configurer les taux de change).

• Vérifiez le statut 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 les devises dans lesquelles les dépôts peuvent être traités. Il s’agit des devises prises en charge par le portefeuille B2BINPAY sélectionné dans la section Configuration.

Pour activer les dépôts dans une devise spécifique via cette méthode, assurez-vous que cette devise est ajoutée dans l’onglet PS Currencies.

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 apparaissent :

• Dans la liste déroulante Available account currencies, sélectionnez une ou plusieurs devises. La méthode sera disponible pour retirer des fonds des portefeuilles clients dans B2CORE libellés dans les devises ajoutées dans cet onglet.
• Dans la liste déroulante Driver, sélectionnez B2BINPAY V3.
• Dans la liste déroulante Connection, sélectionnez la connexion B2BINPAY pour les retraits précédemment configurée.

Après avoir sélectionné la connexion, le formulaire Configuration apparaît. Le message Configuration form is temporarily unavailable. peut s’afficher. Attendez un court instant que le formulaire devienne disponible.

Dans la section Configuration, renseignez les champs suivants :

• Dans la liste déroulante Wallet, sélectionnez votre portefeuille B2BINPAY qui sera utilisé pour traiter les transactions. Pour chaque portefeuille de la liste, l’identifiant attribué par B2BINPAY, le type de portefeuille (Merchant ou Enterprise), la devise du portefeuille et le libellé (s’il est indiqué dans B2BINPAY) sont affichés.

  Pour plus de détails, reportez-vous à la section Sélection de la blockchain pour les portefeuilles Merchant et Enterprise.

• Dans la liste déroulante Blockchain fee level, sélectionnez Low, Medium ou High.

• Dans la liste déroulante Force blockchain (applicable uniquement aux portefeuilles Merchant), sélectionnez :

  • Yes — pour utiliser uniquement des transactions on-chain.
  • No — pour autoriser les transactions off-chain lorsque cela est possible.

• Le champ Collect personal data affiche No, qui ne peut pas être modifié, car la Travel rule n’est actuellement pas prise en charge pour cette intégration B2BINPAY.

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

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

Cliquez sur Edit pour saisir les détails de la méthode et compléter 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-b2binpay pour afficher l’icône prédéfinie de la méthode dans l’interface B2CORE. Pour utiliser une icône personnalisée, indiquez l’URL de l’image à afficher.

• Dans la liste déroulante Rates provider, sélectionnez B2BINPAY comme fournisseur de taux privilégié pour traiter les retraits avec conversions. Pour ce faire, B2BINPAY doit d’abord être ajouté comme fournisseur de taux de change dans Currencies > Rates (pour plus de détails, reportez-vous à Comment configurer les taux de change).

• Vérifiez le statut 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 les devises dans lesquelles les retraits peuvent être traités. Il s’agit des devises prises en charge par le portefeuille B2BINPAY sélectionné dans la section Configuration.

Pour activer les retraits dans une devise spécifique via cette méthode, assurez-vous que cette devise est ajoutée dans l’onglet PS Currencies.

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.