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
Element | Description | Required | Format | Example | Conditions |
| version | Payline web services version. To be valued with the latest version: see the table of versions. | Yes | N2 | 18 | |
| 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 |
| merchantURL | Specific use. You must contact support before use. Value accepted: Fully qualified URL (beginnning with http:// ou https://). | No | AN255 | https://www.payline.com | Version 29 |
| merchantCountryCode | Specific use. You must contact support before use. Format : ISO 3166-1 alpha-2 codes. | No | Version 29 | ||
| returnURL | The URL of the system that receives the CRes message or Error Message. | No | AN256 | Version 21 or higher (3DSV2) | |
| order | Order Information. | Yes | Object order | Version 21 or higher (3DSV2) | |
| buyer | Buyer information. | Yes | Object buyer | Version 21 or higher (3DSV2) | |
| submerchant | Payment Facilitator Information. | No | Object subMerchant | Version 21 or higher (3DSV2) | |
| recurring | Recurring or installment information. | No | Object recurring | Version 21 or higher (3DSV2) | |
| threeDSinfo | Information specific to 3DS authentication. | Yes | Object threeDSInfo | Version 21 or higher (3DSV2) | |
| merchantScore | Merchant calculated score. Mainly for CB scoring. | No | AN | Method 023 : A+ | Version 21 or higher (3DSV2) |
| transient | Data to populate the 3DSV2 container. | No | Java = String (100 K Octets) et SQL = CLOB | Version 22 or higher (3DSV2) | |
| privateDataList | List containing privateData. Number of items 0 to 100. | No | Object - privateData | Version 22 or higher (3DSV2) |