Comment intégrer LuqaPay

Découvrez comment configurer l’intégration de LuqaPay avec B2CORE via PSS afin d’activer les retraits

LuqaPay peut être connecté à B2CORE via PSS, prenant en charge les retraits par virements bancaires en TRY.

Suivez les instructions ci-dessous pour configurer la connexion LuqaPay et mettre en place la méthode 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 à LuqaPay.

Avant de suivre ces instructions, vous devez vous être inscrit à LuqaPay et disposer d’un compte actif.

Configurer une connexion à LuqaPay

Pour configurer une connexion à LuqaPay afin d’effectuer des retraits :

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, Withdrawals_LuqaPay).
Dans le champ Caption, saisissez un libellé qui sera appliqué à la connexion dans le Back Office.
Dans la liste déroulante Provider, sélectionnez PaymentSystemWithdrawal.

Dans la liste déroulante Driver qui s’affiche, sélectionnez LuqaPay.

Dans la section Credentials qui s’affiche, configurez les paramètres spécifiques à LuqaPay :

Dans le champ API base URL, indiquez :
- https://wallet.luqapay.com — pour l’environnement de production
- https://sandbox-wallet.luqapay.com — pour l’environnement de test sandbox
Dans le champ API key, saisissez la clé API générée dans votre compte LuqaPay.
Dans le champ API secret key, saisissez la clé secrète API générée dans votre compte LuqaPay.

Cliquez sur Save pour créer la connexion.

La connexion LuqaPay 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.

Ajouter une méthode de retrait via LuqaPay

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

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 s’affichent :

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

Dans la section Configuration, sélectionnez Türkiye dans la liste déroulante Country. Il s’agit du seul pays pris en charge pour cette intégration.

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

La méthode de retrait LuqaPay 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 auxquels la méthode doit être ajoutée.
Dans le champ Icon, 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 (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 TRY. Il s’agit de la seule devise prise en charge pour le traitement des retraits avec cette intégration.
Si nécessaire, configurez les commissions pour 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 LuqaPay — onglet Settings

Cliquez sur Save pour appliquer les modifications.

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

Configurer un webhook dans LuqaPay

Pour recevoir les mises à jour de statut des retraits dans B2CORE, un webhook de notification doit être configuré du côté de LuqaPay.

Copier l’URL du webhook depuis le Back Office B2CORE

Dans le Back Office B2CORE, accédez à System > Payout system > Payout methods.

Recherchez la méthode de retrait LuqaPay configurée et cliquez sur Edit pour ouvrir les détails de la méthode.

Accédez à l’onglet Webhooks.

Copiez l’URL affichée dans le champ Notification URL.

Fournir l’URL du webhook à LuqaPay

Envoyez l’URL du webhook copiée au support LuqaPay afin qu’il la configure de son côté.