Page tree


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. 
In output, the number is hidden: 497010XXXXXX1646.

This may also contain a network token (see token scheme function)

No

AN19


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

type

Card type ; refer to list below

Yes

AN

CB


expirationDate

Card expiry date

NoN4

0311


cvx

Visual cryptogram on the back of the credit card

No

N10

XXX

  • if presence cavv, put "xxx"
  • if cavv absence, leave blank

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.
verifyEnrollment with max 45 char.

With min 2 characers and payment method parameter activated.

panTypeIndicates the type of PAN that is provided in the number field.
Possible values are : CARD PAN (default) or SCHEME TOKEN.
The value SCHEME TOKEN shall be provided when the car.number contains a network token. Not mandatory in other case.
NoAN12
Only used for token scheme function

token

Alias ​​of the card number provided by Monext. 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.

paymentDataObject at the input of the service to convey the data of the payment method XPay (ApplePay, GooglePay, SamsungPay, ...)
NoObject PaymentData

parPayment Account Reference "PAR"NoAN29
Only used for token scheme function
tokenRequestorCryptogramToken CryptogramNoAN32
Only used for token scheme function
tokenRequestorIdToken Requestor IDNoAN11
Only used for token scheme function
last4Last four digits of PANNoAN4
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_DISCOVER

Diners Club  and Discover card

Diners / Discover

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)

VISA

VISAPREPAIDVisa (merchant outside France)VISA