Webservice - verifyEnrollmentRequest

S’abonner

Ce Web Service permet au commerçant de vérifier que la carte de l’acheteur est compatible 3DSecure et permet de récupérer directement un token PAN et un CVVTemporaire que vous pouvez conserver en session sans de contrainte de sécurité pendant l’authentification 3DSecure.

Le message « verifyEnrollmentRequest» doit avoir la structure suivante :

Requête à envoyer


Élément

Description

Requis

Type

Exemple

Conditions

version

Version des web services Payline

oui

N2

A valoriser avec la dernière version : voir le tableau des versions.


cardInformation sur la carteouiObject - cardVoir les éléments ci-dessous
paymentInformation sur le paiementouiObject - paymentVoir les éléments ci-dessousLe montant peut être 0 si la carte est 3DS.
orderRef

L’identifiant de la commande chez le commerçant

ouiAN5012345678
mdFieldValueValeur du merchantData (Cette valeur doit être unique). L’utilisation de champ n’est pas recommandée.nonAN20Ex : OS0hZDbJH75NiDrAo0yo
userAgent

UserAgent du terminal de paiement. Pour connaitre l’origine de la demande de paiement, il sera transmis lors de la demande 3DS au MPI.

nonAN255
Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0) like Gecko

walletIdL’identifiant du portefeuille de l’acheteur. La balise version doit être remplie avec la valeur égale ou supérieure à 10.nonAN50

walletCardIndL’index de la carte de l’acheteur enregistré dans le portefeuille. La balise version doit être remplie avec la valeur égale ou supérieure à 10.nonAN5

generateVirtualCvx

Demande de génération d’un CVV virtuel.
Vérifier si votre abonnement permet cette fonctionnalité (Tokenization).

nonBooleanTrueVersion 16 ou supérieure
merchantNameNom affiché sur la page d'authentification de l'ACSnonAN25Votre nom d'enseigneVersion 16 ou supérieure

Les références

Object card


Field

Description

Mandatory

Format

Example

Condition

encryptionKeyId

RSA Payline key identifier for encryption. Disregard this field

No

N4



encryptedData

The encrypted card data. Disregard this field

No

AN400



number

Masked card number, PCI DSS compliant : 4970102121041646 as input to our API. 
In output, the number is hidden: 497010XXXXXX1646

No

AN19

497010XXXXXX1646

If the token field is populated, the number field must be empty

type

Card type: CB, VISA, MASTERCARD, MAESTRO, AMEX

Yes

AN

CB


expirationDate

Expiration date of the card

NoN4

0311


cvx

Visual cryptogram on the back of the credit card

No

N10

XXX

  • if presence cavv, put "xxx"
  • if cavv absence, put "null"

ownerBirthdayDate

Cardholder's birthday

No

N6

01/01/2018

Format à respecter :ddmmyy

password

Encrypted password

No

AN16



cardPresent

This service is used only if you make the Mail Order or Telephone Order or if the user is physically present

No

N1

0

0 ou 1 (present)

cardholder

Cardholder's name

No

AN20

Pierre Dupont


token

Alias ​​of the card number.

The version must be greater than or equal to 3

No

AN19

1111gPNzHtyu4444

You must use the PAN token option and the version must be greater than or equal to 3.

paymentDataObject at the input of the service to convey the data of the payment method ApplePayNoObject PaymentData


Object payment


Field

Description

Prerequisites

Format

Example

Condition

amount

Information passed when calling the doWebPayment function. The value 100 corresponds to 1 €

Yes

N12

100


currency

Currency of payment

Yes

N3

978


action

Action Code

Yes

N3

100

see the table

mode

Payment mode

Yes

AN3

CPT

see the table

contractNumber

Contract number

Yes

AN50

1234567

doWebPayment (defined point of sale), doCapture / doRefund (contractNumber returned by getPaymentDetails / getWebPaymentDetails).

differedActionDate

Date on which payment will be made. 
Format : dd/mm/yy

No

AN8

07/04/2016

If the mode = DIF field, then the DifferedActionDate date is required otherwise this field must be empty.

method

Name of card issuer

No

AN20

CB

version 10 or higher

Ex : CB, PAYSAFECARD

softDescriptor

Information displayed on the account statement of the buyer, limited with certain means of payment. This information will be displayed on the payment ticket. 
Special characters (not A..Z and 1..9) are specific to each acquirer / payment method.

NoAN64www.boutique.frversion 13 or higher
cardBrand

Indicates the mark used for the operation, see the values. 
It is taken into account only if the means of payment allows the choice of the mark.

NoAN15

version 15 or higher

see table


registrationToken

Token used in response in services. 
It allows the partner to return a token to identify a consumer and finds this data when making a payment request.
NoAN

version 18 ou supérieure

RELEASE 4.53

Réponse en retour


Élément

Description

Requis

Type

Exemple

Condition
resultInformations sur le résultat de la vérification d'enrollement :

00000 : Transaction approved
01xxx : Transaction refused
021xx : Internal Error

ouiObject result

Voir les éléments ci-dessous


actionUrl

URL de l’ACS

non

AN255

actionMethod

Méthode d’envoi .Retourne une valeur POST ou GET. Post par défaut.

non

AN255

pareqFieldName*

Nom du champ “Pareq à Poster

non

AN5

pareqFieldValue

Contient la Valeur du champ PaReq

non

AN400

termurlFieldName*

Contient  le nom du champ  "TermUrl" à Poster

non

AN50

termurlFieldValue

Contient  la valeur du champ  "TermUrl".

non

AN255

mdFieldName

Contient  le nom du champ  "MD field"

nonAN50

mdFieldValue*

Contient  la valeur du champ  "MD field" à Poster

non

AN20

 


mpiResult

Renvoie un indicateur concernant le résultat de l’enrôlement

Y = Succès lors de l’enrôlement
N = Echec lors de l’enrôlement
U = enrôlement indisponible

non

AN1 

authentication3DSecure

Informations sur l'autentification 3D-Secure

non

Object - authentication3DSecure

Voir les éléments ci-dessous


virtualCvxCVV virtuel calculé par PaylinenonAN

Version 16 ou supérieure.

Si la version >=16,  si un CVV est donné en entrée et qu’une demande de virtualisation (card.generateVirtualCvx)  est demandée alors la valeur du CVV virtuel est retournée.

tokenTokenPAN de PaylinenonAN19
Si la version >=16,  si un PAN et d’une date d’expiration sont donnés en entrée alors un TokenPAN est généré. Dans tous les autres cas, aucun TokenPAN n’est généré.

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

Les éléments de références

Object result

Erreur du rendu de la macro 'excerpt-include' : No link could be created for 'Object result'.


Object authentication3DSecure


Field

Description

Mandatory

Type

Example

Condition

md

Referred to POST by ACS

No

AN20



pares

Referred to POST by ACS

No

AN



xid

Unique transaction identifier

No

AN20



eci

Electronic Commerce Indicator. To pass in the authorization

No

AN2



cavv

Cardholder Authentication Verification Value determined by the ACS.

No

AN28



cavvAlgorithm

Positive integer specifying the algorithm used for CAVV generation. The current possible values ​​are:

0 = HMAC (SET ™ TransStain), 
1 = CVV, 
2 = CVV with ATN, 
3 = AAV MasterCard

W = Cryptogram generated by a Wallet solution

No

N1


W : Wallet UEP

vadsResult

Summary of 3DSecure operations in hexadecimal. This field is no longer used.

No

AN8



typeSecurisationField used as information for authentication.This field is no longer used.NoAN102020 :  VADS
else  9 : VAD
PaResStatus

To use a non-Payline MPI, you must fill in this field.

Values ​​are: 
Y: Successful authentication 
N: Erroneous authentication 
A: Planned passage through ACS 
U: Call to ACS performed 
empty: Time out on ACS

NoAN1

VeResStatus

To use a non-Payline MPI, you must fill in this field.

Values ​​are: Y / N / U or empty

NoAN1




Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk