- Directives d'intégration
- Fonctionnalités prises en charge (Méthodes de paiement)
- Mise en œuvre d'une intégration du paiement avec redirection
- Paiements UnionPay SecurePay
Intégration UnionPay SecurePay
- Conditions préalables
- Intégration UnionPay SecurePay
- Comment interpréter le résultat de la transaction
- Collectes et remboursements
- Annulations
- Tester l'intégration UnionPay SecurePay
- Dépannage et questions fréquentes
Paiements UnionPay SecurePay
UnionPay International via le système 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 une méthode de paiement avec redirection prise en charge sur Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à UnionPay SecurePay. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une interaction UnionPay SecurePay.
Conditions préalables
Pour proposer UnionPay SecurePay comme méthode de paiement via Mastercard Gateway :
- Vous devez être inscrit pour UPOP via votre fournisseur de services de paiement.
- Une fois inscrit pour UPOP, votre profil de commerçant sur Mastercard Gateway doit être configuré par votre fournisseur de services de paiement 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 de UnionPay SecurePay
Avec les intégrations Hosted Checkout version 34 et ultérieure, UnionPay SecurePay est automatiquement disponible lorsque votre fournisseur de services de paiement a configuré le lien d'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 à 840 secondes, le payeur ne se voit plus proposer la possibilité de sélectionner UnionPay SecurePay comme option de paiement dans Hosted Checkout. Pour plus de détails, voir Intégration des paiements avec redirection via Hosted Checkout.
Choisissez l'intégration Direct Payment si vous voulez proposer la méthode 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 illustre les codes de réponse de transaction pour les scénarios possibles auxquels vous pouvez devoir faire face après avoir initié un paiement avec redirection UnionPay SecurePay.
Scénario | Réponse Retrieve Transaction/Retrieve Order (Extraire la transaction/Extraire la commande) |
---|---|
TRANSACTION RÉUSSIE | |
Le paiement a réussi. | browserPayment.interaction.status=COMPLETED response.gatewayCode=APPROVED |
TRANSACTION NON RÉUSSIE | |
Le paiement a été refusé par l'acquéreur. | browserPayment.interaction.status=COMPLETED response.gatewayCode=DECLINED |
Le paiement n'a pas réussi, l'acquéreur n'ayant pas pu le traiter. | browserPayment.interaction.status=COMPLETED response.gatewayCode=ACQUIRER_SYSTEM_ERROR |
Mastercard Gateway n'a pas réussi à initier le paiement UnionPay SecurePay. | browserPayment.interaction.status=N/A response.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_PROVIDER response.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=INITIATED response.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=INITIATED response.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_PROVIDER response.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_MERCHANT response.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_MERCHANT response.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/A response.gatewayCode=UNKNOWN |
Captures et remboursements
Vous pouvez exécuter d'autres captures ou remboursements sur les commandes UnionPay SecurePayà l'aide des opérations Capture/Refund (Capturer/Rembourser) DirectAPI ou via Administration du commerçant.
Annulations
Vous pouvez exécuter des transactions Void (Annulation) sur des commandes UnionPay SecurePay à l'aide de l'opération Void (Annulation) DirectAPI ou via Administration du commerçant. Seules les transactions Authorize (Autoriser), Capture (Capturer) 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
?Votre compte de commerçant sur UPOP peut être configuré de manière à ce qu'UPOP ne retourne pas le numéro de carte. Dans ce cas, aucun numéro de carte n'est retourné dans la réponse Retrieve Transaction
. Contactez votre fournisseur de services de paiement si vous souhaitez modifier cette configuration pour 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
.