- 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 MCB Payment 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 MCB Payment Gateway :
- Vous devez être inscrit à UPOP via votre your payment service provider.
- Une fois inscrit pour UPOP, votre profil de commerçant sur MCB Payment 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 3-Party 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 3-Party Checkout. Pour plus d'informations, voir Intégration des paiements avec redirection via 3-Party Checkout.
Choisissez l'intégration 2-Party merchant hosted 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 2-Party merchant hosted.
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 |
| MCB Payment Gateway n'a pas réussi à initier le paiement UnionPay SecurePay. | browserPayment.interaction.status=N/Aresponse.gatewayCode=SYSTEM_ERROR |
| MCB Payment 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 MCB Payment Gateway. |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=DECLINED |
| MCB Payment 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 MCB Payment 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 WebServicesIntegration 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 WebServicesIntegration 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
MCB Payment 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 MCB Payment 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.