Defining the capture mode (automatic/manual)
In the Expert 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 Expert 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 Expert 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 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.
Value | Description |
---|---|
Missing or empty | Takes the value defined in the Expert 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 Expert 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://secure.lyra.com/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>