- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Paiements UnionPay SecurePay
UnionPay SecurePay
UnionPay International via UnionPay Online Payment (UPOP), système de paiement global pour les transactions de commerce électronique, propose UnionPay SecurePay comme service permettant aux payeurs de faire des achats en ligne en utilisant leur compte SecurePay UPOP sur le site Web UnionPay SecurePay.
UnionPay SecurePay est un mode de paiement avec redirection pris en charge dans le Mastercard Gateway. Cette page décrit les détails d'intégration spécifiques à UnionPay SecurePay. Il est recommandé de lire les consignes d'intégration pour les paiements avec redirection avant de créer une UnionPay SecurePay intégration.
Conditions préalables
Pour proposer UnionPay SecurePay comme mode de paiement via Mastercard Gateway :
- Vous devez être inscrit à UPOP via votre your payment service provider.
- Une fois inscrit pour UPOP, votre profil de commerçant sur Mastercard Gateway doit être configuré par votre your payment service provider en utilisant les détails de votre compte pour UPOP.
- Vos pages de paiement doivent être conformes aux exigences de la marque UnionPay SecurePay. Voir UnionPay International Acceptance Guide for e-Commerce merchants.
Intégration UnionPay SecurePay
Avec les Hosted Checkout intégrations version 34 et ultérieures, UnionPay SecurePay est automatiquement disponible lorsque votre your payment service provider a configuré le lien acquéreur pour UnionPay SecurePay.
interaction.timeout pour limiter le temps dont dispose un payeur pour terminer sa commande, lorsque le temps restant avant que le paiement n'expire est inférieur à 900 secondes, le payeur ne se voit plus proposer la possibilité de sélectionner UnionPay SecurePay comme option de paiement dans Hosted Checkout. Pour plus d'informations, voir Intégration des paiements avec redirection via Hosted Checkout.
Choisissez l'intégration Direct Payment si vous voulez proposer le mode de paiement UnionPay SecurePay sur votre propre page de paiement.
Effectuez une demande Initiate Browser Payment où sourceOfFunds.type = UNION_PAY. Pour d'autres détails, voir Intégration des paiements avec redirection via Direct Payment.
Comment interpréter le résultat de la transaction
Le tableau ci-dessous présente les codes de réponse de transaction pour les scénarios possibles que vous pouvez rencontrer après avoir lancé un UnionPay SecurePay paiement avec redirection.
| Scénario | Réponse Retrieve Transaction/Retrieve Order (Extraire une transaction/Extraire une commande) |
|---|---|
| TRANSACTION SUCCESSFUL | |
| Le paiement a réussi. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=APPROVED |
| TRANSACTION NOT SUCCESSFUL | |
| Le paiement a été refusé par l'acquéreur. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=DECLINED |
| Le paiement n'a pas réussi, l'acquéreur n'ayant pas pu le traiter. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=ACQUIRER_SYSTEM_ERROR |
| Mastercard Gateway n'a pas réussi à initier le paiement UnionPay SecurePay. | browserPayment.interaction.status=N/Aresponse.gatewayCode=SYSTEM_ERROR |
| Mastercard Gateway a reçu le navigateur du payeur et l'a redirigé vers UnionPay SecurePay. Aucun paiement n'a eu lieu dans les 2 heures. Les demandes de redirection pour ce paiement sont rejetées par Mastercard Gateway. |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=DECLINED |
| Mastercard Gateway n'a pas reçu de redirection du navigateur du payeur de la part du commerçant dans les 24 heures. Aucun paiement n'a eu lieu et toute demande de redirection pour ce paiement est rejetée par Mastercard Gateway. |
browserPayment.interaction.status=INITIATEDresponse.gatewayCode=TIMED_OUT |
| RÉSULTAT DE LA TRANSACTION ENCORE INCONNU (EN COURS) | |
| La transaction a été initiée avec succès sur la passerelle. La passerelle n'a pas encore reçu le navigateur du payeur de la part du commerçant pour une redirection vers UnionPay SecurePay. Aucun paiement n'a encore eu lieu. | browserPayment.interaction.status=INITIATEDresponse.gatewayCode=SUBMITTED |
| La passerelle a reçu le navigateur du payeur et l'a redirigé vers UnionPay SecurePay. Aucun paiement n'a encore eu lieu. |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=SUBMITTED |
| La passerelle a renvoyé le navigateur du payeur vers le commerçant. La passerelle essaie actuellement de savoir si le paiement a réussi ou échoué. |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=SUBMITTED |
| La passerelle n'a pas réussi à savoir si le paiement a réussi ou échoué. La passerelle peut encore continuer la recherche et mettre à jour la transaction. Vous pouvez effectuer un suivi avec une demande Retrieve Transaction [Extraire la transaction] (la passerelle pouvant avoir trouvé le résultat) ou utiliser les notifications Webhook de la passerelle (si vous êtes abonné). |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=UNKNOWN |
| STATUT DE LA TRANSACTION INCONNU | |
| La passerelle n'a pas réussi à savoir si le paiement a réussi ou échoué. La passerelle n'essaie plus de connaître le résultat. Pour le connaître, vous devez contacter l'acquéreur. |
browserPayment.interaction.status=N/Aresponse.gatewayCode=UNKNOWN |
Collectes et remboursements
Vous pouvez effectuer des collectes ou des remboursements ultérieurs sur des commandes UnionPay SecurePay en utilisant des opérations Capture/Refund (Collecter/Rembourser) de DirectAPI ou via Merchant Administration.
Annulations
Vous pouvez effectuer des transactions Void (Annuler) sur des commandes UnionPay SecurePay en utilisant une opération Void (Annuler) de DirectAPI ou via Merchant Administration. Seules les transactions Authorize (Autoriser), Capture (Collecter) et Pay (Payer) sont prises en charge pour les annulations.
Test de votre intégration
Mastercard Gateway fournit un émulateur UnionPay SecurePay qui permet de tester votre intégration UnionPay SecurePay.
Dépannage et questions fréquentes
Retrieve Transaction réponse ?Votre compte de commerçant chez UPOP peut être configuré pour ne pas renvoyer le numéro de carte. Dans ce cas, aucun numéro de carte n'est retourné dans la réponse Retrieve Transaction. Contactez votre your payment service provider si vous souhaitez modifier cette configuration chez UPOP.
Si Mastercard Gateway n'a pas pu identifier le système et la marque de la carte associés à la carte du payeur, Retrieve Transaction retourne sourceOfFunds.provided.card.scheme=OTHER et sourceOfFunds.provided.card.brand=UNKNOWN.