Documentation Monext Online

Arborescence des pages

Contenu

Paiement 3DS en direct

Le paiement 3D Secure se réalise en deux étapes : 

  • Vérification de l'enrôlement de la carte au système 3D Secure et authentification du porteur.
  • Demande de paiement.

Pour plus d'information concernant le traitement 3D Secure, veuillez cliquer ici.


Intégration

Vous devez utiliser les web services  verifyEnrollment et doAuthorization de l'API Payline.

Les étapes : 

  1. Le consommateur valide son panier et renseigne ses données de paiement afin que Payline vérifie l'enrollement sur la demande du merchand avec le service verifyEnrollment ;
  2. Le marchand redirige le consommateur sur la page d'authentification de la banque ; 
  3. Le marchand peut alors réaliser une demande de paiement avec les informations d'authentification avec le service doAuthorisation ; 
  4. Le marchand doit récupérer les informations de la transaction avec le service getTransactionDetails.


Les services de l'API


Vous devez d'abord demander la vérification de l'enrollement de la carte bancaire à Payline avec le service verifyEnrollement.

Exemple de configuration :

verifyEnrollment
verifyEnrollmentRequestverifyEnrollmentResponse
ElémentsValeursElémentsValeurs
version18version18
card.number497010XXXXXX1646result.code03000
card.expirationDate1222result.shortMessageACCEPTED
card.cvx123result.longMessageTransaction accepted
payment.amount10000termurlName*TermUrl
payment.action101termurlValue*NULL
payment.modeCPTmdFieldName*MD
payment.contractNumberVAD3DSmdFieldValue*2KJw5rL1N7pZRsfS8Xiw
orderRefPHP1544091439pareqFieldName*PaReq


pareqFieldValue*eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..


actionMethodPOST


ActionUrlhttps://3ds-acs.test.modirum.com/mdpayacs/pareq


token4970zSIkspmH5670

* Attention les valeurs sont générés de manière dynamique et se renouvelleront pour chaque message.


Vous devez réaliser la demande d'authentification 3DS du consommateur.

Pour cela, vous devez rediriger le consommateur sur l'URL ActionUrl avec les paramètres que vous trouvez dans la réponse du service verifyEnrollementResponse.

Vérifier la méthode utilisée POST ou GET de actionMethod. 

  • en POST vous poster un formulaire type 'form method' avec les noms et les valeurs des champs : name et value, en rajoutant le termUrl sur lequel l'utilisateur sera redirigé ;
  • en GET vous pourrez transmettre les noms et les valeurs en paramètres de l'URL.

(avertissement)  Les paramètres sont indiqués par les champs et les valeurs dynamiquement : à chaque appel, ils peuvent être modifiés. 

pareqFieldNamenom du paramètre
pareqFieldValuevaleur du paramètre pareqFieldName
termUrlNamenom du paramètre
termUrlValuevaleur du paramètre termUrlName
midFieldNamenom du paramètre
midFieldNamevaleur du paramètre midFieldName

Vous devez récupérer les informations MD et pares en retour de l'authentification 3DS pour les transmettre dans la demande de paiement à Payline :

Exemple de configuration :

doAuthorization
RequestResponse
version
result.code00000
payment.amount
result.shortmessageACCPTED
payment.action101result.longmessageTransaction approved
payment.modeCPTtransaction.id28340115745009
payment.contractNumberVAD3DStransaction.date07/04/2018 11:27:45
card.number4970100012345670authorization.numberACCOR0
card.expirationDate1222authorization.date07/04/2018 11:27:45
card.cvx123card.number497010XXXXXX5670
order.refPHP1544091439card.typeCB
buyer.customerIdID12654895card.expirationDate1222
3DSecure.md2KJw5rL1N7pZRsfS8Xiwcard.token4970zSIkspmH5670

3DSecure.pares

eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..contractNumberVAD3DS

Vous devez récupérer toutes les informations en appelant le service getTransactionDetails : 

getTransactionDetails

RequestResponse
transactionId28340115745009result.code00000
orderRefPHP1544091439result.shortmessageACCPTED
version18result.longmessageTransaction approved


transaction.....


payment.....


authorization....


order.....


buyer.....

Exemple du centre administration


Exemple de l'écran du détail de la transaction

Commentaire

  1. Rodolphe GARIN dit :

    Return code

    return Code

    Action

    Comment

    03000Authorize.The buyer has been correctly authenticated.
    03003Do Not Authorize

    The buyer is not authenticated. Do not send any authorization.

    03004Call the verifyEnrollment first 

    This MD is unkown. Looks like the verifyEnrollment call has not been done.

    03005Re-authenticate the buyer

    This PaRes is already consumed. Re-Authenticate the buyer.

    03006Do Not AuthorizeThe PaRes is not valid or have been modified. Do Not Authorize.
    03022Do Not AuthorizeThe PaRes could not be verified. Do Not Authorize.
    Any other codeDo Not Authorize

    Unexpected issue. Do Not Authorize.