Hosted Checkout Page

Understand 3-D Secure statuses

To help you keep track of your transactions and their 3-D Secure status, it is important to differentiate between a transactions': 

• 3-D Secure status: The result of the authentication check provided by your customer’s issuer. We return this result in property paymentOutput.cardPaymentMethodSpecificOutput.threeDSecureResults.eci in GetPayment/GetPaymentDetails requests
• Global transaction status: The result of the authorisation request provided by your acquirer for the gross amount (as defined in your CreatePayment/CreateHostedCheckout request in property order.amountOfMoney.amount). We return this result in property statusOutput.statusCode. Learn more about the global transaction status and all possible outcomes

The table below gives you a full overview of possible scenarios and how our platform displays them to you:

Étapes d'intégration

À un moment donné du processus de paiement, vous redirigez vos clients vers notre page de paiement sécurisée. Ils saisissent leurs informations de carte, nous les envoyons à votre acquéreur et vous fournissons le résultat.

Découvrez comment fonctionne l'ensemble du flux de transaction et ce que vous devez faire à chaque étape.

URLs des points de terminaison cibles en mode test / en production

Notre plateforme vous permet d'envoyer des requêtes soit vers notre environnement de test, soit vers l'environnement de production :

• URL du point de terminaison TEST : MERCHANT_ID/hostedcheckouts
• URL du point de terminaison LIVE : MERCHANT_ID/hostedcheckouts

Si vous utilisez nos SDK Serveur, votre application ciblera automatiquement l'URL de l'environnement respectif / mode d'intégration via des instances de CommunicatorConfiguration / IClient / CreateHostedCheckoutRequest. Des informations détaillées sur la manière d'y parvenir sont disponibles dans le chapitre suivant, y compris des exemples de code complets.

Comprendre le flux de paiement

Nos SDK Serveur sont fournis avec une API HostedCheckout. Elle comprend toutes les méthodes dont vous avez besoin pour effectuer toutes les étapes d'un flux de paiement typique :

1. Vos clients vont sur votre page de paiement et finalisent l'achat.
2. Vous envoyez une demande CreateHostedCheckout à notre plateforme. Utilisez l'exemple de code suivant pour la demande :

1. Notre plateforme envoie une réponse dans l'instance de CreateHostedCheckoutResponse que vous avez créée lors de votre demande. Elle contient une propriété partialRedirectionURL

   // Propriétés de createHostedCheckoutResponse
   {
       "RETURNMAC": "12345678-90ab-cdef-1234-567890abcdef",
       "hostedCheckoutId": "123456",
       "merchantReference": "7e21badb48fe45848bbc1efef2a88504",
       "partialRedirectUrl": "hostedcheckout/PaymentMethods/Selection/e61340e579e04172a740676ffdda162e"
       "redirectUrl": "https://payment.hostedcheckout/PaymentMethods/Selection/e61340e579e04172a740676ffdda162e"
   }
   

2. Vous redirigez les clients dans le navigateur en utilisant la formule https://payment. + PartialRedirectUrl ou utilisez le chemin complet de la propriété redirectUrl
   
   Construisez cette URL en utilisant l'objet CreateHostedCheckoutResponse
   
   Le client entre son numéro de carte dans le masque de paiement sur PartialRedirectUrl / redirectUrl et confirme le paiement
   
   4'. (Facultatif) : Nous effectuons un contrôle de fraude

1. Nous redirigeons le client vers sa banque émettrice pour l'authentification 3-D Secure. Le titulaire de la carte s'identifie

1. Notre système reçoit le résultat de l'émetteur. En fonction du résultat, deux scénarios sont possibles :
   
   • Si l'identification a échoué, nous redirigeons vos clients vers votre ReturnUrl, mettant fin au processus. Vous demandez le résultat de la transaction comme décrit à l'étape 9)
   • Si l'identification a réussi, le processus continue à l'étape 7
2. Nous soumettons la transaction financière réelle à l'acquéreur pour traitement. Nous recevons le résultat de la transaction
   
   
3. Nous redirigeons vos clients vers votre ReturnUrl
   
   
4. Vous demandez le résultat de la transaction à notre plateforme. Utilisez une instance de GetHostedCheckoutResponse et passez le HostedCheckoutId de la réponse pour cibler la transaction que vous venez de créer. Dès que nous avons envoyé un HostedCheckoutId, vous pouvez demander le résultat pendant trois heures. Après cela, notre plateforme supprime le HostedCheckoutId.
   
   

   Si vos clients n'ont pas encore terminé d'entrer leurs informations de carte et/ou nous n'avons pas encore reçu un résultat final de votre acquéreur, la propriété hostedCheckoutStatus.CreatedPaymentOutput.PaymentStatusCategory est nulle :

   {
     "CreatedPaymentOutput": {},
     "Status": "PAYMENT_CREATED"
   }
   

   
   Dès que nous avons reçu un résultat, cette propriété contient un résultat qui ressemble à ceci :

   {
     "CreatedPaymentOutput": {
       "Payment": {
         "HostedCheckoutSpecificOutput": {
           "HostedCheckoutId": "3104703806"
         },
         "Id": "3104703806_0",
         "PaymentOutput": {
           "AmountOfMoney": {
             "Amount": 100,
             "CurrencyCode": "EUR"
           },
         },
         "Status": "CAPTURED",
         "StatusOutput": {
   		.
   		.
   		.
           "StatusCode": 9
         }
       },
       "PaymentStatusCategory": "SUCCESSFUL"
     },
     "Status": "PAYMENT_CREATED"
   }
   

Vous pouvez également recevoir le résultat via webhooks ou un appel PaymentResponse. Notez que GetPayment accepte un PAYIDSUB au lieu d'un HostedCheckoutId, qui est un HostedCheckoutId suivi d'une étape numérique indiquant l'ordre du PAYIDSUB dans le cycle de vie de la transaction. "_0" fait référence à la première étape du cycle de vie de la transaction, donc l'étape initiale lors de la création de la transaction :

1. Si la transaction a été réussie, vous pouvez livrer les biens / services