- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
Mise en œuvre d'une intégration des paiements avec redirection
Les modes de paiement avec redirection permettent à un payeur de payer en ligne pour des biens et services sur le site Web du prestataire de services de paiement avec redirection. Mastercard Gateway redirige le navigateur du payeur sur le site Web du prestataire de services de paiement avec redirection, où il se connecte, sélectionne les détails de la carte, vérifie le paiement et termine l'interaction.
Mastercard Gateway prend en charge les modes de paiement avec redirection suivants :
- Alipay
- Bancontact
- Boleto Bancário
- iDEAL
- Klarna Financing
- Klarna Pay Later
- Klarna Pay Now
- Multibanco
- OXXO
- PayPal
- POLi
- SEPA
- UnionPay SecurePay
- WeChat Pay
Conditions préalables
Pour mettre en œuvre les paiements avec redirection via Mastercard Gateway, vous avez besoin des éléments suivants :
- Un compte auprès du prestataire de services de paiement avec redirection.
- Une page sur le site de votre magasin sur laquelle Mastercard Gateway redirige le navigateur du payeur lorsque l'interaction est terminée.
Nous vous recommandons de vous abonner au service de notifications afin de recevoir des notifications (par e-mail/Webhook) si le paiement a eu lieu. Mastercard Gateway (à votre nom) vous permet également d'envoyer des notifications par e-mail au payeur.
Intégration des paiements avec redirection via Hosted Checkout
Si vous avez une intégration Hosted Checkout existante, le mode de paiement avec redirection est automatiquement disponible dès que votre your payment service provider termine avec succès la configuration de votre profil de commerçant sur Mastercard Gateway avec le lien d'acquéreur pour le prestataire de services de paiement avec redirection.
Le diagramme suivant illustre le flux de paiement avec redirection dans un modèle Hosted Checkout :
- Vous initiez une interaction Hosted Checkout lorsque le payeur est prêt à payer sur le site de votre magasin. Mastercard Gateway affiche l'interface de paiement que vous avez choisie : une lightbox ou une page Hosted Payment.
- L'interface de paiement est affichée au payeur, le mode de paiement avec redirection figurant comme option de paiement.
- Lorsque le payeur sélectionne le mode de paiement avec redirection, Mastercard Gateway redirige le navigateur du payeur sur le site Web du prestataire de services de paiement avec redirection, afin qu'il se connecte et sélectionne les détails du paiement ou effectue le paiement.
- Lorsque l'interaction du payeur sur le site Web du prestataire de services de paiement avec redirection est terminée, le résultat du paiement s'affiche au payeur via :
- Reçu hébergé : le résultat du paiement est affiché sur la page Hosted Payment/la lightbox. Il s'agit du comportement par défaut.
- Reçu sur le site de votre magasin : vous pouvez choisir d'afficher le résultat du paiement au payeur sur le site de votre magasin. Pour des instructions d'intégration, voir Rediriger le payeur sur le site de votre magasin.
Le payeur peut également obtenir le résultat d'un paiement réussi via des notifications par e-mail envoyées par Mastercard Gateway — vous devez vous abonner aux notifications de payeur dans Merchant Administration.
Récupération du résultat de la transaction
Vous pouvez utiliser Merchant Administration ou exécuter une opération Retrieve Order/Retrieve Transaction (Extraire la commande/Extraire la transaction) pour savoir si le paiement a réussi ou échoué. Voir la rubrique « Comment interpréter le résultat de la transaction » sur la page d'intégration spécifique au paiement avec redirection.
Vous pouvez également savoir si le paiement a réussi via votre intégration (uniquement si vous choisissez de rediriger le payeur sur le site de votre magasin) ou via le service de notifications (e-mail/Webhook).
Intégration des paiements avec redirection via Direct Payment
Le diagramme suivant illustre le flux de paiement avec redirection dans un modèle Direct Payment :
Les étapes d'intégration pour un paiement avec redirection via l'intégration Direct Payment sont les suivantes :
Lorsque le payeur sélectionne un mode de paiement avec redirection, exécutez une opération Initiate Browser Payment (Lancer un paiement avec redirection) pour indiquer les informations sur la commande et obtenir l'URL de redirection pour le mode de paiement avec redirection. Vous devez indiquer les informations suivantes dans la demande d'opération Initiate Browser Payment (Lancer un paiement avec redirection) :
order.amount: montant de la commande.order.currency: devise dans laquelle est payée la commande.sourceOfFunds.type: mode de paiement avec redirection. Par exemple, PAYPAL, UNION_PAY.browserPayment.returnUrl: URL de retour, qui correspond à une page sur votre site Web. Le navigateur du payeur est redirigé sur cette page lorsque le paiement sur le site Web du prestataire de services de paiement avec redirection a eu lieu. Vous souhaiterez peut-être inclure des informations dans l'URL de retour pour identifier la commande du payeur sur votre site Web.browserPayment.operation: type de transaction que vous souhaitez créer lorsque le payeur termine l'interaction. Deux options sont possibles :
- Transaction
Authorize— (Autoriser) dans laquelle le paiement est autorisé auprès de la source de financement sous-jacente du payeur, mais pas immédiatement collectée. - Transaction
Pay— (Payer) dans laquelle le paiement est autorisé et, s'il réussit, immédiatement collecté.
Notez que Mastercard Gateway ignore les privilèges configurés sur votre compte de commerçant sur Mastercard Gateway.
PayPal et UnionPay SecurePay prennent en charge les opérations Authorize (Autoriser) et Pay (Payer) ; les autres modes de paiement avec redirection (Sofortbanking, Giropay, BancaNet) ne prennent en charge que l'opération Pay (Payer).- Transaction
Vous pouvez également indiquer des détails supplémentaires sur la commande, par exemple, l'adresse de facturation, l'adresse d'expédition, les détails du client, etc.
Référence de l'API Initiate Browser Payment (Lancer un paiement avec redirection)[REST][NVP]
Utilisez l'URL browserPayment.redirectUrl indiquée dans la réponse Initiate Browser Payment (Lancer un paiement avec redirection) pour rediriger le navigateur du payeur sur le site Web du prestataire de services de paiement avec redirection.
Lorsque l'interaction du payeur sur le site Web du prestataire de services de paiement avec redirection est terminée, Mastercard Gateway redirige le navigateur du payeur sur le site de votre magasin à l'aide de l'URL browserPayment.returnUrl indiquée dans la demande Initiate Browser Payment (Lancer un paiement avec redirection). Le site de votre magasin doit identifier la commande à l'aide des informations indiquées dans l'URL de retour.
Si le navigateur du paiement ne revient pas dans une plage de temps donnée, exécutez une opération Retrieve Transaction (Extraire la transaction) (voir l'étape 4) pour connaître le statut de l'interaction et/ou savoir si le paiement a réussi ou échoué.
Après avoir reçu le navigateur du payeur, utilisez Retrieve Transaction (Extraire la transaction) pour savoir si le paiement a réussi ou échoué.
La réponse Retrieve Transaction (Extraire la transaction) contient les détails de la commande et, suivant le mode de paiement, peut contenir des détails sur le payeur retournés par le prestataire de services de paiement avec redirection.
Utilisez les informations indiquées pour afficher le résultat de la transaction au payeur. Voir la rubrique « Comment interpréter le résultat de la transaction » sur la page d'intégration spécifique au paiement avec redirection.
Si la transaction n'a pas réussi, reprenez les étapes 1 à 4 en utilisant le même ID de commande.
Référence de l'API Retrieve Transaction (Extraire la transaction) [REST][NVP]
Tester une intégration de paiement avec redirection
Pour plus d'informations sur les tests des modes de paiement avec redirection pris en charge, voir Test des intégrations de paiement avec redirection.
Dépannage et questions fréquentes
Vous pouvez voir l'avancement d'un paiement avec redirection à l'aide du champ browserPayment.interaction.status et des champs de temps correspondants retournés dans la réponse Retrieve Transaction/Retrieve Order (Extraire la transaction/Extraire la commande).
browserPayment.interaction.status=INITIATEDbrowserPayment.interaction.timeInitiated=<la date et l'heure auxquelles le paiement a été correctement lancé sont définies>browserPayment.interaction.status=REDIRECTED_TO_PROVIDERbrowserPayment.interaction.timeRedirected=<la date et l'heure auxquelles le navigateur du payeur a été reçu depuis le site de votre magasin et redirigé sur le site Web du prestataire de paiement avec redirection sont définies>browserPayment.interaction.status=RETURNED_TO_MERCHANTbrowserPayment.interaction.timeReturned=<la date et l'heure auxquelles le navigateur du payeur a été reçu depuis le site Web du prestataire de paiement avec redirection et redirigé sur le site de votre magasin sont définies>browserPayment.interaction.status=COMPLETEDbrowserPayment.interaction.timeCompleted=<la date et l'heure auxquelles le paiement a eu lieu sont définies>
Ces champs peuvent être utiles à des fins de dépannage.