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 or Web Services, 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.
Use field vads_validation_mode 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.
Value | Description |
---|---|
Missing or empty | Takes the value specified in the Merchant Back Office. |
0 | Automatic capture. Transaction is automatically validated by the payment gateway. |
1 | Manual capture. The transaction must be validated manually by the merchant via their Merchant Back Office (or automatically via the Transaction/Validate Web Service function). |
Example of a payment form with a definition of the capture mode in INTERACTIVE mode:
<form method="POST" action="https://sogecommerce.societegenerale.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="20190626164147" /> <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>