Creating a Franfinance payment request
- Use the required fields below to create your payment form.
Field name Description Format Value 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.
enum FRANFINANCE_3X;
to directly call the Franfinance 3XWEB payment button.FRANFINANCE_4X
to directly call the Franfinance 4XWEB payment button.
vads_page_action Action to perform enum PAYMENT vads_amount Payment amount in the smallest currency unit (cents for euro). n..12 E.g.: 30000 for EUR 300. vads_ctx_mode Mode of interaction with the payment gateway enum TEST orPRODUCTION vads_currency Numeric currency code to be used for the payment, in compliance with the ISO 4217 standard (numeric code). n3 Possible values: - 978 (EUR)
vads_action_mode Acquisition mode for payment method data enum INTERACTIVE vads_cust_email Buyer’s e-mail address ans..128 E.g.: abc@example.com vads_cust_first_name Buyer's first name. The following characters are accepted:- Alphabetical [aA-zZ]
- Numeric [0-9]
- Special " ' ` _ + . - @ ,
- The apostrophe character that is accepted is the character 039 of the ISO 8859-1 table
- The accepted quotation mark character is 034 from the ISO 8859-1 table
- Space
- All characters of the all languages alphabets.
ans..50 E.g.: John vads_cust_last_name Buyer's name. The following characters are accepted:- Alphabetical [aA-zZ]
- Numeric [0-9]
- Special " ' ` _ + . - @ ,
- The apostrophe character that is accepted is the character 039 of the ISO 8859-1 table
- The accepted quotation mark character is 034 from the ISO 8859-1 table
- Space
- All characters of the all languages alphabets.
ans..50 E.g.: Doe vads_cust_phone Shipping buyer’s phone number Required field.
n10 E.g.: +31421234567 or +31-42-12-34567 vads_cust_cell_phone Buyer’s cell phone number Required field.
n10 E.g.: +31421234567 or +31-42-12-34567 vads_cust_address Postal address Accepted characters:
- Alphabetical [aA-zZ]
- Numeric [0-9]
- Special " ' ` _ + . - @ ,
- The apostrophe character that is accepted is the character 039 of the iso 8859-1 table
- The accepted quotation mark character is 034 from the iso 8859-1 table
- Space
- All characters of the all languages alphabets.
ans..50 E.g.: Rue de l'Innovation vads_cust_zip ZIP code. Accepted characters:
- Alphabetical [aA-zZ]
- Numeric [0-9]
an..10 E.g.: 31670 vads_cust_city City. Accepted characters:
- Alphabetical [aA-zZ]
- Numeric [0-9]
- Special " ' ` _ + . - @ ,
- The apostrophe character that is accepted is the character 039 of the iso 8859-1 table
- The accepted quotation mark character is 034 from the iso 8859-1 table
- Space
- All characters of the all languages alphabets.
ans..50 E.g.: Labège 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 Respect the YYYYMMDDHHMMSS format
E.g.: 20200101130025vads_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_version Version of the exchange protocol with the payment gateway enum V2 - Add optional fields according to your requirements (see Using additional features chapter of the Implementation Guide Hosted Payment Page).
- Compute the value of the signature field using all the fields of your form that start with vads_ (see chapter Computing the signature of the Implementation Guide Hosted Payment Page available on our website).