Une passerelle de paiement pour une boutique en Andorre doit relier l’achat à l’encaissement et transmettre un résultat permettant de traiter la commande. Le client doit pouvoir payer en comprenant ce qu’il achète ; votre équipe doit savoir si elle peut préparer la livraison. Ce parcours complet est l’objet de l’intégration, même si le bouton de paiement en est la partie la plus visible.
Chez AndorPay, nous connectons le paiement à l’infrastructure bancaire et à votre boutique ou application. Ce guide développe l’intégration ecommerce : plateforme, page de paiement, données, statuts, incidents et mise en service. Si vous définissez encore votre façon de vendre, commencez par le guide général pour encaisser depuis l’Andorre.
Ce que la passerelle doit apporter à votre boutique
La passerelle participe à l’autorisation du paiement et transmet son résultat. L’intégration rattache ce résultat à l’achat. Lorsque les deux parties sont préparées, un paiement confirmé correspond à une commande précise et l’acheteur reçoit une explication cohérente.
La boutique conserve ses autres responsabilités : calculer l’achat, recueillir les coordonnées nécessaires, gérer le stock et livrer. Une autorisation réussie ne complète pas une adresse et ne décide pas du produit à expédier. La mise en service doit donc vérifier la vente depuis le panier jusqu’à la préparation de commande.
Un bouton absent, une commande encore en attente après paiement et un courriel de confirmation manquant sont des symptômes différents. Les distinguer permet d’intervenir au bon endroit, sans modifier toute la boutique pour résoudre un problème situé sur une seule liaison.
Les éléments qui participent à une vente
L’acheteur voit un seul parcours, mais la boutique, la connexion de paiement et l’infrastructure bancaire travaillent ensemble. Votre outil de gestion peut ajouter une étape pour préparer l’expédition ou ouvrir l’accès à un service.
| Élément | Rôle dans la vente | Information à conserver |
|---|---|---|
| Boutique ou application | Préparer l’achat | Commande, lignes, montant et client |
| Page de paiement | Présenter l’action à effectuer | Session reliée à l’achat |
| Traitement bancaire | Obtenir le résultat de l’autorisation | Opération et état confirmé |
| Intégration | Actualiser la vente | Relation entre commande et paiement |
| Livraison ou accès | Fournir ce qui a été acheté | État de l’expédition ou du service |
Vous n’avez pas à gérer chaque élément manuellement. Il faut toutefois une relation claire entre eux pour que votre équipe retrouve une vente sans la reconstituer à partir de messages, de captures et de montants similaires.
Faites un état des lieux ciblé de votre boutique
Identifiez la plateforme, le type de page de commande et les personnalisations qui modifient les achats. Incluez les taxes configurées dans la boutique, les livraisons, les codes promotionnels, les variantes et les outils qui reçoivent les commandes après paiement.
Choisissez un achat représentatif et suivez-le du début à la fin. Notez où le total est calculé, quand l’adresse est recueillie et quel écran votre équipe utilise pour préparer l’envoi. Cette vérification décrit ce que la nouvelle connexion doit préserver.
Si une passerelle fonctionne déjà, ajoutez les points satisfaisants et l’amélioration recherchée. Il peut manquer un moyen de paiement, y avoir trop de travail manuel ou une mauvaise mise à jour des commandes. Un besoin concret permet de limiter le changement et de vérifier ensuite son résultat.
Le point de départ dépend de votre plateforme
WooCommerce
Notre extension relie WooCommerce à AndorPay. Les produits et calculs restent dans la boutique ; l’extension transmet les lignes et références nécessaires au paiement. Cette intégration ne demande pas de recréer votre catalogue dans AndorPay.
La documentation couvre la commande classique, Checkout Blocks, HPOS et le paiement d’une commande existante. Avant installation ou mise à jour, identifiez les versions de WooCommerce et de l’extension, ainsi que les modules qui modifient le parcours. Le guide WooCommerce contient la configuration à suivre.
Shopify et les plateformes contrôlant leur page de paiement
La plateforme détermine les connexions autorisées et la présentation du paiement. La compatibilité d’un fournisseur avec un outil ne signifie pas que tous ses moyens ou modèles récurrents sont accessibles dans cette intégration.
Si vous utilisez Shopify, nous examinons le parcours disponible et votre façon de vendre avant de proposer un changement. Si la plateforme ne couvre pas le besoin, une autre solution doit être évaluée avec son périmètre : produits, commandes, livraison et travail de l’équipe. La décision part de votre activité réelle.
Une application développée pour votre entreprise
Votre serveur prépare l’achat et crée une session via l’API. L’acheteur ouvre l’adresse de paiement reçue, puis votre application traite les événements communiquant le résultat. Le guide REST décrit cette connexion.
Définissez dès le départ la relation entre client, produit, commande et paiement. L’API relie les systèmes, tandis que les règles de livraison et d’accès restent dans votre application. Cette séparation permet de conserver un parcours cohérent lorsque votre catalogue ou vos écrans évoluent.
Page hébergée et expérience intégrée à la boutique
Une page de paiement hébergée utilise un espace préparé par la plateforme d’encaissement. Votre application crée la session et dirige l’acheteur vers son adresse. Elle reçoit ensuite la confirmation nécessaire pour poursuivre la vente.
Dans WooCommerce, notre extension relie le parcours habituel aux moyens disponibles. Le client conserve le contexte de sa commande pendant le paiement. Le choix de l’expérience dépend de la plateforme, du travail de maintenance et des informations à recueillir.
Une API peut parfaitement créer une session sur une page hébergée. L’API décrit la communication entre systèmes ; la page décrit l’endroit où le client paie. Notre guide de la page hébergée et de l’intégration API développe cette différence et les responsabilités associées.
Préparez le terminal pour les opérations proposées
Le terminal de paiement virtuel (TPV) et sa configuration bancaire doivent correspondre à votre parcours. Indiquez si vous souhaitez des achats ponctuels, des portefeuilles numériques ou des abonnements. Chaque modalité exige une préparation ; disposer d’un contrat ne prouve pas que toutes sont activées.
Dans notre intégration WooCommerce, la carte nécessite Redsys inSite. Apple Pay et Google Pay nécessitent X-PAY et les réglages correspondants auprès de la banque et de chaque portefeuille. Les moyens proposés dépendent de leur activation pour le commerce et de l’environnement compatible de l’acheteur.
Pour commencer, indiquez votre banque, la situation du TPV et la plateforme. Ces informations permettent de préciser la préparation et le périmètre. Le guide des banques et du TPV en Andorre aide à organiser cet échange avec votre établissement.
Conservez la relation entre le panier et le paiement
Le montant autorisé doit correspondre à l’achat préparé par le système. Il comprend les produits, variantes, remises et livraison calculés pour cette commande. Si une donnée change avant le paiement, le parcours doit appliquer la mise à jour de manière cohérente.
Modifier le pays de livraison peut, par exemple, changer les options proposées. L’acheteur doit revoir le bon total avant d’autoriser. Utiliser un montant antérieur crée une différence que votre équipe devra ensuite traiter.
Gardez une référence commune entre la commande et l’opération. Après une annulation ou un refus, identifiez également la tentative associée à chaque achat. Vous pourrez ainsi reprendre la vente sans confondre le premier essai avec le résultat du suivant.
Les coordonnées de livraison font partie du parcours
Pour un produit physique, définissez les champs indispensables à l’expédition. Vérifiez l’adresse, les coordonnées et le mode de livraison dans la commande finale. Pour un produit numérique, identifiez le courriel ou le compte qui recevra la ressource.
Les portefeuilles peuvent simplifier la saisie, mais ne supposez pas qu’ils fournissent tous les champs dans chaque situation. Le parcours doit permettre de recueillir les informations manquantes. Incluez les champs personnalisés et les règles liées à l’adresse dans vos essais.
La vérification utile se termine avec une vente qui peut être livrée. Si l’équipe doit contacter le client pour une donnée obligatoire, trouvez l’étape où elle a manqué. Le paiement peut être correct alors qu’un autre élément du parcours nécessite encore un ajustement.
Ce qui doit se passer pendant l’autorisation
Le client sélectionne le moyen et accomplit l’action demandée. Une authentification supplémentaire ou un temps d’attente peut apparaître. La page doit conserver le contexte et expliquer la situation sans encourager à recommencer avant que le résultat soit connu.
Un refus nécessite une sortie compréhensible. Une annulation volontaire doit permettre de revenir au parcours d’achat. Un résultat en attente demande un traitement spécifique puisqu’il ne constitue pas encore une issue définitive.
La documentation du cycle de paiement décrit les états AndorPay. L’équipe d’intégration les utilise pour décider quand proposer une autre tentative et quand continuer à consulter l’opération existante.
Retour du navigateur et confirmation du paiement
La page de remerciement informe l’acheteur, mais ne remplace pas le résultat confirmé par le serveur. Le navigateur peut être fermé avant le retour, et une notification peut arriver plus tard. L’intégration doit couvrir ces deux situations.
Les événements AndorPay communiquent le résultat à votre application. Votre système vérifie la notification puis applique la mise à jour correspondante. Le guide des webhooks explique la connexion et la vérification de signature.
Si la même notification est reçue une seconde fois, elle ne doit pas déclencher une nouvelle livraison. L’application reconnaît l’opération déjà traitée. Ce comportement peut être testé en répétant l’événement prévu pour l’essai, sans créer un nouveau paiement.
Traduisez le résultat financier en statut de commande
Votre équipe travaille avec des états commerciaux : en attente, à préparer, expédiée ou terminée. Leurs règles doivent tenir compte du paiement, mais aussi du produit et du travail de livraison restant.
| Résultat du paiement | Traitement attendu dans la boutique |
|---|---|
| Confirmé | Relier l’opération et appliquer la règle de préparation |
| En attente | Conserver la référence et attendre ou consulter le résultat |
| Action requise | Permettre au client de terminer l’étape demandée |
| Échoué | Garder la commande impayée et proposer la reprise adaptée |
Ne marquez pas une commande livrée uniquement parce qu’elle est payée. Ne réclamez pas non plus un nouveau paiement parce que l’écran de préparation tarde à changer. Identifiez d’abord l’étape terminée et celle qu’il reste à synchroniser.
Préparation concrète dans WooCommerce
Installez la version appropriée de l’extension et ouvrez sa configuration dans les réglages de paiement. Le guide documente les adresses API et de paiement, la clé de test et l’activation des moyens disponibles. Suivre cette séquence maintient les composants dans le même environnement.
Lorsque la connexion est enregistrée, l’extension prépare son identité et les notifications. La route de communication doit être accessible et les tâches planifiées doivent pouvoir s’exécuter. Si un pare-feu bloque une demande, corrigez l’accès précis nécessaire à cette connexion.
La documentation indique comment examiner les tâches planifiées et synchroniser une commande avec AndorPay. Ces outils permettent de retrouver la cohérence avec une opération existante. Terminer manuellement une commande ou demander un autre paiement sans consulter cette opération risque de masquer le problème initial.
Organisez la réponse aux incidents
Si un client indique avoir payé alors que la page attend encore, retrouvez d’abord la commande et l’opération. Consultez le résultat confirmé avant de décider si une nouvelle tentative est nécessaire. La priorité est d’expliquer le déroulement de cet achat.
Si le paiement est confirmé et la commande inchangée, examinez la communication entre les systèmes. Si la commande est correcte mais le courriel absent, le problème concerne l’information du client. Distinguer ces cas évite de modifier inutilement le parcours d’autorisation.
Conservez les références, l’heure et le résultat observé. Il n’est pas nécessaire de demander le numéro complet de carte. Votre équipe a besoin des informations permettant de retrouver le parcours et d’expliquer clairement l’état actuel et la prochaine étape.
Remboursements et annulations nécessitent une procédure
Annuler avant de payer, mettre fin à une prestation et rembourser un encaissement sont des actions distinctes. Définissez les demandes possibles du client et le traitement de chacune. La boutique doit refléter l’opération réellement effectuée.
Notre documentation précise que l’adaptateur Redsys actuel ne prend pas en charge les remboursements par cette API. La procédure est donc définie pour la connexion du commerce avant de proposer son automatisation. Une demande interne ne doit pas être affichée comme un remboursement déjà réalisé.
Reliez ce suivi à la commande et au paiement d’origine. Vous pourrez répondre à une question ultérieure et distinguer une demande de remboursement de son exécution. Les conditions commerciales et les actions de paiement doivent rester cohérentes tout au long du traitement.
Si votre boutique propose des abonnements
La récurrence ajoute un cycle après la première commande. Il faut définir la période, le renouvellement, les changements et la résiliation, ainsi que l’accès ou la livraison correspondante. Une première autorisation réussie ne valide pas l’ensemble du cycle.
Dans AndorPay, ce parcours exige la capacité d’abonnement et une connexion adaptée. L’application utilise les événements et opérations disponibles selon ses règles de service. Notre guide des paiements récurrents avec Redsys présente les préparatifs spécifiques.
En cas de migration, clarifiez le sort des moyens enregistrés et de la prochaine échéance. Ne présumez pas leur portabilité et ne laissez pas deux systèmes programmer la même période. La transition doit attribuer chaque relation à un système et à une date précise.
Préparez des essais représentatifs des ventes
Choisissez des commandes habituelles : produit à expédier, variante, remise si vous en utilisez et ressource numérique si elle existe au catalogue. Vérifiez le total avant l’autorisation et les données conservées après. Il n’est pas nécessaire d’inventer des combinaisons absentes de votre boutique.
Ajoutez un succès, un refus, une annulation et une fermeture du navigateur. Incluez une notification répétée et une confirmation tardive. Pour chaque cas, définissez à l’avance ce que verra le client et l’état attendu par l’équipe. Le test comparera un résultat à une attente concrète.
| Scénario | Point à vérifier |
|---|---|
| Achat habituel | Commande, montant et confirmation correspondent |
| Changement de livraison | Le total revu par le client est utilisé |
| Annulation | L’achat conserve un état compréhensible |
| Réponse tardive | La boutique retrouve le résultat existant |
| Événement répété | Aucun double accès ni double envoi |
| Portefeuille compatible | Autorisation et coordonnées nécessaires présentes |
Le guide de test détaille les environnements et scénarios. Conservez les références de vos essais pour pouvoir analyser un incident sans demander une autre transaction au client.
Faites participer la personne qui prépare les commandes
Demandez-lui de consulter une commande de test depuis son écran habituel. Elle doit reconnaître le produit, le mode de livraison et le résultat du paiement. Les informations utiles au développeur ne sont pas toujours celles dont cette personne a besoin pour agir.
Pour un produit numérique, faites le même exercice avec la personne qui gère l’accès. Si un statut est ambigu, précisez sa signification ou sa règle avant le lancement. Ce contrôle évite qu’une intégration techniquement correcte continue à demander des échanges pour chaque vente.
Mettez en service avec les paramètres de production
Avant l’ouverture, vérifiez le domaine, les identifiants et les moyens activés en production. Si les essais ont utilisé une adresse provisoire, examinez ce qui change avec le domaine final. Gardez une trace de la version et de la connexion effectivement utilisées.
Prévoyez la réponse de l’équipe à un incident lors de l’ouverture. Elle peut consister à arrêter de nouvelles demandes par le moyen concerné pendant l’examen des opérations en attente, en conservant leurs informations. Le client ne doit pas se retrouver avec deux tentatives dont il ignore le résultat.
La mise en service se termine lorsque le parcours publié et sa gestion ont été examinés selon les vérifications prévues. Déployer des fichiers, enregistrer des paramètres ou afficher un bouton constituent des étapes intermédiaires.
Observez les ventes et le travail quotidien après le changement
Examinez les paiements confirmés, les commandes en attente et les demandes d’assistance par appareil et moyen. Si une campagne change en même temps, tenez-en compte : l’origine des visiteurs peut influencer leur comportement d’achat.
Regardez aussi le travail nécessaire pour préparer chaque vente. Une autorisation réussie peut encore s’accompagner de questions sur la livraison ou la confirmation. Ces demandes permettent de repérer la prochaine amélioration utile.
Utilisez les références communes pour analyser des cas précis. L’amélioration doit se traduire par un achat clair et une commande facile à traiter, en plus de l’apparence de la page. Cette base permet d’ajouter des moyens ou des automatisations lorsque votre activité en a besoin.
Questions fréquentes
Faut-il changer de boutique pour utiliser AndorPay ?
Nous examinons la plateforme et le parcours actuel avant de proposer des changements. WooCommerce dispose d’une intégration documentée. Les autres plateformes nécessitent une étude de leurs possibilités et du périmètre adapté à vos ventes.
Peut-on conserver le catalogue WooCommerce ?
Oui. Notre extension utilise les lignes et références calculées par la boutique. Il n’est pas nécessaire de dupliquer ce catalogue dans AndorPay pour cette connexion.
Que se passe-t-il si le client ferme la page après paiement ?
Le résultat doit être récupéré par la communication du serveur et associé à la commande. Le retour du navigateur n’est pas l’unique moyen de recevoir la confirmation.
Quand ajouter de nouveaux moyens de paiement ?
Lorsqu’ils apportent une possibilité utile aux acheteurs et que la connexion est préparée. Vérifiez le parcours complet de chaque moyen, y compris les coordonnées de livraison et le statut final de commande.
Reliez le paiement à toute votre boutique
Indiquez-nous votre plateforme, votre banque et l’amélioration recherchée. Nous examinerons l’achat complet pour vous proposer une intégration AndorPay adaptée.
Découvrez notre TPV virtuel en Andorre et demandez une étude de votre boutique. Le périmètre et les conditions vous seront présentés en privé.
