Comment intégrer BridgerPay

Connectez-vous à votre compte BridgerPay.

Dans le menu principal, accédez à Checkouts.

Cliquez sur l'icône plus pour ajouter un nouveau checkout, puis renseignez les champs suivants :

• Dans le champ Title, saisissez un titre pour le checkout.
• Dans la liste déroulante Type, sélectionnez Payment link.

Cliquez sur Create.

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 peut contenir uniquement des lettres latines, des chiffres, des tirets et des traits de soulignement (par exemple, Deposits_BridgerPay).
• Dans le champ Caption, saisissez un libellé qui sera appliqué à la connexion dans le Back Office.
• Dans la liste déroulante Provider, sélectionnez PaymentSystemDeposit.

Dans la liste déroulante Driver qui s'affiche, sélectionnez BridgerPay.

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

• Dans le champ API base URL, indiquez https://api.bridgerpay.com.
• Dans les champs API user name et API password, saisissez vos identifiants d'accès à l'API BridgerPay.
• Dans le champ API key, saisissez la clé API générée dans votre compte BridgerPay.

Cliquez sur Save pour créer la connexion.

La connexion BridgerPay apparaît 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 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 peut contenir uniquement 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 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 BridgerPay seront disponibles pour les comptes libellés dans les devises sélectionnées.
• Dans la liste déroulante Driver, sélectionnez BridgerPay.
• Dans la liste déroulante Connection, sélectionnez la connexion BridgerPay précédemment configurée.

Dans la section Configuration qui s'affiche, complétez le paramètre suivant :

• Dans le champ Cashier key, indiquez l'identifiant unique fourni par BridgerPay.

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

La méthode de dépôt BridgerPay apparaît 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-bridgerpay pour afficher l'icône prédéfinie de la méthode de dépôt BridgerPay 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.

• Ajoutez les devises requises dans l'onglet PS Currencies. Pour permettre à la méthode de traiter des dépôts dans une devise spécifique, assurez-vous qu'elle est ajoutée dans cet onglet (pour la description de l'onglet, consultez Deposit methods).

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

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

Le résultat du test s'affiche sur la page.

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

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

Recherchez la méthode de dépôt BridgerPay configurée et cliquez sur Edit pour accéder aux détails de la méthode.

Accédez à l'onglet Webhooks.

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

Connectez-vous à votre compte BridgerPay.

Dans le menu principal, accédez à Checkouts.

Sélectionnez le PSP ajouté et cliquez dessus pour ouvrir ses détails.

Dans les détails, cliquez sur Settings.

Accédez à l'onglet URLs.

Collez l'URL du webhook copiée depuis le Back Office B2CORE dans le champ Webhook Notification URL.

Enregistrez vos modifications.

Dans votre compte BridgerPay, accédez à Checkouts dans le menu principal.

Sélectionnez le PSP ajouté et cliquez dessus pour ouvrir ses détails.

Dans les détails, cliquez sur Settings.

Accédez à l'onglet URLs.

Indiquez les URL suivantes :

• Dans le champ Success Redirect URL, indiquez https://{your-Front-Office-URL}/en/payment/success.
• Dans les champs Failure Redirect URL et Cancel Redirect URL, indiquez https://{your-Front-Office-URL}/en/payment/failed.

Enregistrez vos modifications.

Dans votre compte BridgerPay, accédez à Checkouts dans le menu principal.

Sélectionnez le PSP ajouté et cliquez dessus pour ouvrir ses détails.

Dans les détails, cliquez sur Settings.

Dans la section nommée PSP Specific Settings, activez l'option Notify with original amount.

Enregistrez vos modifications.