Comment intégrer ChipPay

Découvrez comment intégrer ChipPay à B2CORE pour les dépôts et les retraits, configurer les connexions, mettre en place les méthodes de dépôt/retrait et garantir des paramètres corrects pour les paiements traités en USDT et CNY

ChipPay peut être connecté à B2CORE via PSS, avec prise en charge des dépôts et des retraits.

ChipPay traite les paiements en CNY, qui sert de devise de règlement, tandis que le PPS B2CORE envoie et reçoit des montants vers et depuis ChipPay en USDT. Pour cette raison, USDT doit être ajouté comme devise PS dans les méthodes de dépôt et de retrait configurées dans B2CORE.

Suivez les instructions ci-dessous pour configurer les connexions ChipPay et mettre en place 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 à ChipPay.

Avant de poursuivre avec les instructions, vous devez vous être inscrit à ChipPay et disposer d’un compte actif. Si vous avez des questions, consultez le Centre d’aide ChipPay officiel ou contactez leur équipe d’assistance.

Configurer les connexions à ChipPay

Si vous prévoyez d’utiliser ChipPay à la fois pour les dépôts et les retraits, vous devez configurer des connexions distinctes, chacune dédiée à une méthode de dépôt ou de retrait spécifique.

Chaque connexion doit être configurée avec le pilote approprié afin de garantir le bon fonctionnement de la méthode de dépôt ou de retrait correspondante.

Pour configurer une connexion à ChipPay :

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, remplissez 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_ChipPay ou Withdrawals_ChipPay).

  • 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 apparaît, sélectionnez :

  • ChipPay P2P buying order — pour les dépôts traités via les ordres de paiement ChipPay. Les clients peuvent payer en utilisant l’une des méthodes disponibles configurées dans votre compte marchand ChipPay, telles que les cartes bancaires, AliPay ou WeChat Pay, si ces options sont activées.
  • ChipPay express buying order — pour les dépôts effectués par paiement par carte bancaire.
  • ChipPay — pour les retraits effectués par paiement par carte bancaire.

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

  • Dans le champ API base URL, indiquez https://open-v2.chippay.com/.
  • Dans le champ Merchant ID, saisissez votre ID marchand ChipPay.
  • Générez une paire de clés RSA privée et publique de 4096 bits à l’aide d’un outil sécurisé, tel qu’OpenSSL ou une autre méthode fiable.

Pour des raisons de sécurité, il n’est pas recommandé d’utiliser des outils en ligne pour générer les clés.

  • Dans le champ Private key, indiquez la clé privée et assurez-vous d’indiquer la clé publique correspondante dans votre compte ChipPay.

Cliquez sur Save pour créer la connexion.

La connexion ChipPay pour les dépôts ou les retraits 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.

Si vous avez besoin de connexions ChipPay supplémentaires pour d’autres méthodes de paiement, suivez les mêmes instructions pour créer une nouvelle connexion avec un pilote différent.

L’image ci-dessous présente trois connexions ChipPay configurées : une pour la méthode de retrait et deux pour les méthodes de dépôt.

External connections to ChipPay

Ajouter une méthode de dépôt via ChipPay

Pour ajouter et configurer une méthode permettant d’effectuer des dépôts via ChipPay :

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

  • Dans la liste déroulante Available account currencies, sélectionnez une ou plusieurs devises. Les dépôts via ChipPay seront disponibles pour les comptes libellés dans les devises sélectionnées.

  • Dans la liste déroulante Driver, sélectionnez ChipPay P2P buying order ou ChipPay express buying order.

  • Dans la liste déroulante Connection, sélectionnez la connexion ChipPay pour les dépôts précédemment configurée.

Si vous avez sélectionné le pilote ChipPay P2P buying order, ignorez la section Configuration, car aucun paramètre n’est requis pour cette méthode de dépôt.

Si vous avez sélectionné le pilote ChipPay express buying order, dans la section Configuration qui apparaît, remplissez les champs suivants :

  • Dans la liste déroulante Exchange rate adjustment, sélectionnez :

    • Yes — pour ajuster le taux de change fourni par ChipPay lors de la conversion des fonds déposés en CNY, qui est la devise de règlement utilisée par ChipPay pour traiter les paiements.
    • No — pour utiliser le taux par défaut fourni par ChipPay.
  • Si vous avez sélectionné Yes, indiquez la valeur d’ajustement (en pourcentage) dans le champ Adjustment value. Le taux ne peut être ajusté que dans une plage de ±3 %. Par exemple, saisir 3 augmente le taux de change de 3 %, tandis que -3 le diminue de 3 %.

Le taux ajusté apparaîtra dans les détails de l’ordre d’achat P2P ChipPay créé pour traiter le dépôt.

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

La méthode de dépôt ChipPay 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-chippay pour afficher l’icône prédéfinie de la méthode de dépôt ChipPay dans l’interface B2CORE. Pour utiliser une icône personnalisée, indiquez l’URL de l’image à afficher.

  • 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 USDT.

  • 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).

Méthode de dépôt ChipPay — onglet Settings

Cliquez sur Test configuration pour valider les paramètres de connexion de la méthode de dépôt. Le test est effectué en fonction des paramètres indiqués dans le formulaire de la méthode et des données fournies dans la connexion externe sélectionnée.

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

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

La méthode de dépôt ChipPay est maintenant configurée dans le Back Office B2CORE.

Si vous souhaitez prendre en charge les deux méthodes de dépôt proposées par ChipPay, ajoutez et configurez une autre méthode de dépôt utilisant un pilote et une connexion différents.

Ajouter une méthode de retrait via ChipPay

Pour ajouter et configurer une méthode permettant d’effectuer des retraits via ChipPay :

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

  • Dans la liste déroulante Available account currencies, sélectionnez une ou plusieurs devises. Les retraits via ChipPay seront disponibles depuis les comptes libellés dans les devises sélectionnées.
  • Dans la liste déroulante Driver, sélectionnez ChipPay.
  • Dans la liste déroulante Connection, sélectionnez la connexion ChipPay pour les retraits précédemment configurée.

Ignorez la section Configuration, car aucun paramètre n’est requis pour les retraits ChipPay.

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

La méthode de retrait ChipPay 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-chippay pour afficher l’icône prédéfinie de la méthode de retrait ChipPay dans l’interface B2CORE. Pour utiliser une icône personnalisée, indiquez l’URL de l’image à afficher.

  • 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 USDT.

  • 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).

Méthode de retrait ChipPay — onglet Settings

Cliquez sur Test configuration pour valider les paramètres de connexion de la méthode de retrait. Le test est effectué en fonction des paramètres indiqués dans le formulaire de la méthode et des données fournies dans la connexion externe sélectionnée.

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

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

La méthode de retrait ChipPay est maintenant configurée dans le Back Office B2CORE.

Dernière mise à jour le

Sur cette page