Note

A partir du 01/10/2022 l'ensemble des transactions authentifiées devront utiliser le 3DSV2.

Cette section est une synthèse des évolutions à apporter à votre implémentation pour bénéficier du 3DSV2 à la place du 3DSV1.

Dans le cadre d'Axepta, cela signifie utiliser le paramètre 'msgVer=2.0' pour les paiements classiques. Les autres cas d'usage sont décrits dans la section Fonctionnalités de paiement

L'utilisation de l'authentifcation 3D Secure permet de protéger le marchand contre le motif d'impayés "contestation du porteur".

La version 3DS V2 fournit un mécanisme permettant la réalisation d'authentifications fortes en conformité avec la DSP2.

La différence majeure avec 3DS 1.0 est la possibilité de faire bénéficier les acheteur d'un parcours « frictionless », dans ce cas la banque émettrice peut approuver une transaction sans action explicite du porteur de la carte (authentification passive).

L'authentification 3DS V1 restera possible jusqu'à mi-Octobre 2022. Après cette date, toutes les authentifications 3DS devront utiliser la version 2 .

Info

Pour plus de détails :

Présentation générale : 3DSV2 et frictionless
Implémentation : Favoriser les paiements 'Frictionless'
Transfert de responsabilité : Transfert de reponsabilité et Matrices 3D-Secure

Table of Contents

Principes

Nouvelles données reçues dans les réponsesPlusieurs formats de réponses : GET & POST

POST (pas de 3DS, 3DSV2)

GET pour les transaction 3DSV1 (en cas de fallback)

GET : pour tous les autres moyens de paiement

https://docs.axepta.bnpparibas/display/DOCBNP/ codes retour : ++ piloter les demandes d'authentification

demander des authentifications fortes ou frictionless.

Par défaut, les requêtes de paiement sont envoyées en ‘noPreference’, le marchand ne précise pas de préférence pour le mode d'authentification (SCA ou authentification passive).

Tip
Si vous proposez du paiement one-shot, l'évolution vers le 3DSV2 consiste à

ajouter et gérer .

Les paramètres clés du 3DSV2

Les paramètres clés utilisés en fonction de vos cas d'usages sont :

Paramètre	Type	Détails	Requête	Réponse
msgVer	Paramètre	Envoi de requête de paiement 3DSV2	X
threeDSPolicy	Objet JSON	Piloter la demande d’authentification (forcer une authentification, demander une exemption)	X
browserInfo	Objet JSON	A indiquer dans le cadre de l’utilisation de paynow.aspx (one-click)	X
credentialOnFile	Objet JSON	Permet d’indiquer si une carte sera réutilisée par le marchand	X
billToCustomer	Objet JSON	Client facturé pour les achats	X
shipToCustomer	Objet JSON	Client livré	X
billingAddress	Objet JSON	Adresse de facturation	X
shippingAddress	Objet JSON	Adresse de livraison	X
Card	Objet JSON	Contient les données carte telles que le PCNr, la marque de la carte, la date d’expiration …	X	X
schemeReferenceId	Paramètre	Donnée générée par la banque émettrice ou le scheme, utilisée dans les cas de paiement récurrents	X	X
resultsResponse	Objet JSON	Informations complémentaires fournies en cas d’authentification		X
threeDSData	Objet JSON	Données d’authentification		X

Synthèse des évolutions vers le 3DSV2

Cas d'usages

3DSV1

3DSV2

Exemples : Objets JSON à ajouter dans les requêtes de paiements ECOM

Paiement classique / One-Shot

Intégration existante

Ajouter "MsgVer=2.0” - Créer une requête de paiement (CIT)

Info

D'autres données peuvent être indiquées dans la requête de paiement pour favoriser les paiements 'frictionless'.

Pour plus de détails

Présentation générale : 3DSV2 et frictionless
Implémentation : Favoriser les paiements 'Frictionless'

Format des réponses

Paiements carte

Méthode GET pour l’URLFailure / URLSuccess / URLNotify

Méthode POST pour l’URLFailure / URLSuccess / URLNotify

Méthode GET pour l’URLFailure / URLSuccess / URLNotify en cas de fallback 3DSV1 jusqu’à Mars 2022

Format des réponses

Moyens de paiement alternatifs

Méthode GET pour l’URLFailure / URLSuccess / URLNotify

Données cartes

PCNr

CCExpiry

CCCVC

CCBrand

Objet JSON Card

Ou Objet JSON Card + PCNR / CCExpiry / CCBrand en cas de fallback 3DSV1

Cas d’usage

One-click

Paiement initial

/

Utiliser "MsgVer=2.0”, l’objet JSON credentialOnFile et threeDSPolicy

Paiement en 1 clic (One-Click)

Objet JSON credentialOnFile

Code Block

theme	Eclipse
linenumbers	true

{
    "type": {
        "unscheduled": "CIT"
    },
    "initialPayment": true,
  	"useCase": "cof"   
}

Objet JSON threeDSPolicy

Code Block

theme	Eclipse
linenumbers	true

{
	"challengePreference": "mandateChallenge"
}

One-click

Paiements suivants

PCNr

CCExpiry

CCCVC

CCBrand

Utiliser "MsgVer=2.0”, l’objet JSON Card et credentialOnFile

Paiement en 1 clic (One-Click)

Objet JSON credentialOnFile

Code Block

theme	Eclipse
linenumbers	true

{
    "type": {
        "unscheduled": "CIT"
    },
    "initialPayment": false,
  	"useCase": "ucof"   
}

Abonnement à durée et montant fixes

Paiement initial

Utilisation du paramètre "RTF=I"

Infos carte : PCNr, CCExpiry, CCBrand…

Server-to-Server

Utiliser "MsgVer=2.0”, l’objet JSON credentialOnFile et threeDSPolicy

L’objet JSON Card et le schemeReferenceID sont envoyés dans la réponse

Batch

L'implémentation Batch reste inchangée

Pour plus de détails

Objet JSON credentialOnFile

Code Block

theme	Eclipse
linenumbers	true

{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": true,
    "useCase": "fixed" 
}

Objet JSON threeDSPolicy

Code Block

theme	Eclipse
linenumbers	true

{
	"challengePreference": "mandateChallenge"
}

Abonnement à durée et montant fixes

Échéances suivantes

Utilisation du paramètre "RTF=R"

Infos carte : PCNr, CCExpiry, CCBrand…

Server-to-Server

Utiliser "MsgVer=2.0”, l’objet JSON credentialOnFile, l'objet JSON Card et le schemeReferenceID.

Batch

L'implémentation Batch reste inchangée

Pour plus de détails

Objet JSON credentialOnFile

Code Block

theme	Eclipse
linenumbers	true

{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": false,
    "useCase": "fixed" 
}

Abonnement à durée et montant variables

Paiement initial

Utilisation du paramètre "RTF=E"

Infos carte : PCNr, CCExpiry, CCBrand…

Server-to-Server

Utiliser "MsgVer=2.0”, l’objet JSON credentialOnFile et threeDSPolicy

L’objet JSON Card et le schemeReferenceID sont envoyés dans la réponse

Batch

L'implémentation Batch reste inchangée

Pour plus de détails

Objet JSON credentialOnFile

Code Block

theme	Eclipse
linenumbers	true

{
    "type": {
        "unscheduled": "CIT"
    },
    "initialPayment": true,
  	"useCase": "ucof"   
}

Objet JSON threeDSPolicy

Code Block

theme	Eclipse
linenumbers	true

{
	"challengePreference": "mandateChallenge"
}

Abonnement à durée et montant variables

Échéances suivantes

Utilisation du paramètre "RTF=M"

Infos carte : PCNr, CCExpiry, CCBrand…

Server-to-Server

Utiliser "MsgVer=2.0”, l’objet JSON credentialOnFile, l'objet JSON Card et le schemeReferenceID.

Batch

L'implémentation Batch reste inchangée

Pour plus de détails

Objet JSON credentialOnFile

Code Block

theme	Eclipse
linenumbers	true

{
    "type": {
        "unscheduled": "MIT"
    },
    "initialPayment": false,
  	"useCase": "ucof"   
}

Tip
Les fonctionnalités de paiement sont détaillés dans la section : Fonctionnalités de paiement

CMS et 3DSV2

A VOIR AVEC DAMIEN

Page tree

Versions Compared

Old Version 3

New Version 4

Key

Principes

Les paramètres clés du 3DSV2

Synthèse des évolutions vers le 3DSV2

CMS et 3DSV2

Help

Intranet Tools

Page tree

Page History

Versions Compared

Old Version 3

New Version 4

Key

Principes

Les paramètres clés du 3DSV2

Synthèse des évolutions vers le 3DSV2

CMS et 3DSV2