Andorpay
Retour au blog

Publié le · Mis à jour le

Page de paiement hébergée et API : comment choisir

Comparez page hébergée, API et plugin pour votre entreprise en Andorre. Choisissez le parcours client et le développement que votre équipe maintiendra.

Deux ordinateurs comparent une fenêtre de paiement externe à un paiement intégré à la boutique.

Une page de paiement hébergée et une intégration par API peuvent appartenir à la même solution. La page décrit l’endroit où le client paie ; l’API définit la communication entre votre application et le système d’encaissement. Avec AndorPay, votre serveur peut créer une session par API et diriger l’acheteur vers la page hébergée renvoyée dans la réponse.

Pour une entreprise en Andorre, la décision utile porte sur l’expérience souhaitée et sur le développement que votre équipe maintiendra. Ce guide compare les responsabilités sans supposer que l’utilisation d’une API oblige à construire toute l’interface de paiement.

Trois notions pour comprendre le choix

Une page de paiement hébergée est préparée et servie par la plateforme d’encaissement. Votre entreprise y envoie l’acheteur avec une commande identifiée. Elle utilise ensuite la confirmation pour poursuivre la vente.

Une API définit le contrat de communication entre les systèmes. Elle permet notamment de créer une session ou de consulter des ressources. L’interface vue par l’acheteur et les échanges du serveur sont deux décisions liées, mais distinctes.

Une extension adapte la connexion à une plateforme. Notre extension WooCommerce relie la commande à AndorPay et présente les moyens disponibles dans le parcours habituel. Elle peut éviter du développement spécifique car elle connaît déjà les données et statuts de la boutique.

Notion Question traitée Exemple avec AndorPay
Page hébergée Où le client paie-t-il ? Page ouverte à partir de la session créée
API Comment l’application se connecte-t-elle ? Le serveur crée la session et reçoit son adresse
Extension Comment relier la boutique ? WooCommerce transmet et actualise la commande

Ce que fait votre application avec une page hébergée

Elle commence par identifier l’achat et le client. Elle demande ensuite une session avec les informations requises. La réponse contient l’adresse que l’acheteur doit ouvrir. Le guide REST d’AndorPay documente ce parcours.

Votre application conserve la relation entre commande et session. Lorsqu’elle reçoit un résultat confirmé, elle applique l’action commerciale : préparer un envoi, fournir une ressource ou ouvrir un accès. La page de paiement prend en charge son étape dans cette vente.

Cette répartition permet d’utiliser une interface préparée tout en conservant le lien avec votre activité. Il reste du développement côté serveur et dans le traitement après paiement. Son périmètre se concentre sur votre produit, plutôt que sur la construction de chaque composant de l’autorisation.

Les responsabilités qui restent dans votre entreprise

Vous définissez l’offre, l’identité du client, les informations nécessaires et ce qui sera livré. Dans une application sur mesure, ces règles doivent être représentées par les données et processus. Une plateforme de paiement ne peut pas déduire vos conditions d’accès à partir d’une simple redirection.

Il faut également expliquer le résultat à l’acheteur. Une confirmation claire identifie la commande et l’étape suivante. Un paiement en attente doit être présenté différemment d’un refus ou d’une vente terminée.

Enfin, quelqu’un doit traiter les incidents. Conservez les références de commande et de paiement pour retrouver une opération lorsqu’un client appelle. Ce besoin existe avec une page hébergée comme avec un parcours intégré dans la boutique.

Si vous utilisez déjà WooCommerce

Examinez d’abord l’extension avant d’envisager un développement indépendant. Notre parcours laisse les produits et calculs dans WooCommerce et utilise les lignes et références de commande. Il n’est pas nécessaire de recréer le catalogue dans AndorPay pour cette connexion.

Vérifiez vos champs, règles de livraison et personnalisations. L’extension couvre l’intégration documentée, mais l’essai doit inclure les particularités de votre installation. Si un autre outil reçoit les ventes pour les préparer, ajoutez cette transmission à la vérification.

Le guide WooCommerce présente la configuration actuelle. L’intérêt de l’extension consiste à réutiliser une adaptation existante et à la valider chez vous. Il faut toujours la maintenir et revoir le parcours après une modification des modules qui l’affectent.

Si vous avez une application sur mesure

Identifiez l’endroit où l’achat est créé et le serveur responsable des échanges avec AndorPay. La clé API reste sur ce serveur. Le navigateur reçoit l’adresse de paiement, pas le secret utilisé pour l’obtenir.

L’application ouvre l’adresse renvoyée par l’API. Évitez de la construire manuellement : elle correspond à une session avec ses données et sa durée de validité. Utiliser la réponse documentée vous évite de dépendre du format interne de l’URL.

Connectez ensuite la confirmation. Le guide des webhooks explique la vérification des notifications et leur traitement. Le langage ou SDK facilite l’implémentation des échanges ; les états de votre service restent une décision de conception de l’application.

Comment se répartit la maintenance

Avec une page hébergée, votre équipe maintient la création des sessions, l’accès au paiement, la réception des événements et la livraison. La plateforme maintient la page correspondant à ce parcours. La connexion doit continuer de respecter le contrat utilisé.

Avec une extension, une partie de cette adaptation existe déjà pour la boutique. Le travail porte davantage sur la configuration, les versions et la compatibilité avec les autres modules. Une mise à jour doit être accompagnée d’une vérification des achats habituels.

Une expérience plus personnalisée peut augmenter les éléments que votre équipe doit maintenir. Avant de l’adopter, précisez la différence réellement utile au client et vérifiez qu’elle est permise par la connexion. Une personnalisation apporte de la valeur lorsqu’elle répond à un besoin commercial précis.

Les critères à comparer avant de décider

Le contexte dont l’acheteur a besoin

Vérifiez qu’il reconnaît le produit, le montant et le commerce. Gardez l’offre cohérente entre sa page de présentation et le paiement. Un changement de page se comprend mieux lorsque le même contexte est conservé.

Examinez aussi le retour après un paiement ou une annulation. Le client doit savoir s’il a terminé, s’il attend un résultat ou s’il peut reprendre. Cette clarté dépend de l’intégration et des messages, autant que de l’endroit où le formulaire apparaît.

Le travail disponible dans votre équipe

Une application avec un serveur et des développeurs peut intégrer sessions et événements dans son architecture. Une boutique gérée sans équipe technique peut avoir besoin d’une connexion préparée et d’un accompagnement dans sa configuration.

Déterminez qui maintiendra le système après le lancement. Cette réponse permet de choisir un périmètre durable et une assistance adaptée. Une démonstration rapide à installer ne montre pas comment un incident sera résolu plusieurs mois plus tard.

Les opérations après le paiement

Définissez la relation entre paiements, commandes, abonnements et livraison. Si vous avez des renouvellements, préparez le cycle suivant la première vente. Si un remboursement est nécessaire, identifiez le processus disponible pour votre connexion.

Notre documentation indique que l’adaptateur Redsys actuel ne prend pas en charge les remboursements par cette API. Le choix d’une interface ne transforme pas cette opération en automatisation disponible. Le traitement prévu doit faire partie du projet.

Trois cas pour orienter votre intégration

Une boutique WooCommerce avec catalogue et livraison. Partez de l’extension et vérifiez la relation entre paiement, commande et expédition. Le guide d’intégration ecommerce développe ce parcours.

Une application de services numériques. Le serveur crée la session et la confirmation déclenche la règle d’accès. Une page hébergée peut faire partie de cette intégration API. Identifiez le compte concerné et le traitement des tentatives en attente.

Une prestation vendue après proposition. Un lien et une livraison gérée après paiement peuvent suffire. Avant de développer une connexion, consultez le guide des liens sans programmation. Le travail technique doit correspondre à la vente que vous devez réaliser.

Exemple d’un achat dans une application

Imaginez un service numérique acheté une seule fois. Le client choisit le produit et se connecte à son compte. Le serveur associe l’achat à cette personne, crée la session et transmet l’adresse de paiement au navigateur.

L’acheteur termine l’autorisation. L’application reçoit le résultat confirmé et ouvre l’accès pour ce compte. Si l’onglet est fermé avant le retour, la confirmation du serveur permet de connaître l’issue et d’appliquer les règles prévues.

L’application peut ensuite afficher l’état de l’achat. Si une notification est répétée, elle reconnaît l’opération sans fournir deux fois le même accès. L’exemple utilise l’API et la page hébergée ensemble, avec une répartition précise entre paiement et produit.

Ce qu’il faut vérifier avant l’ouverture

Réalisez une autorisation réussie, un refus et une annulation dans l’environnement de test. Vérifiez la relation entre achat et paiement et l’état final de votre application. Ajoutez une fermeture du navigateur et une confirmation arrivant après le retour.

Répétez une notification pour vérifier l’absence d’effet commercial en double. Examinez la commande pour une boutique et l’accès pour un service. Le guide des tests d’intégration détaille les scénarios et les résultats à conserver.

Vérifiez également le domaine, les identifiants et les moyens activés dans l’environnement public. Un parcours qui fonctionne en test ne prouve pas que la configuration de production est identique. La mise en service comprend les contrôles convenus pour chaque environnement.

Questions fréquentes

Une API impose-t-elle de créer un formulaire de carte ?

Non. L’intégration documentée permet de créer une session et d’utiliser la page hébergée reçue. Votre application conserve le lien avec l’achat et traite la confirmation.

Une page hébergée supprime-t-elle tout développement ?

Cela dépend du parcours. Une application crée des sessions et gère les résultats. Un lien créé depuis le tableau de bord peut couvrir une vente manuelle sans développer ce serveur spécifique.

Peut-on faire évoluer l’expérience ensuite ?

L’évolution doit conserver les commandes, références et règles de confirmation. Définissez le nouveau parcours et vérifiez son remplacement ou sa coexistence avec l’ancien avant d’y envoyer les clients.

Quel est le rôle d’un SDK ?

Il facilite l’utilisation d’une API dans un environnement donné. Il ne décide pas où l’acheteur verra la page. Le guide des SDK et de l’intégration de paiement précise ce rôle.

Définissez l’expérience et le travail à maintenir

Indiquez votre plateforme, le parcours d’achat et la personne qui maintiendra la connexion. Nous préparerons une proposition AndorPay précisant l’expérience, l’intégration et l’accompagnement.

Découvrez notre terminal de paiement virtuel en Andorre et demandez une proposition pour votre intégration. Le périmètre et les conditions sont présentés en privé.

WhatsApp