Mise en œuvre d'une intégration Hosted Payment Page
Le modèle de Hosted Payment Page vous permet de recueillir les détails du paiement de votre payeur au moyen d'une page Web hébergée et affichée par American Express Payment Gateway, qui gère la sécurité et la conformité PCI pour vous. Avec ce modèle d'intégration, vous ne voyez ni ne gérez jamais directement les détails de paiement, car les détails de paiement collectés sur la page de paiement sont soumis directement du navigateur du payeur au American Express Payment Gateway.
Demander une page de paiement
Vous demandez la Hosted Payment Page en transmettant une requête HTTPS POST à American Express Payment Gateway. Cette étape est essentielle dans l'intégration du commerçant car les données de votre demande déterminent le contenu affiché au payeur sur la page de paiement.
La demande HTTPS POST peut contenir n'importe lequel des champs décrits dans la rubrique Référence de l'API Hosted Payment Page (Page Hosted Payment). Veuillez vous assurer d'inclure tous les champs obligatoires dans votre demande.
Un exemple de code pour une intégration de base de la Hosted Payment Pageest présenté ci-dessous :
<form method="post" action="https://gateway-na.americanexpress.com/api/page/version/36/pay">
<input type="hidden" name="merchant" value="<your_merchant_id>"/>
<input type="hidden" name="order.amount" value="100.00"/>
<input type="hidden" name="order.currency" value="USD"/>
<input type="hidden" name="order.description" value="37 Blue Widgets"/>
<input type="hidden" name="interaction.merchant.name" value="My Merchant Name"/>
<input type="hidden" name="interaction.cancelUrl" value="http://www.mymerchant.com"/>
<input type="submit" value="Checkout"/>
</form>
Faites pointer interaction.cancelUrl vers un URL où vous souhaitez que le navigateur d'un payeur soit redirigé s'il annule son paiement. Il peut s'agir d'un lien vers le panier du payeur ou vers la page d'accueil du site de votre boutique.
Nous vous recommandons d'inclure le champ order.id dans votre demande afin d'identifier facilement un paiement initié à partir de la Hosted Payment Page. Vous pouvez utiliser un identifiant généré par votre panier ou fournir le vôtre ; cependant, assurez-vous qu'il est unique. Si vous n'indiquez pas de valeur dans le champ order.id, American Express Payment Gateway en générera automatiquement une pour vous.
Test de votre intégration
Avant de la mettre en ligne, vous devez tester votre intégration pour vous assurer qu'elle fonctionne correctement.