XID Property

TransactionId from a 3D Secure authentication.

Syntax

 ptechecommerce.getXID([callback])
 ptechecommerce.setXID( XID, [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 getXID([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 setXID([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 is used to pass the 3D Secure TransactionId (XID) data on to the credit card processor. This property must be a 20-byte plaintext value, or a 28-byte Base-64 encoded value. This class may be used in conjunction with the IP*Works! 3D Secure MPI class or with any other 3D Secure MPI implementation. For example:

 class.XID = ThreeDSecure.TransactionId

Other properties necessary for passing 3D Secure data are CAVV and ECI.

Data Type

String