Creating a 'Payment by token’ form

Use case: one-click payment (using an existing and valid token).

In the context of the application of the PSD2, the CVV entry as well as cardholder authentication are required during a payment by token, as long as the buyer is present. The vads_threeds_mpi field is taken into account to allow for potential authentication without buyer interaction.

  1. Use all the fields presented in the table below to create your form.
    Field name Description Format Value
    vads_page_action Action to perform enum PAYMENT
    vads_amount Payment amount (in the smallest currency unit) n..12 E.g.: 3000 for 3000 XPF
    vads_ctx_mode Operating mode. enum TEST or PRODUCTION
    vads_currency Code of the currency used for the payment. n3 E.g.: 953 for CFP Franc (XPF)
    vads_action_mode Acquisition mode for payment method data. enum INTERACTIVE
    vads_identifier (unique) token associated with a payment method. ans..50 E.g.: MyToken
    Note: two possible formats:
    • an32: if the identifier is generated by the payment gateway
    • ans..50: if the identifier is generated by the merchant.
    vads_payment_config Payment type enum SINGLE
    vads_site_id Shop ID n8 E.g.: 12345678
    vads_trans_date Date and time of the payment form in UTC format. n14 E.g.: 20190501130025
    vads_trans_id Unique ID of a transaction. n6 E.g.: 123456
    vads_version Version of the exchange protocol. string V2
  2. Add optional fields according to your requirements (see chapter Using additional features).
  3. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).

The list of fields returned in the notification is described in the chapter Payment by token.