Andorpay
Retour au blog

Publié le · Mis à jour le

SDK ou API de paiement : comment choisir votre intégration ?

Vérifiez maintenance, compatibilité et tests avant d’adopter un SDK. Distinguez la connexion au prestataire de la gestion de vos commandes.

Des modules d’intégration relient un ordinateur à une carte de paiement.

Un SDK peut simplifier les appels à une API de paiement, mais il ne décide pas du fonctionnement de vos commandes ou abonnements. Choisissez-le selon le contrat du prestataire, le langage du projet et la maintenance que vous pourrez assurer.

Quel travail peut-il prendre en charge ?

Une bibliothèque peut aider à préparer les requêtes, signatures, réponses et erreurs. Vérifiez son périmètre. Recevoir un objet de paiement ne signifie pas que la vente a été mise à jour, le document envoyé ou le service ouvert.

Avant d’ajouter la dépendance

Vérification Élément à rechercher
Origine Bibliothèque officielle ou projet tiers clairement identifié
Compatibilité Versions du langage, de l’environnement et de l’API
Maintenance Versions récentes et traitement des incidents
Contrat Opérations, paramètres et erreurs disponibles
Intégration sécurisée Validation des réponses et gestion des secrets
Tests Exemples reproductibles dans l’environnement de test

Une bibliothèque portant le nom du processeur n’est pas nécessairement officielle. Conservez la version vérifiée : les instructions d’une autre version peuvent ne pas convenir.

SDK et API directe : la même logique métier reste à traiter

Avec un SDK, une dépendance prend en charge une partie de la connexion. Avec des appels directs, vous assumez davantage de préparation et de maintenance. Dans les deux cas, l’application doit relier vente, demande de paiement et résultat. Les deux approches peuvent utiliser la même API.

Le parcours minimal est le suivant : montant déterminé par l’application → opération créée → paiement du client → résultat validé par le serveur → vente mise à jour une seule fois.

Quels scénarios tester ?

Vérifiez réponse valide, réponse invalide, refus, délai dépassé et notification répétée. Un délai dépassé laisse un résultat à vérifier ; il n’autorise pas à demander automatiquement un nouveau paiement. Notre matrice de tests distingue ces situations.

Pour choisir aussi la présentation du paiement, consultez page hébergée et API. Une page hébergée peut elle-même être reliée par API.

Commencez par la documentation AndorPay, en espagnol, puis vérifiez les opérations dans la documentation du prestataire avant l’intégration.

WhatsApp