Enabling / disabling 3D Secure

A subscription to Selective 3D Secure option is required for this feature.

In the payment form, the merchant can indicate if he/she wishes to enable or disable the 3D Secure authentication.

The merchant will have to implement the criteria of his or her choice (amount, country, shipping area, etc.) which will allow to determine if the transaction must be subject to 3DS or not.

  1. Use the fields required for your use case (see chapter Generating a payment form) to create your payment form.
  2. Use the vads_threeds_mpi field to enable or disable 3D Secure.
    Value Description
    absent or empty

    3DS authentication managed by the payment gateway (configuration by the merchant).


    3DS authentication managed by the payment gateway (configuration by the merchant).


    3DS authentication completely managed by the merchant on the condition that the vads_card_number field is populated (card data entered by the merchant).

    In this case, the data produced by 3D Secure authentication initiated by the MPI must be submitted in specific fields of the form (vads_threeds_enrolled, vads_threeds_cavv, vads_threeds_eci, vads_threeds_xid, vads_threeds_cavvAlgorithm, vads_threeds_status).

    3DS authentication disabled for the transaction independently of the usual configuration of the merchant.

  3. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).
Example of enabling 3DS depending on the amount:
if (vads_amount < 300 euro){
	then vads_threeds_mpi = 2 // 3DS disabled
	else vads_threeds_mpi = 0 // 3DS enabled
Example of enabling 3DS depending on the department:
if (vads_cust_zip = 92 ) or (vads_cust_zip = 93 ){ 
	then vads_threeds_mpi = 0 // 3DS enabled 
	else vads_threeds_mpi = 2 // 3DS disabled
Example of a payment form with disabled 3DS:
<form method="POST" action="https://secure.payzen.eu/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="4000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="SINGLE" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_threeds_mpi" value="2" />
<input type="hidden" name="vads_trans_date" value="20140327145218" />
<input type="hidden" name="vads_trans_id" value="571381" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="2ac6a70c2cde3e0de1610d6749e3b90081743341"/>
<input type="submit" name="pay" value="Pay"/>