Enabling / disabling 3D Secure

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

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

The merchant must decide on the desired criteria and implement it (amount, country, shipping area, etc.) allowing the buyer to decide whether 3DS will be enabled or not for the payment.

  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="maxk6nsMIL8XLEWWxYO2Fuj7ostRYM+ZcaoaVYZs7BY="/>
<input type="submit" name="pay" value="Pay"/>