Skip to content
View Categories

URL parameters and placeholders: pre-filled links and personal e-mails

Two tricks that save time: URL parameters fill in the fields of the payment page for the customer, and placeholders personalise the e-mails you send.

URL parameters #

At the end of your page link, add a ? followed by name=value. Add further parameters with &. Spaces are written as %20, and decimals with a point.

Valid in all tools #

Field Parameter
Amount (Pages, Donation) invoice_amount
Currency (Pages, Donation) invoice_currency
Purpose (Pages, Donation) invoice_number
Amount, currency, purpose in the Terminal amount, currency, purpose
Title contact_title
First name and surname contact_forename, contact_surname
Company contact_company
Street, postcode, town, country contact_street, contact_postcode, contact_place, contact_country
Telephone, e-mail contact_phone, contact_email
Text field contact_textbox
Discount code code
Your internal reference referenceId

Donation only #

What it does Parameter
Suggests an amount that can be changed donation[preselect_amount]=50
Fixes the interval donation[interval]=monthly
Suggests an interval that can be changed donation[preselect_interval]=annually
Preselects a purpose (1, 2, 3…) donation[preselect_purpose]=2
Hides the campaign description hide_description=1

Values for the interval: one_time, weekly, monthly, quarterly, annually.

Example. A link to the fees campaign suggesting CHF 80.- a year: add ?donation[preselect_amount]=80&donation[preselect_interval]=annually. For the Terminal you will find a full example in Terminal.

Parameters are there for convenience: the customer can still see the link. Before delivering goods or services, always check the amount paid under Payments.

Placeholders in e-mails #

In Paylink and Donation e-mails you can insert words in square brackets that become the real details when sent. You change the text of Paylink e-mails in Notifications, under Paylink.

Placeholder Becomes
[RECIPIENT_FIRST_NAME], [RECIPIENT_NAME] the customer’s first name, or first name and surname
[RECIPIENT_COMPANY] the customer’s company
[AMOUNT], [CURRENCY] amount and currency
[PURPOSE], [DESCRIPTION] purpose and description
[MESSAGE_OPTIONAL] the message you wrote
[PAYMENT_LINK_URL] the payment link (compulsory in Paylink e-mails)

In donation thank-you e-mails, do not remove [DONATION_DETAILS]: it contains the donation summary. The option to show placeholders displays the full list directly in the admin area.