Authenticating

The authentication process starts with a call to the Transaction object's getAuthenticationRequestParameters method. When this method is called, the 3DS SDK will encrypt the device information it collected during initialization and make it, along with other SDK information required by the 3DS Server, available in the returned AuthenticationRequestParameters object. This AuthenticationRequestParameters object consists of the following fields:


Name	Description
SDKTransactionId	A transaction identifier randomly generated by the SDK.
DeviceData	Device data collected by the SDK during initialization and encrypted using the DS key.
SDKEphemeralPublicKey	The public key component of the ephemeral key pair generated by the SDK.
SDKAppId	A UUID value, generated by the 3DS SDK, that uniquely identifies the app on the device.
SDKReferenceNumber	Assigned to our SDK by EMVCo after certification.
MessageVersion	From `createTransaction`, or a default value from the SDK (2.1.0).
AuthRequest	Packaged authentication request data to be sent to the 3DS Server.

The AuthRequest property is a packaged form of the other properties. The app would transmit this to the 3DS Server via a communication channel outside the scope of the 3DS SDK itself. On the server side, this AuthRequest data is designed to be passed directly in to the 3DS Server component's ClientAuthRequest property prior to sending the authentication request to the directory server via its SendAuthRequest method.

When the SendAuthRequest method completes, the Server component's ClientAuthResponse property will contain data that can be sent back to the app and passed to the 3DS SDK to use if a challenge is required.

/n software 3-D Secure V2 iOS Edition

Authenticating