• France
status page
demonstrations
assistance
FAQContact support
Search
Categories
Tags
English
French
English
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
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

Creating a payment request for placing the order

The choice of payment upon shipment is made at the moment of requesting payment when placing an order.

It generates an initial transaction of Verification type if the Payment upon shipment use case is transmitted in the request.

For more details on how to build the form and send the payment by redirection request, please see the Hosted Payment Page guide available in the online documentation archive.

  1. Use the fields presented in the table below to create your payment form.
    Field name Description Format Format
    vads_order_id Order ID. ans..64 E.g.: "55487856"
    vads_amount Total amount of order to be paid, expressed in cents. n..12 E.g.: 50500 for €505
    vads_currency Numeric code of the Euro currency in compliance with the ISO 4217 standard. n3 E.g.: 978
    vads_site_id Shop ID n8 E.g.: 12345678
    vads_ctx_mode Mode of interaction with the payment gateway enum TEST orPRODUCTION
    vads_trans_id Transaction number an6 E.g.: xrT15p
    vads_trans_date Date and time of the payment form in UTC format n14

    Respect the YYYYMMDDHHMMSS format

    E.g.: 20191201130025
    vads_action_mode Acquisition mode for payment method data enum INTERACTIVE
    vads_page_action Action to perform enum PAYMENT
    vads_payment_config Payment type enum SINGLE
    vads_version Version of the exchange protocol with the payment gateway enum V2
  2. The vads_capture_delay (capture delay) and vads_validation_mode (transaction validation mode) fields can be sent, but will be ignored in case of payment upon shipment (see: Deferred payment or payment upon shipment?).
  3. Add the vads_use_case field with the SHIPMENT_MULTIPLE_AUTHORIZATION value to indicate payment upon shipment with multiple authorizations. This value will appear in the shipment transaction details.
  4. Add optional fields according to your requirements (see chapter Using additional features Hosted Payment Page).
  5. Compute the value of the signature field using all the fields that start with vads_ (see chapter Computing the signature Hosted Payment Page available in our online documentation archive).
© 2025 {'|'} All rights reserved to Monetico Retail
25.22-1.11