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 | Card number (PAN), PCI DSS compliant : 4970102121041646 as input to our API. | No | AN19 | If the token field is populated, the number field must be empty | |
type | Card type: CB, VISA, MASTERCARD, MAESTRO, AMEX | Yes | AN | CB | |
expirationDate | Card expiry date | No | N4 | 0311 | |
cvx | Visual cryptogram on the back of the credit card | No | N10 | XXX |
|
ownerBirthdayDate | Cardholder's birthday | No | N6 | 01/01/2018 | Format à respecter :ddmmyy |
password | Encrypted password | No | AN16 | ||
cardPresent | This service is used only in case of Mail Order or Telephone Order or if the user is physically present | No | N1 | 0 | 0 ou 1 (present:MO-TO) |
cardholder | Cardholder's name | No | AN45 | Pierre Dupont | doAuthorization with max 30 char. With min 2 characers and payment method parameter activated. |
token | Alias of the card number. To be used instead of card.number | No | AN19 | 1111gPNzHtyu4444 | You must use the PAN token option and the version must be greater than or equal to 3. |
| paymentData | Object at the input of the service to convey the data of the payment method XPay (ApplePay, GooglePay, SamsungPay, ...) | No | Object PaymentData | ||
| par | Payment Account Reference "PAR" | No | AN29 | Only used for token scheme function | |
| tokenRequestorCryptogram | Token Cryptogram | No | AN32 | Only used for token scheme function | |
| tokenRequestorId | Token Requestor ID | No | AN11 | Only used for token scheme function | |
| last4 | Last four digits of PAN | No | AN4 | Only used for token scheme function | |
| panType | Merchant tokenisation indicator : CARD PAN or SCHEME TOKEN. | No | AN12 | Only used for token scheme function |
If the "encryptedData" field is non-zero then the following fields must be empty:
- card.number
- card.expirationDate
- card.CVX
- card.ownerBirthdayDate
- card.password
The fields "encryptionKeyId" and "encryptedData" are both null or non-zero.
Type: This table shows the possible values for the "type" field of the card object. Code Card name Parent network AMEX American Express American Express AURORE Aurore card Cetelem CB Carte Bancaire / VISA / MasterCard Cartes Bancaires CDGP Privilege card Cofinoga COFINOGA Cofinoga card Cofinoga DINERS Diners Club card Diners Club JCB JCB card JCB MAESTRO Maestro card Mastercard MASTERCARD MasterCard (merchant outside France) MasterCard MCVISA VISA / MasterCard card VISA / MasterCard VISA Visa (merchant outside France) VISAVISAPREPAID Visa (merchant outside France) VISA