Comment ajouter une passerelle de paiement à votre boutique (payment gateway)

Vos clients vous paient via votre propre compte de passerelle de paiement. L'argent arrive directement sur ce compte : le portail se contente de stocker vos clés (chiffrées) et de confirmer chaque paiement pour que la commande puisse être livrée.

Le choix de la passerelle vous appartient. Vous ouvrez vous-même le compte auprès du prestataire, selon ses conditions. Le portail prend en charge les cartes, les portefeuilles électroniques, les virements bancaires et les cryptomonnaies, et liste toutes les passerelles prises en charge sous Supported Gateways.

Remarque : préparez votre compte de passerelle avant de commencer. Il vous faut les clés API disponibles dans le tableau de bord de votre prestataire.

1Step 1 of 6Ouvrir vos passerelles de paiement

Allez dans Payment gateways → All gateways. La page Payment gateways liste les passerelles que vous avez connectées et toutes celles que le portail prend en charge.

2Step 2 of 6Choisir votre passerelle

Cliquez sur votre passerelle sous Supported Gateways, ou cliquez sur Add Gateway et choisissez-la sous Gateway. La page Add Payment Gateway affiche les champs nécessaires à cette passerelle et, pour la plupart d'entre elles, où trouver chaque clé dans le tableau de bord de votre prestataire. Pour Interac, Wise et Cash App ($Cashtag), que vous confirmez à la main, cliquez sur Add Gateway et choisissez-les sous Gateway : leurs vignettes ouvrent à la place la page où vous rapprochez les paiements reçus.

Si la page Payment gateways affiche Plan Limit Reached, votre offre n'a plus d'emplacement de passerelle libre : le bouton Add Gateway est masqué et les vignettes ne sont pas cliquables.

3Step 3 of 6Coller vos clés

Copiez chaque clé depuis le tableau de bord de votre prestataire dans le champ correspondant. Les champs marqués d'une étoile sont obligatoires.

4Step 4 of 6Ajouter le webhook, si demandé

Certaines passerelles affichent un encadré Webhook setup — required for automatic confirmation. Copiez l'URL qu'il contient dans les paramètres de webhook de votre passerelle, abonnez-vous à l'événement indiqué et collez la clé fournie par votre passerelle dans le champ désigné. Sans le webhook, des commandes payées peuvent rester non confirmées.

5Step 5 of 6Enregistrer et vérifier le statut

Cliquez sur Add Gateway. La passerelle apparaît sous Configured Gateways avec le statut Active et est proposée au paiement.

Si elle affiche Misconfigured, votre prestataire a rejeté les clés et la passerelle n'est pas proposée au paiement tant que le problème n'est pas corrigé. Cliquez sur Configure, corrigez les clés et enregistrez de nouveau.

6Step 6 of 6Désactiver ou réactiver une passerelle

Cliquez sur Configure sur la passerelle et basculez Gateway Status. Une passerelle Inactive n'est pas proposée au paiement. Lorsque vous modifiez les paramètres, les champs secrets laissés vides conservent leur valeur enregistrée (Leave empty to keep existing value). Delete Gateway supprime la passerelle.

Astuce : avec deux passerelles, utilisez Failover Settings sur la même page pour choisir une passerelle principale et une de secours par boutique. La devise de vente de votre boutique se règle dans Payment gateways → Currency.

Méthodes manuelles : Interac, Wise et Cash App ($Cashtag)

Certaines méthodes n'ont pas de confirmation automatique : Interac e-Transfer, Wise et Cash App ($Cashtag). Il n'y a ni clés ni webhook. Votre client envoie lui-même l'argent, avec un court code de référence dans la note du paiement, et vous confirmez sa réception. Pour ces méthodes, la page Payment gateways affiche un bandeau avec un lien vers l'endroit où vous rapprochez chaque paiement et le marquez comme reçu.

Cash App ($Cashtag) fonctionne ainsi :

1. Cliquez sur Add Gateway, choisissez Cash App ($Cashtag) sous Gateway et saisissez Your $Cashtag (un $ suivi de 1 à 20 lettres, chiffres ou _, par exemple $YourStore). Une note supplémentaire pour les clients est facultative.
2. Au paiement, votre client voit le montant, votre $Cashtag, le code de référence à mettre dans la note Cash App et un lien qui ouvre votre $Cashtag dans Cash App. La commande vous attend.
3. Lorsque le paiement apparaît dans Cash App, ouvrez Cash App payments need manual reconciliation sur la page Payment gateways, recherchez le code de référence et cliquez sur Mark received & provision. La commande est alors livrée automatiquement.

Cash App ($Cashtag) n'est pas la même chose que Cash App Pay, qui accepte des paiements de type carte via un compte Square distinct et les confirme automatiquement.