Defining the capture mode (automatic/manual)

From the Back Office, the merchant can configure the mode in which the payments will be sent to the bank (Settings > Shop > Configuration tab):

Figure 1. Defining the capture mode
  • Automatic: no action is necessary, the payments are captured by the bank once the capture delay is elapsed.
  • Manual: the merchant must validate each payment from the Back Office to enable the capture before the desired capture date.

    Each transaction that has not been validated by the expected date is considered as expired and will never be captured by the bank.

    By default, the Back Office is configured to capture all payments automatically.

    The merchant can override this configuration in the payment form.

    The merchant must implement the desired criteria (stock status, delay for stock replenishment, etc.) allowing the buyer to decide whether the transaction must be captured automatically 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_validation_mode field to configure the capture mode (manual or automatic).This field will be resent with the response and will include the value transmitted in the form.
    Table 1. Values of the vads_validation_mode field
    Value Description
    Absent or empty Takes the value specified in the Back Office.
    0 Automatic capture.
    1 Manual capture.
  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 a payment form with a definition of the capture mode in SILENT mode:
<form method="POST" action="https://secure.payzen.eu/vads-payment/">
<input type="hidden" name="vads_action_mode" value="SILENT" />
<input type="hidden" name="vads_amount" value="4000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_card_number" value="4970100000000000" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_cvv" value="123" />
<input type="hidden" name="vads_expiry_month" value="5" />
<input type="hidden" name="vads_expiry_year" value="2017" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="SINGLE" />
<input type="hidden" name="vads_payment_cards" value="VISA" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20140326164147" />
<input type="hidden" name="vads_trans_id" value="164147" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="vads_validation_mode" value="1" />
<input type="submit" name="pay" value="Pay"/>
</form>
Example of a payment form with a definition of the capture mode in INTERACTIVE mode:
<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_trans_date" value="20140326164147" />
<input type="hidden" name="vads_trans_id" value="164147" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="vads_validation_mode" value="1" />
<input type="submit" name="pay" value="Pay"/>
</form>

Note:

Required fields are different according to the capture mode (SILENT or INTERACTIVE).

When vads_action_mode is set to SILENT, payment method details are mandatory.