- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Test d'une intégration des paiements avec redirection
Test d'une intégration des paiements avec redirection
Une fois que vous avez configuré votre compte avec le prestataire de services de site Web de paiement et généré votre intégration, vous devez la tester en utilisant votre profil de commerçant de test (votre ID de commerçant commençant par 'TEST'). Mastercard Gateway propose un simulateur de site Web du prestataire de services de paiement.
Test de l'appel Initiate Browser Payment (Lancer un paiement avec redirection)
Vous pouvez utiliser le champ order.reference lorsque vous effectuez une demande Initiate Browser Payment (Lancer un paiement avec redirection) pour déclencher différentes valeurs pour response.gatewayCode.
Pour une transaction d'annulation, vous devez utiliser le champ
transaction.reference.L'envoi de « .FAIL<code> » dans order.reference retourne :
response.gatewayCode=<code> si <code> est une valeur valide pourresponse.gatewayCode.response.gatewayCode=UNKNOWNsi <code> n'est pas une valeur valide pourresponse.gatewayCode.
Pour les autres paiements avec redirection (Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now, Multibanco, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay)
Vous pouvez utiliser les valeurs suivantes (SANS le préfixe « .FAIL ») dans le champ order.reference lors d'une demande Initiate Browser Payment (Lancer un paiement avec redirection) afin de déclencher différentes valeurs pour response.gatewayCode.
| order.reference | response.gatewayCode | Comportement |
|---|---|---|
| TEST-SUCCEED | APPROVED | La transaction va réussir immédiatement. |
| TEST-FAIL-NOTFOUND | DECLINED | La transaction sera immédiatement refusée. |
| TEST-FAIL-DECLINE | DECLINED | La transaction sera immédiatement refusée. |
| TEST-PENDING | SUBMITTED | La transaction restera en attente indéfiniment. |
| TEST-FAIL-THEN-SUCCESS | SUBMITTED puis DECLINED puis APPROVED |
Après 30 secondes, le simulateur enverra une notification et échouera la transaction. 60 secondes plus tard, le simulateur enverra une autre notification et la transaction aboutira. |
| TEST-FAIL-INIT | SUBMITTED puis DECLINED |
Après 30 secondes, le simulateur enverra une notification et échouera la transaction. |
| TEST-SUCCESS-INIT | SUBMITTED puis APPROVED |
Après 30 secondes, le simulateur enverra une notification et la transaction aboutira. |
| TEST-TIMEOUT-THEN-SUCCESS | SUBMITTED puis ACQUIRER_SYSTEM_ERROR puis APPROVED |
Après 30 secondes, le simulateur enverra une notification et marquera la transaction comme ayant expiré. 60 secondes plus tard, le simulateur enverra une notification et la transaction aboutira. |
| TEST-QUICK-TIMEOUT-THEN-SUCCESS | SUBMITTED puis ACQUIRER_SYSTEM_ERROR puis APPROVED |
Après 5 secondes, le simulateur enverra une notification et marquera la transaction comme ayant expiré. 5 secondes plus tard, le simulateur enverra une notification et la transaction aboutira. |
| TEST-FAIL-TIMEOUT | SUBMITTED puis ACQUIRER_SYSTEM_ERROR |
Après 30 secondes, le simulateur enverra une notification et marquera la transaction comme ayant expiré. |
| TEST-TIMEOUT | TIMED_OUT | Le simulateur imite un scénario d'expiration. La transaction échoue après un délai de 31 secondes. |
| TEST-NO-RESPONSE | UNSPECIFIED_FAILURE | Le simulateur imite un scénario dans lequel la transaction ne pourrait pas être traitée. |
Simuler les résultats d'un prestataire de services de site Web de paiement
Le simulateur de paiement avec redirection :
- A une stratégie de marque de base du prestataire de services de site Web de paiement.
- Est uniquement disponible en anglais.
Pour les paiements PayPal
Une fois votre intégration réussie, l'ID de la sandbox PayPal est défini sur une valeur fictive afin que vous puissiez tester votre intégration avec votre profil de test. Une fois votre autorisation à un tiers accordée, la valeur fictive sera remplacée par l'ID réel du compte PayPal.
- Les détails du paiement indiqués dans la demande Initiate Browser Payment (Lancer un paiement avec redirection) sont affichés.
- Vous devez sélectionner un résultat de paiement PayPal :
SUCCESSPENDINGCANCELUNKNOWNERRORTIMED_OUT- Pour les résultats en attente, vous pouvez simuler l'obtention d'une notification en définissant le délai précédant sa réception et le résultat escompté.
- Une fois que vous avez cliqué sur « Payer maintenant » ou « Continuer », le navigateur est redirigé vers l'URL indiquée dans la demande Initiate Browser Payment (Lancer un paiement avec redirection).
- Utilisez les valeurs suivantes dans le champ
order.referenceoutransaction.referencelorsque vous effectuez une demande Initiate Browser Payment (Lancer un paiement avec redirection) pour déclencher différentes valeurs pourresponse.gatewayCode.Order.Reference ou transaction.reference response.gatewayCode Statut de la commande Comportement PP.400.BADREQUEST DECLINED FAILED La transaction sera immédiatement refusée. PP.PENDING.AUTHORIZATION APPROVED CAPTURED La transaction va réussir immédiatement. PP.PENDING.NONE PENDING CAPTURED La transaction restera en attente indéfiniment. PPP.400.CAPTURE_AMOUNT_LIMIT_EXCEEDED DECLINED FAILED La transaction sera immédiatement refusée. PP.400.TIMEOUT DECLINED FAILED Le simulateur imite un scénario d'expiration. La transaction échoue immédiatement. PP.400.INVALID_REQUEST DECLINED FAILED La transaction sera immédiatement refusée. PP.400.INSUFFICIENT_FUNDS INSUFFICIENT_FUNDS FAILED Le simulateur imite un scénario de fonds insuffisants. La transaction échoue immédiatement. PP.400.ORDER_VOIDED DECLINED FAILED La transaction sera immédiatement refusée.
Si vous intégrez PayPal pour la première fois, vous devez envoyer les valeurs suivantes dans le cadre du champ order.reference tout en testant votre intégration
Utilisez les valeurs suivantes dans le champ order.reference lorsque vous effectuez une demande Initiate Browser Payment (Lancer un paiement avec redirection) pour déclencher différentes valeurs pour response.gatewayCode.
| Order.Reference | response.gatewayCode | Statut de la commande | Comportement |
|---|---|---|---|
| A_M | DECLINED | FAILED | La transaction est immédiatement refusée. |
| P_C | PENDING | CAPTURED | La transaction restera en attente indéfiniment. |
| I_D | DECLINED | FAILED | Ce scénario est destiné à simuler les échecs de financement. Pour plus d'informations, voir la rubrique Gérer les échecs de financement. |
Pour les paiements UnionPay SecurePay
- Les détails du paiement indiqués dans la demande Initiate Browser Payment (Lancer un paiement avec redirection) sont affichés.
- Vous devez sélectionner un numéro de carte pour déclencher un résultat de paiement UnionPay SecurePay :
Numéro de carte de test Code de la passerelle pour la réponse à la transaction 2223000000000007APPROVED 4005550000000019ACQUIRER_SYSTEM_ERROR 4508750015741019UNKNOWN 6011000991300009NOT_SUPPORTED 5149612222222229DECLINED 4012000033330026TIMED_OUT - Lorsque vous cliquez sur « Continuer », le navigateur est redirigé vers l'URL indiquée dans la demande Initiate Browser Payment (Lancer un paiement avec redirection).
Pour les autres paiements avec redirection (Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now, Multibanco, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay)
- Les détails du paiement indiqués dans la demande Initiate Browser Payment (Lancer un paiement avec redirection) sont affichés.
- Vous devez sélectionner un résultat de paiement :
SUCCESSDECLINEBAD_REDIRECT_CHECKSUM(non recommandé pour les tests)
- Pour les résultats en attente, vous pouvez simuler l'obtention d'une notification en définissant le délai précédant sa réception et le résultat escompté.
- Le prestataire de services de paiement avec redirection retournera une URL de redirection qui vous sera transmise.
- Vous devez ensuite rediriger le payeur sur la page spécifique au paiement avec redirection en utilisant l'URL indiquée.
- Une fois les détails du paiement renseignés, le prestataire de services de paiement avec redirection traite la demande de transaction et Mastercard Gateway retourne le payeur sur votre site.
Test des règles de filtrage des transactions pour la plage d'adresses IP
Si vous avez configuré les règles de filtrage de transaction pour une plage d'adresses IP, vous pouvez simuler un rejet pour une adresse IP interdite en définissant les éléments suivants :
- Configurez une plage d'adresses IP à rejeter dans les règles relatives à la plage d'adresses IP dans Merchant Administration.
- Indiquez une adresse IP dans la plage dans le champ
order.referencelors de la soumission d'une demandeInitiate Browser Payment(Lancer un paiement avec redirection).- Pour les paiements avec redirection, Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now,, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay, the value should be submitted in the format '
TEST_IP_ADDRESS<nnn.nnn.nnn.nnn>'.Ce test ne s'applique pas au mode de paiement avec redirection Multibanco. En effet, le navigateur du payeur n'est pas redirigé vers le site Web Multibanco et la passerelle ne peut donc pas extraire l'adresse IP du payeur. - Pour les autres paiements avec redirection, la valeur doit être soumise dans le format «
.TEST_IP_ADDRESS<nnn.nnn.nnn.nnn>».
<nnn.nnn.nnn.nnn> représente un format IPv4 valide qui peut comporter entre 7 et 15 caractères. - Pour les paiements avec redirection, Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now,, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay, the value should be submitted in the format '
Si l'adresse IP entraîne le rejet de la transaction, le code risk.response.gatewayCode est retourné avec la valeur « REJECTED » dans l'opération Retrieve Transaction (Extraire la transaction).
Aucun test spécifique n'est proposé pour simuler le rejet de pays figurant en liste noire dans les règles de filtrage de transaction relatives aux adresses IP ; cependant, vous pouvez simuler ce scénario en ajoutant tous les pays à la liste des rejets.