- Directives d'intégration
- Mise en œuvre d'une intégration de Direct Payment
Mise en œuvre d'une intégration Direct Payment
- Accès à Mastercard Gateway
- Connaissance de vos champs de saisie
- Création d'une demande de transaction
- Envoi d'une demande de transaction
- Traitement de la réponse de transaction
- Test et passage en ligne
- Dépannage et questions fréquentes
- Bonnes pratiques et conseils
- Personnaliser votre intégration Direct Payment
Fonctionnalités Mastercard Gateway prises en charge
Sécurité des paiements et prévention des fraudes
- Mots de passe et certificats
- Authentification 3-D Secure EMV
- Gestion des risques
- Service de vérification d'adresse
- Jetons de cartes stockées de la passerelle
Opérations de paiement
Méthodes de paiement
- Carte de crédit
- Carte de débit
- Titulaire de la carte présent
- UnionPay SecurePay
- PayPal
- Alipay
- Giropay
- iDEAL
- Multibanco
- POLi
- SEPA
- Sofortbanking
- WeChat Pay
- Automated Clearing House
- Cartes-cadeaux
- Click To Pay
- Apple Pay
- Google Pay
- Samsung Pay
Options de paiement
- Demande d'options de paiement
- Échéanciers de paiement
- Conversion de devise dynamique
- Paiements récurrents
- Paiements échelonnés
- Paiements non planifiés
Données supplémentaires
- Données de la compagnie aérienne
- Données Internet du client
- Données de commande et de poste
- Données personnalisées de l'acquéreur
- Données personnalisées du commerçant
- Données de remboursement de dette
- Données de santé
- Données du descripteur de déclaration
- Données de croisière
- Reporting
Reporting
Autres fonctionnalités
Mise en œuvre d'une intégration de Direct Payment
Conditions préalables
- Vérifiez que votre profil de commerçant est activé pour le service DirectAPI.
- Si nécessaire, consultez la procédure pour personnaliser votre solution Direct Payment.
- Avant de commencer l'intégration, voir Pratiques recommandées et conseils.
Étapes d’intégration
Étape 1 : Accès à la passerelle
Tout d'abord, vérifiez votre connectivité à Mastercard Gateway.
Étape 2 : Connaissance de vos champs de saisie
Avant de commencer à créer l'intégration, vous devez préparer les valeurs des champs de saisie.
Étape 3 : Créer la demande de transaction
La création du corps de la demande est une étape essentielle dans l’intégration.
Étape 4 : Envoyer la demande de transaction
Il existe de nombreux composants pour garantir l’envoi sécurisé de la demande de transaction à Mastercard Gateway.
Étape 5 : Traiter la réponse de transaction
Une fois qu’une demande de transaction a été envoyée à la passerelle, vous recevez généralement une réponse dans un très bref délai. Vous devrez la traiter pour mener à bien la transaction.
Étape 6 : Test et passage en ligne
Un test vous permet de vérifier si votre intégration fonctionne comme prévu.
Dépannage et questions fréquentes
Accédez au lien (REST/NVP) [toutes versions] approprié dans la section Documentation du protocole de la page d'index Référence de l'API.
Les noms de champ de l'API de toutes les opérations respectent la casse.
Si vous utilisez HTTP POST, intégrez les paramètres de la recherche dans le corps HTTP en utilisant le codage JSON. Si vous utilisez HTTP GET, veillez à ce que les paramètres de la demande soient inclus dans l'URI en tant que paramètres de requête.
Les champs définis par le commerçant ne sont pas pris en charge dans cette version de Mastercard GatewayDirectAPI.
La transaction identique resoumise renverra la même réponse que la première fois. Dans cette version de Mastercard GatewayDirectAPI, toutes les opérations sont idempotentes (les effets de demandes identiques répétées sont identiques à ceux d'une seule demande). Vous avez donc l'assurance que la transaction ne se répétera pas avec votre banque ou celle du payeur.
À partir de DirectAPI v15, si la transaction initiale d'une commande échoue, vous pouvez soumettre une nouvelle transaction initiale (avec un nouvel ID de transaction) pour cette commande sans être obligé de créer une nouvelle commande.
À partir de la version DirectAPIv15 et suivantes, si vous souhaitez effectuer une transaction Capture ou Refund (Remboursement) ultérieure par rapport à une transaction initiale réussie, vous ne devez PAS fournir les détails de carte dans votre demande. Si vous fournissez les détails de carte alors que la commande dispose déjà d'une transaction initiale réussie, Mastercard Gateway rejette la demande.
Si vous ne recevez pas de réponse, il est recommandé d'attendre 60 secondes et de tenter de resoumettre la demande identique. La transaction bancaire ne se répétera pas et il n'y aura aucun transfert de fonds en double. Vous recevrez le même fichier de réponse que vous auriez reçu pour la première demande.
Toutes les transactions approuvées sont représentées par un code de réponse de transaction APPROVED
provenant de Mastercard Gateway. Tout autre code représente une transaction refusée ou en échec.
La transaction identique resoumise renverra la même réponse que la première fois, car toutes les opérations dans Mastercard Gateway sont idempotentes (les effets secondaires de N > 0 demandes identiques sont semblables à ceux d'une seule demande). Vous avez ainsi l'assurance que la transaction ne se répétera pas avec votre banque ou celle du payeur.
Bonnes pratiques et conseils
Il est fortement recommandé de valider le certificat SSL de Mastercard Gateway chaque fois que vous vous connectez à Mastercard Gateway. Le certificat SSL de Mastercard Gateway est émis par une autorité de certification approuvée comme Verisign ou Thawte dont le certificat racine est déjà disponible dans votre environnement Web.