Defining the capture mode (automatic/manual)

In the Merchant Back Office, the merchant can configure how payments are sent to the bank (Settings > Shop menu > Configuration tab):

Figure 1. Defining the capture mode
  • Automatic: no action is necessary, the payments are captured in the bank once the capture delay has been reached.
  • Manual: the merchant must validate each payment via their Merchant Back Office so that it is captured in the bank before the authorization request expires.

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

    By default, the Merchant Back Office is configured to automatically submit all payments to the bank.

    The merchant can override this configuration in their 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 associated with the vads_validation_mode field
    Value Description
    Missing or empty Takes the value specified in the Merchant 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 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="hidden" name="signature" value="cJFhNTLXQ4o6BgbW1pMMoM2yMilw90OIqmFjJ6DeUmA= />
<input type="submit" name="pay" value="Pay"/>
</form>