Mise en œuvre d'une intégration Hosted Payment Page

Cette page porte sur une ancienne fonctionnalité. Le protocole de la Hosted Payment Page a été rendu obsolète par l'intégration JavaScript de Hosted Checkout. Plus d'informations sur la manière d'obtenir le résultat du paiement et de personnaliser davantage votre intégration sont disponibles sur la Hosted Checkout 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 Mastercard 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 Mastercard Gateway.

Demander une page de paiement Copied to Clipboard

Vous demandez la Hosted Payment Page en transmettant une requête HTTPS POST à Mastercard 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://network.gateway.mastercard.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, Mastercard Gateway en générera automatiquement une pour vous.

Par défaut, votre configuration commerçant détermine les fonctionnalités proposées sur la page de paiement à votre payeur. Par exemple, les modes de paiement (cartes de crédit, PayPal, etc.), les sources de transactions (Internet, centre d'appels, etc.), les options de paiement (échéanciers de paiement), le service 3-D Secure, la gestion des risques, etc.

Test de votre intégration Copied to Clipboard

Avant de la mettre en ligne, vous devez tester votre intégration pour vous assurer qu'elle fonctionne correctement.