• 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

vads_theme_config

Description

Allows to personalize certain elements on the payment page, such as the custom template to be used, the button labels and some messages.

This parameter provides a list of keywords (codes), each associated with a value, that correspond to elements on payment pages.

Example:
vads_theme_config="SUBMIT_BUTTON_LABEL=PAY;TICKET_LABEL=PAYMENT RECEIPT"

See Back Office user manual - Advanced customizationfor more details on payment page personalization.

Input field.

Format map
Error code 32

Possible values

 
Code Description
Features
RESPONSIVE_MODEL

Allows to override the custom template to be applied to the payment pages.

Example of use:

vads_theme_config="RESPONSIVE_MODEL=Model_1"

The use of custom templates requires the activation of the “Advanced customization” option.

RESPONSIVE_MAIL_MODEL

Allows to override the custom template to be used for e-mails.

Example of use:

vads_theme_config="RESPONSIVE_MAIL_MODEL=Model_1"

The use of custom templates requires the activation of the “Advanced customization” option.

HIGH_CONTRAST_MODE Allows to enable the high contrast mode to enhance color contrast and display the payment page in black and white.

Possible values: "true" or "false".

Example of use:

vads_theme_config="HIGH_CONTRAST_MODE=true"
SIMPLIFIED_DISPLAY Allows to reduce the volume of data to be loaded during the display of the payment page.

Deletes the language and logo selector from the footer.

Recommended for iframe and In-app integrations.

Possible values: "true" or "false".

Example of use:

vads_theme_config="SIMPLIFIED_DISPLAY=true"
FORM_TARGET Allows to define or display the return page at the end of payment.
Possible values:
  • _blank: in a new window or a new tab
  • _self: in the current frame
  • _parent: in the parent frame
  • _top: on the whole page
  • framename: in a specified frame

Example of use:

vads_theme_config="FORM_TARGET=_top"
3DS_LOGOS Allows to mask the “Verified By Visa” and “Mastercard Secure Code” logos on the card detail entry page.

Possible values: "true" or "false".

Example of use:

vads_theme_config="3DS_LOGOS=false"
Button labels
SUBMIT_BUTTON_LABEL Allows to edit the label of the “VALIDATE” button.

Example of use:

vads_theme_config="SUBMIT_BUTTON_LABEL=PAY"
CANCEL_FOOTER_MSG_RETURN The label of the “Cancel and return to the shop” button on the page of payment method selection, the card detail entry page, and the result page in case of payment failure.

Example of use:

vads_theme_config="CANCEL_FOOTER_MSG_RETURN=CANCEL"
SUCCESS_FOOTER_MSG_RETURN The label of the “Return to the shop” button on the result page in case of successful payment.

Example of use:

vads_theme_config="SUCCESS_FOOTER_MSG_RETURN=RETURN"
TICKET_LABEL The label of the “RECEIPT” button on the result page in case of successful payment.

Example of use:

vads_theme_config="TICKET_LABEL=PAYMENT RECEIPT"
Messages
MERCHANT_ MESSAGE

Allows to display a message above the transaction summary.

Requires for the Display a custom message checkbox to be checked via Settings > Customization > Payment pages tab > Logo group.

Example of use:

vads_theme_config="MERCHANT_MESSAGE=Transaction summary"
SECURE_ MESSAGE

Default value:The address of this payment website prefixed with https indicates that you are on a secure page and can safely proceed to your payment.

Example of use:

vads_theme_config="SECURE_ MESSAGE=You are on a website secured by TLS1.2. You can safely proceed to payment.”
SECURE_MESSAGE_REGISTER

Default value:The address of this payment website prefixed with https indicates that you are on a secure page and can safely enter your bank details.

REGISTER_ON_PAYMENT Allows to customize the text of the checkbox that appears during ASK_REGISTER_PAY.

Default value:I would like to register my payment method details for a future purchase

Labels that appear on the receipt and the payment pages
SITE_ID_LABEL

Default value:Merchant ID

ORDER_ID_LABEL Default value:Order reference
TRANSACTION_ID_LABEL Default value:Transaction number
TRANSACTION_AMOUNT_LABEL Default value:Amount
MULTI_DATE_LABEL Default value:Sale date

Information displayed only during an installment payment.

CUST_ID_LABEL Default value:Buyer reference

Information displayed only during a payment by token.

CUST_ADRESS_NUMBER_LABEL Default value:Street number

Information displayed only during a payment by token.

CUST_ADRESS_LABEL Default value:Address

Information displayed only during a payment by token.

CUST_ADRESS2_LABEL Default value:Address line 2

Information displayed only during a payment by token.

CUST_DISTRICT_LABEL Default value:District

Information displayed only during a payment by token.

CUST_CITY_LABEL Default value:City

Information displayed only during a payment by token.

CUST_COUNTRY_LABEL Default value:Country

Information displayed only during a payment by token.

CUST_PHONE_LABEL Default value:Phone

Information displayed only during a payment by token.

CUST_NAME_LABEL Default value:Buyer’s last name

Information displayed only during a payment by token.

RECURRENCE_AMOUNT_LABEL Default value:Amount per installment

Information displayed only during a payment by token.

RECURRENCE_INIT_AMOUNT_

NUMBER_LABEL

Default value:Number of installments of initial amount

Information displayed only during a payment by token.

RECURRENCE_INIT_AMOUNT_LABEL Default value:Initial amount of the recurring payment

Information displayed only during a payment by token.

SHOP_LABEL Default value:SHOP

Information displayed only on the PDF receipt.

SITE_URL_LABEL Default value:URL address

Information displayed only on the PDF receipt.

CUST_LANGUAGE Default value:Language

Information displayed only on the PDF receipt.

Category Payment page customization
Jobs
Legal
GDPR
25.18-1.11