GetAuthRequest Method
Prepares data to be sent by the 3DS Server.
Syntax
client.getAuthRequest([callback])
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 this 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.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
GetAuthRequest encrypts the device info and prepares all the data necessary to be sent by the 3DS Server class in the SendAuthRequest method.
After calling this method, the returned data must be transmitted via a separate secure channel to the server where 3DS Server is being used.
The following properties are required before calling the method:
| Property | Description |
| DeviceParams | Contains device information parameters. Add parameters via AddDeviceParam. |
| DirectoryServerCert | Used to encrypt the device parameters. |
| DirectoryServerId | Identifies the DirectoryServerCert within the directory server. |
| SDKAppId | A UUID for the specific installation. |
| SDKReferenceNumber | An Id assigned by EMVCo to identify the vendor and software version. |
Calling this method returns required information used by 3DS Server to send the authentication request. Transmit the value returned by this method to the system where 3DS Server is used. The method used to transmit this value is outside the scope of the class.
See SendAuthRequest for details on sending the authentication request after transmitting the data to the 3DS Server.
Calling this method also populates SDKTransactionId which uniquely identifies this transaction and must be used in subsequent calls relating to this transaction, such as SendChallengeRequest.