Web-Services API Étapes d'intégration
Pour implémenter la solution de base Web-Services API dans votre système, suivez les instructions.
Conditions préalables
Avant de mettre en œuvre une solution Web-Services API, vérifiez auprès de votre your payment service provider que vous remplissez les conditions préalables suivantes :
- Assurez-vous que vous disposez d'un profil de commerçant qui doit être compatible avec l'API.
- Sélectionnez et configurez votre méthode d'authentification API.
Implémenter une solution Web-Services API
La solution Web-Services API fonctionne par le biais d'opérations d'API (demandes et réponses), qui sont utilisées pour, par exemple, lancer ou récupérer des informations sur différentes transactions de paiement et stocker les détails des cartes. Vous pouvez utiliser toutes les opérations d'API disponibles pour les API du serveur REST. Cependant, vous n'avez pas besoin des opérations d'API liées à Hosted Checkout et Hosted Session car elles ne sont nécessaires que pour les méthodes d'intégration associées. Pour des informations générales sur la création de requêtes API de serveur, voir Création d'une requête API de serveur.
Pour effectuer une opération, vous devez au préalable l'activer sur votre profil de commerçant par votre your payment service provider. Pour vérifier quelles opérations sont disponibles pour vous ou pour résoudre les erreurs d'API, contactez votre your payment service provider
Les opérations disponibles sont limitées par la capacité des acquéreurs configurés sur votre profil de commerçant auprès de American Express Payment Gateway. Lorsqu'une fonctionnalité n'est pas prise en charge pour l'acquéreur sur la passerelle, les demandes d'opération exécutant cette fonctionnalité sont rejetées par la passerelle (pour cet acquéreur).
Chaque tâche que vous effectuez avec le Web-Services API se compose des étapes suivantes :
- Définissez les données nécessaires Définissez les détails du paiement et les autres données associées requises pour créer la demande de transaction.
- Envoyer une demande Créez une demande de transaction et envoyez-la à la passerelle.
- Interprétez la réponse Décodez et analysez la réponse à votre demande de transaction et prenez les mesures appropriées pour finaliser la transaction.
Pour obtenir des exemples de demandes, couvrant les demandes d'opérations de transaction courantes, téléchargez la collection Postman.
Une fois l'intégration terminée, vous pouvez gérer les demandes et les réponses de base :
- Tenez compte de vos cycles de vie de paiement et de vos besoins pour toute opération ultérieure une fois la transaction de paiement de base terminée.
- Déterminez les personnalisations nécessaires en fonction des modes de paiement spécifiques que vous souhaitez prendre en charge.
- Réfléchissez au type de sécurité ou aux autres fonctionnalités supplémentaires que vous souhaitez proposer ou utiliser dans votre intégration.
- Testez l'intégralité de votre solution.