Personnalisation de l'expérience de paiement
Si vous utilisez Hosted Checkout, vous pouvez personnaliser l'affichage des informations sur la Hosted Payment Page pour ce qui concerne votre entreprise et l'interaction avec le payeur. Les personnalisations sont définies dans l' INITIATE CHECKOUT opération.
Vous pouvez personnaliser l'expérience de paiement avec les options suivantes :
- Afficher les informations relatives à la marque : Vous pouvez afficher votre logo et vos coordonnées en utilisant les champs correspondants dans l'objet
interaction.merchant.Les champs fournis dans l'objetinteraction.merchantsont affichés sur la page de reçu pour les intégrations de page de paiement uniquement, et non pour la page intégrée. - Gérer l'affichage des adresses de facturation et e-mail des payeurs : après avoir collecté les adresses de facturation et électronique de votre payeur, vous pouvez les afficher et contrôler la manière dont elles peuvent être modifiées en définissant les champs
interaction.displayControl.billingAddressetinteraction.displayControl.customerEmailavec l'une des valeurs suivantes : - HIDE : ne pas afficher l'adresse.
- MANDATORY : afficher l'élément d'adresse et rendre la saisie des données obligatoire pour le payeur.
- OPTIONAL : afficher l'élément d'adresse, mais permettre au payeur de ne pas saisir de données dans cet élément.
- READ_ONLY : afficher l'adresse, mais ne permettre pas au payeur de la modifier.
- Gérer l'affichage des détails d'expédition : après avoir obtenu les détails d'expédition auprès du payeur, vous pouvez contrôler leur affichage en définissant le champ
interaction.displayControl.shippingselon l'une des valeurs suivantes : - HIDE : ne pas afficher les détails d'expédition.
- READ_ONLY : afficher les détails de l'expédition, mais permettre au payeur de ne pas saisir de données dans cet élément.<
- Le payeur n'est pas en mesure de modifier les détails d'expédition précédemment fournis.
- La fonctionnalité de la case à cocher Identique à l'expédition n'est pas disponible si les détails d'expédition requis n'ont pas été fournis.
- Gérer la langue et le thème : Par défaut, la langue affichée avec la Hosted Payment Page est déterminée à partir du navigateur du payeur. Toutefois, vous pouvez ignorer ce comportement en spécifiant un identifiant de langue ou une balise de langue IETF dans le champ de paramètre régional, par exemple, en_US, es, ou fr_CA. Si la langue que vous spécifiez n'est pas prise en charge par la passerelle, la page s'affiche dans la langue la mieux adaptée.
- ID de commande : Il est obligatoire d'inclure
order.iddans votre demande afin identifier facilement un paiement initié à partir de Hosted Checkout. Vous pouvez utiliser un identifiant généré par votre panier d'achat ou fournir le vôtre. Vérifiez toutefois qu'il est unique.
Avertissement
Pour plus d'informations sur les champs individuels, voir INITIATE CHECKOUT.
Exemple de demande de lancement de paiement avec des détails personnalisés
| URL | https://test-nbe.gateway.mastercard.com/api/rest/version/{version}/merchant/{merchant_ID}/session |
| Méthode HTTP | POST |
{
"apiOperation": "INITIATE_CHECKOUT",
"interaction": {
"merchant": {
"name": "The Company Co",
"url": "https://www.merchant-site.com",
"logo": "https://upload.wikimedia.org/wikipedia/commons/2/21/Verlagsgruppe_Random_House_Logo_2016.png"
},
"displayControl": {
"billingAddress": "MANDATORY",
"customerEmail": "MANDATORY"
},
"timeout": 1800,
"timeoutUrl": "https://www.google.com",
"cancelUrl": "http://www.google.com",
"operation": "PURCHASE",
"style": {
"accentColor": "#30cbe3"
}
},
"billing": {
"address": {
"city": "St Louis",
"stateProvince": "MO",
"country": "USA",
"postcodeZip": "63102",
"street": "11 N 4th St",
"street2": "The Gateway Arch"
}
},
"order": {
"amount": "123.60",
"currency": "EUR",
"description": "This is the order description",
"id": "ORDER-4142773a-ac2e"
},
"customer": {
"email": "peteMorris@mail.us.com",
"firstName": "John",
"lastName": "Doe",
"mobilePhone": "+1 5557891230",
"phone": "+1 1234567890"
}
}
Questions fréquentes
Existe-t-il des restrictions liées à la taille de fichier et aux dimensions du logo du commerçant affiché sur la page de paiement ?
Il n'y a aucune restriction sur la taille du fichier ou la largeur du logo. La hauteur du logo doit être d'au moins 144 px.
Puis-je utiliser n'importe quel prestataire d'hébergement pour héberger l'image du logo ?
Oui, vous pouvez héberger l'image de votre logo sur n'importe quel prestataire, à condition que l'URL soit sécurisée (HTTPS). Si vous recherchez un prestataire capable de proposer un hébergement HTTPS gratuit, voir les prestataires d'hébergement sécurisé d'images.