• France
status page
Demo shops
assistance
FAQContact support
Search
Categories
Tags
Europe (English)
France
Spain
Europe (English)
India
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
SDD mandates by REST API
Snippets
Payment methods
Plugins
Marketplace
Guides
Merchant Back Office
Back Office Expert
Functional guides

Creating an immediate payment

In the immediate payment mode, the buyer pays the total amount for the purchase at once.

The payment is captured by the bank on the same day.

  1. Use all the fields presented in 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 Mode of interaction with the payment gateway enum TESTorPRODUCTION
    vads_trans_id Transaction number.

    Must be unique within the same day (from 00:00:00 UTC to 23:59:59 UTC).

    Warning: this field is not case sensitive.

    an6 E.g.: xrT15p
    vads_trans_date Date and time of the payment form in UTC format. n14

    Respect the YYYYMMDDHHMMSS format

    E.g.: 20200101130025
    vads_amount Payment amount in the smallest currency unit (cents for euro). n..12 E.g.: 4525 for EUR 45.25
    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 payment method 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_payment_cards Allows to force the card type to be used.

    It is recommended to provide a different payment button for each payment method on the merchant website.

    It is recommended not to leave the field empty.

    See the chapter Managing the payment methods offered to the buyer for more information.

    enum E.g.:
    • CB
    • CVCONNECT
    • MASTERCARD
    • VISA
    • SDD
    vads_capture_delay Delay before capture in the bank. n..3
    vads_validation_mode Validation mode n1 0 (Automatic)
    signature Signature guaranteeing the integrity of the requests exchanged between the merchant website and the payment gateway. ans..44 Compute the value of the fieldsignatureusing all the fields of your form that start withvads_(see chapter Computing the signature).
  2. Value the field vads_payment_config to SINGLE.
  3. Value the field vads_capture_delay to 0.
  4. Value the field vads_validation_mode to 0 for automatic validation (the payment will be automatically captured in the bank).
  5. Value the field vads_currency with the code of the desired currency using the currency table.
  6. Add the fields recommended for increasing chances of frictionless during the payment.
  7. Add optional fields according to your requirements (see chapter Using additional features).

Example of a form for an immediate 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="15000" />
<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_order_id" value="CX-1254" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_cards" value="CB" />
<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="20190626101407" />
<input type="hidden" name="vads_trans_id" value="pt156G" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="0WaYrONo3L0VZqMcvyVf8vT/g8KfZKJ+1jqiAs3Ehiw="/>
<input type="submit" name="pay" value="Pay"/>
</form>
Jobs
Legal
GDPR
25.18-1.11