Request |
This Web Service allows merchant to verify that the buyer's card is 3DSecure compatible and allows you to directly retrieve a PAN token and CVV temporary that you can keep in session without security constraints during 3DSecure authentication.
The verifyEnrollmentRequest message must have the following structure.
Request to send
Element | Description | Mandatory | Format | Example | Conditions |
| version | Version of Payline web services | Yes | N2 | To be valued with the latest version: see the table of versions. | |
| card | Card Information | Yes | Object - card | ||
| payment | Payment Information | Yes | Object - payment | The amount can be 0 if the card is 3DS | |
| orderRef | The identifier of the order at the merchant Deprecated, fill out the order object instead | Yes | AN50 | 12345678 | |
| mdFieldValue | Value of merchantData (This value must be unique). Field use is not recommended. | No | AN20 | OS0hZDbJH75NiDrAo0yo | |
| userAgent | UserAgent of payment terminal. To know the origin of payment request, it will be transmitted during request 3DS to MPI. | No | AN255 | Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0) like Gecko | |
| walletId | The identifier of buyer's wallet. | No | AN50 | Version 10 or higher | |
| walletCardInd | The index of buyer's card registered in wallet. | No | AN5 | Version 10 or higher | |
| generateVirtualCvx | Request to generate a virtual CVV. Check if your subscription allows this feature (Tokenization). | No | Boolean | True | Version 16 or higher |
| merchantName | Name displayed on the ACS authentication page | No | AN25 | Merchant name | Version 16 or higher |
| returnURL | Not used | No | |||
| order | Order Information | Yes | Object - order | Version 21or higher | |
| buyer | Buyer information | No | Object-buyer | Version 21or higher | |
| submerchant | Payment Facilitator Information | No | object subMerchant | Version 21or higher | |
| recurring | Recurring or installment information | No | Version 21or higher | ||
| threeDSinfo | Information specific to 3DS authentication | No | object - description | Version 21or higher | |
| merchantScore | Merchant calculated score. Mainly for CB scoring | No | AN | Method 023 : A+ | Version 21or higher |