Creating a deferred payment

A deferred payment is a payment debited all at once with a capture delay that is strictly greater than 0 days.

An information request will be made if the capture delay is greater than the validity period of an authorization request (see table).

The information request is made in order to check the card validity. For acquirers who do not support information request, an authorization request for 1 EUR will be made (see table).

  1. Use all the fields of the table below to create your payment form.
    Field name Description Format Value
    vads_site_id Shop ID n8 E.g.: 12345678
    vads_ctx_mode Defines the mode of interaction with the payment gateway. enum TEST or PRODUCTION
    vads_trans_id Transaction number n6 E.g.: 123456
    vads_trans_date Date and time of the payment form in UTC format n14

    Respect the YYYYMMDDhhmmss format

    E.g.: 20170701130025
    vads_amount Payment amount in the smallest currency unit (cents for euro). n..12 E.g.: 3000 for 30,00 EUR
    vads_currency Numeric currency code to be used for the payment, in compliance with the ISO 4217 standard (numeric code). n3 E.g.: 978 for euro (EUR)
    vads_action_mode Acquisition mode for credit card data enum INTERACTIVE
    vads_page_action Action to perform enum PAYMENT
    vads_version Version of the exchange protocol with the payment gateway enum V2
    vads_payment_config Payment type enum SINGLE
    vads_capture_delay Delay before capture in the bank, the value must be greater than 0. n..3 E.g : 3
    vads_validation_mode Specifies the validation mode of the transaction (manually by the merchant, or automatically by the payment gateway). n1 0 or 1 or absent or empty
  2. Set the vads_payment_config field to SINGLE.
  3. Set the vads_capture_delay field to a value greater than 0.
    Warning: If the card used for the payment is a debit card, the payment request is qualified as immediate payment and the vads_capture_delay field is automatically set to 0 in the response.
  4. Set the vads_validation_mode field to 0 for an automatic validation (the payment will be automatically captured at the bank) or to 1 for a manual validation (the payment will be captured in the bank after a manual validation in the Expert Back Office).
  5. Fill in the vads_currency field with the code of the desired currency using the currency table (E.g.: 978 for euro (EUR)
  6. Add optional fields according to your requirements (see chapter Using additional features).
  7. 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 form for a deferred payment:
<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="3000" />
<input type="hidden" name="vads_capture_delay" value="3" />
<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="20190629130025" />
<input type="hidden" name="vads_trans_id" value="130025" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="NrHSHyBBBc+TtcauudspNHQ5cYcy4tS4IjvdC0ztFe8="/>
<input type="submit" name="pay" value="Pay"/>
</form>