- Directives d'intégration
- Mise en œuvre d'une intégration Direct Payment
- Créer la demande de transaction
Créer la demande de transaction
La création du corps de la demande est une étape critique dans l'intégration du commerçant. Les champs du formulaire présenté au payeur ainsi que vos champs de configuration sont transmis à l'URL Mastercard GatewayDirectAPI à l'aide de la méthode HTTPS POST/PUT/GET en fonction du protocole choisi (REST-JSON/NVP) et de l'opération de la transaction.
Le formulaire présenté au payeur doit uniquement exposer les champs qui nécessitent la saisie de données.
Des exemples de formulaires HTML pour les opérations de base telles que l'autorisation, la collecte, le remboursement et le paiement ont été inclus dans l'exemple de code. Voir Téléchargements.
Formatage des données pour la demande de transaction
Quelle que soit votre langue ou votre protocole, il est important que votre intégration formate correctement les données ou le corps de la demande de transaction. Dans de nombreuses langues, il est courant de recevoir les données saisies par un payeur dans un formulaire sous forme de tableau. Dans la plupart des cas, il convient alors d'utiliser une structure de tableau, au format indiqué ci-dessous, pour stocker les noms et les valeurs des champs que vous prévoyez transmettre à Mastercard Gateway.
Les extraits de code ci-dessous remplissent deux fonctions essentielles pour aboutir à un corps de demande de transaction correctement formaté :
- Veillez à n'ajouter aucun champ vide au corps de la demande de transaction.
- Formatez les données selon les exigences de chaque protocole (Paire nom-valeur pour NVP ou JSON pour REST).