Comment intégrer TopChange Pay

Découvrez comment intégrer TopChange Pay à B2CORE via PSS afin d'activer les dépôts et les retraits, notamment la configuration, le paramétrage des méthodes et la vérification

TopChange Pay (TC Pay) peut être connecté à B2CORE via PSS, avec la prise en charge des dépôts et des retraits en USD, IRR, EUR, AED, TRY, CNY, RUB et USDT.

Suivez les instructions ci-dessous pour configurer les connexions TC Pay et paramétrer les méthodes de dépôt et de retrait dans le Back Office B2CORE. Ces instructions correspondent à la procédure générale pour ajouter des méthodes destinées aux systèmes de paiement pris en charge par PSS, mais elles incluent des détails propres à TC Pay.

Avant de suivre ces instructions, vous devez vous être inscrit à TC Pay et disposer d'un compte actif. Vous pouvez consulter la documentation officielle de TC Pay ou contacter leur support si vous avez des questions.

Configurer les connexions à TopChange Pay

Si vous prévoyez d'utiliser TC 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 à TC Pay :

Dans le Back Office B2CORE, accédez à Système > Connexions externes.

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

Sur la page Créer une connexion, renseignez les champs suivants :

  • Dans le champ Nom, 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_TC_Pay ou Withdrawals_TC_Pay).

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

  • Dans la liste déroulante Fournisseur, 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 Pilote qui s'affiche, sélectionnez TC Pay.

Dans la section Identifiants qui s'affiche, configurez les paramètres spécifiques à TC Pay :

  • Dans le champ URL de base de l'API, indiquez https://pg.topayment.net.

  • Dans le champ ID du marchand, saisissez l'ID du marchand attribué à votre compte par TC Pay.

  • Générez une paire de clés RSA privée et publique à l'aide de TC RSA Key Generator.

    Vous pouvez consulter la documentation officielle de TC Pay ou contacter leur support si vous avez des questions.

  • Dans le champ Clé RSA privée, indiquez la clé privée et assurez-vous d'indiquer la clé publique correspondante dans votre compte TC Pay.

Cliquez sur Enregistrer pour créer la connexion.

La connexion TC Pay apparaît dans la liste des connexions externes.

Vérifiez le statut de la connexion.

Si la connexion est inactive (Non s'affiche dans la colonne Activé), cliquez sur le bouton Modifier pour ouvrir les détails de la connexion et définissez la liste déroulante Activé sur Oui.

Cliquez sur Enregistrer pour appliquer les modifications.

Si vous devez prendre en charge à la fois les dépôts et les retraits via TC Pay, suivez les mêmes instructions pour créer une nouvelle connexion pour l'autre opération.

Ajouter une méthode de dépôt via TopChange Pay

Pour ajouter et configurer une méthode permettant d'effectuer des dépôts via TC Pay :

Dans le Back Office B2CORE, accédez à Système > Système de dépôt > Méthodes de dépôt.

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

Sur la page Créer une méthode de dépôt, renseignez les champs suivants :

  • Dans le champ Nom, 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 Libellé, 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 Fournisseur, sélectionnez PaymentSystemDeposit.

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

  • Dans la liste déroulante Devises de compte disponibles, sélectionnez une ou plusieurs devises. Les dépôts via TC Pay seront disponibles pour les comptes libellés dans les devises sélectionnées.
  • Dans la liste déroulante Pilote, sélectionnez TC Pay.
  • Dans la liste déroulante Connexion, sélectionnez la connexion TC Pay pour les dépôts précédemment configurée.

Dans la section Configuration, renseignez l'ID du terminal associé à votre compte marchand TC Pay. Cela garantit que les transactions sont correctement acheminées et attribuées au terminal de paiement approprié. Notez que la devise autorisée est déterminée par l'ID du terminal spécifié.

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

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

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

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

  • Dans le champ Icône, indiquez l'URL d'une image qui sera affichée comme icône de la méthode de dépôt dans l'interface B2CORE.

  • Vérifiez le statut de la méthode.

    Si la méthode est inactive (Non s'affiche dans le champ Activé), activez-la en définissant la liste déroulante Activé sur Oui.

  • Dans l'onglet Devises PS, ajoutez la devise nécessaire. 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.

Pour TC Pay, chaque méthode de dépôt ne peut prendre en charge qu'une seule devise dans l'onglet Devises PS. Par conséquent, si vous souhaitez permettre à vos clients d'effectuer des dépôts dans toutes les devises prises en charge (USD, IRR, EUR, AED, TRY, CNY, RUB et USDT), vous devez créer huit méthodes de dépôt distinctes — une pour chaque devise, correspondant à l'ID du terminal spécifié.

Méthode de dépôt TC Pay — onglet Paramètres

Cliquez sur Tester la 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 avec succès, cliquez sur Enregistrer.

La méthode de dépôt TC Pay est désormais configurée dans le Back Office B2CORE.

Ajouter une méthode de retrait via TopChange Pay

Pour ajouter et configurer une méthode permettant d'effectuer des retraits via TC Pay :

Dans le Back Office B2CORE, accédez à Système > Système de retrait > Méthodes de retrait.

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

Sur la page Créer une méthode de paiement, renseignez les champs suivants :

  • Dans le champ Nom, 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 Libellé, 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 Fournisseur, sélectionnez PaymentSystemWithdrawal.

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

  • Dans la liste déroulante Devises de compte disponibles, sélectionnez une ou plusieurs devises. Les retraits via TC Pay seront disponibles depuis les comptes libellés dans les devises sélectionnées.
  • Dans la liste déroulante Pilote, sélectionnez TC Pay.
  • Dans la liste déroulante Connexion, sélectionnez la connexion TC Pay pour les retraits précédemment configurée.

Dans la section Configuration, renseignez l'ID du terminal associé à votre compte marchand TC Pay. Cela garantit que les transactions sont correctement acheminées et attribuées au terminal de paiement approprié. Notez que la devise autorisée est déterminée par l'ID du terminal spécifié.

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

La méthode de retrait TC Pay apparaît dans la liste des méthodes de retrait.

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

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

  • Dans le champ Icône, indiquez l'URL d'une image qui sera affichée comme icône de la méthode de retrait dans l'interface B2CORE.

  • Vérifiez le statut de la méthode.

    Si la méthode est inactive (Non s'affiche dans le champ Activé), activez-la en définissant la liste déroulante Activé sur Oui.

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

Pour TC Pay, chaque méthode de retrait ne peut prendre en charge qu'une seule devise dans l'onglet Devises PS. Par conséquent, si vous souhaitez permettre à vos clients d'effectuer des retraits dans toutes les devises prises en charge (USD, IRR, EUR, AED, TRY, CNY, RUB et USDT), vous devez créer huit méthodes de retrait distinctes — une pour chaque devise, correspondant à l'ID du terminal spécifié.

Méthode de retrait TC Pay — onglet Paramètres

Cliquez sur Tester la 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 avec succès, cliquez sur Enregistrer.

La méthode de retrait TC Pay est désormais configurée dans le Back Office B2CORE.

Dernière mise à jour le

Sur cette page