CardNumber Property

Customer's credit card number to be authenticated.

Syntax

 mpi.getCardNumber([callback])
 mpi.setCardNumber( cardNumber, [callback])

Default Value

""

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getCardNumber([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setCardNumber([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This property contains the customer's credit card number which is to be authenticated. This must be the same number that will be used in the authorization request. This property is 13-19 characters long, excluding whitespace and dashes which are stripped out when the property is set.

Note: A VerifyEnrollment response may encrypt, encode, or otherwise modify this property. Do not reset the CardNumber property to the actual credit card number before calling GetAuthenticationPacket, or the ACS may respond with an error.

Note: Before calling CheckAuthenticationResponse, CardNumber must be set to last 4 digits of the card number preceded by zeroes. For instance:

• 0000000001234 (13-digit PAN)
• 0000000000001234 (16-digit PAN)

Data Type

String