Creating a ‘Use a token to create a recurring payment’ form

Use case: using an existing and valid token to create a recurring payment.


No payments will be made during the subscription.

The first payment will be made once the due date is reached, between 12 a.m. and 5 a.m..

  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 SUBSCRIBE
    vads_ctx_mode Operating mode. enum TEST or PRODUCTION
    vads_action_mode Acquisition mode for payment method data. enum INTERACTIVE
    vads_identifier Token (unique) 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_site_id Shop ID n8 E.g.: 12345678
    vads_sub_amount Installment amount (in the smallest currency unit) n..12 E.g.: 3000 for 30,00 EUR
    vads_sub_effect_date Recurring payment start date. n8 E.g.: 20150601
    vads_sub_currency Code of the currency used for the recurring payment n3 E.g.: 978 for euro (EUR)
    vads_sub_desc Rule for recurring payments to apply according to the iCalendar RFC5545 specification. string E.g.: RRULE:FREQ=MONTHLY;COUNT=12; BYMONTHDAY=10 (for installment payments occurring on the 10th day of each month for 12 months)
    vads_trans_date Date and time of the payment form in UTC format. n14 E.g.: 20150501130025
    vads_version Version of the exchange protocol. string V2
    The vads_sub_effect_date time value must not have passed

  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).