tdsCheck

Instantiate the tdsCheck object and set mwCallback (which is the callback function that will run after the 3DS check has completed). After the payframeToken and payframeKey are returned from the MW Payframe, call the checkTDS function. The tdsCheck object will communicate with the customer's bank and may perform a two-factor verification on the customer's card. In the event that the customer's bank opts for a two-factor verification, the verification window will be displayed in the tdsDivID that was configured in the tdsCheck object.

If the chosen div already contains an MW Payframe window, the tdsCheck object will close the MW Payframe window and replace it with the verification window. To show the MW Payframe again, you need to close the verification window with the destroy function below, then re-deploy the payframe.

After the 3DS verification has completed, the tdsCheck object will call mwCallback and return a boolean (indicating whether the 3DS verification resulted in a liability shift or not) and a threeDSToken. These values will also be set as properties of the tdsCheck object (liabilityShifted and mwTDSToken, respectively). The threeDSToken can be submitted with a processCard or processAuth request and should be submitted if you want 3DS protection for a transaction.

3DS chargeback protection will only be valid if the threeDSToken submitted has a liabilityShifted value of true and the threeDSToken is submitted with the processCard or processAuth request

tdsCheck Properties

Property	Description
liabilityShifted	A boolean that identifies if the customer authentication has completed and whether liability has shifted to the issuer. Example: true
mwTDSToken	This property is used to indicate if a transaction has been authenticated. Example: 8e86aef68037e8849980
mwTDSMessage	This property contains the status of the 3DS verification check. Example: 3DS Successful
mwTDSEnrolled	This property is used to indicate if the customer's card is enrolled in 3DS. Example: Y

Style Parameters

This is a list of the parameters that can be sent with the style option in the tdsCheck object constructor. The tdsCheck object will use the default values listed if a parameter is not set.

Parameter	Default	Description
width	500px	The width of the 3DS verification window Example: width: '800px'
height	500px	The height of the 3DS verification window Example: height: '350px'

The tdsCheck object also has some Additional Functions that can assist with your implementation.

checkTDS Parameters

All of these parameters are required

Parameter	Required	Description
payframeToken	Yes	A unique alphanumeric string returned by an MW Payframe that uses the getPayframeToken method. Example: KMJI24557546102398
payframeKey	Yes	A unique alphanumeric string returned by an MW Payframe that uses the getPayframeToken method. Example: b941071d7be8d11f4c8e6c038968bc0d
transactionAmount	Yes	The amount must be formatted to have two decimal places. Any amounts without two decimal places or amounts less than one cent will be rejected. Example: 10.00
transactionCurrency	Yes	One of the following: AUD, CAD, EUR, GBP, JPY, NZD, SGD, USD, FJD, HKD, MYR, THB, IDR, ZAR. This is provider dependent. Please check with MW before attempting to process transactions in any currency other than AUD. This field is case insensitive. Example: AUD
transactionProduct	Yes	A product (or sale) id or description. We recommend using an order/product id. This field's primary purpose is to help the transaction be identifiable for reporting and accounting purposes. Example: ABC4321

Constructor Parameters

Parameter	Required	Description
merchantUUID	Yes	The value of this parameter is provided to you by Merchant Warrior. Example: 123456789abcd
apiKey	Yes	The value of this parameter is provided to you by Merchant Warrior. Example: 1a3b5c
tdsDivID	Yes	This is the id of the div you wish the 3DS verification window to appear in. Example: tdsCheck
submitUrl	Yes	This parameter is used to set the target environment (Production, Camp). Example: Production
style	No	This parameter is used to set style options for the 3DS verification window. Example: {width: '500px'}

tdsCheck Properties#

Style Parameters#

checkTDS Parameters#

Constructor Parameters#

Sample Implementation#

tdsCheck Properties

Style Parameters

checkTDS Parameters

Constructor Parameters

Sample Implementation