Checkout Parameters
How to transfer customer information from your side to the Upclick checkout:
Upclick also offers the ability to carry over information from your site (app, website, email, etc) to the Upclick checkout page, already prefilled.
Below are some of the parameters you can pass through the URL:
Parameter | Description | How to use it? |
Email address. This parameter allows you to pass the email through the URL. |
Add to your url: &email=value e.g: &email=tom.smith@yahoo.com | |
fname | First name. This parameter allows you to pass the first name through the URL. | Add to your url: &fname=value e.g: &fname=tom |
lname | Last name. This parameter allows you to pass the last name through the URL. |
Add to your url: &lname=value
e.g: &lname=smith |
phone | Phone number. This parameter allows you to pass the phone number through the URL. |
Add to your url: &phone=value
e.g: &phone=1-888-555-1234 |
country | Force a country in the checkout page. Display the appropriate currency based on the country. (note: this parameter only controls the currency and not the language) |
Add to your url: &country=value
e.g: &country=fr ("fr" for FRANCE so the currency will be display in EUR) &country=ca ("ca" for Canada so the currency will be in CAD) |
culture | Force a language in the checkout page. Display the appropriate language. (note: this parameter only controls the language displayed and not the currency) |
Add to your url: &culture=value
e.g: &culture=en for English &culture=de for German … |
These parameters pre-fill the checkout fields. Your customers will not have to enter their information once again.
How to hide fields in a checkout page:
Merchants also have the ability to hide fields from a cart. They simply have to add parameters to their URL:
Parameter | Description | How to use it? |
Go directly to a specific step | Send the customer directly to the step of your choice in a 3 steps checkout. |
Add to your url: &step=value e.g: &step=2 or &step=3 (browse directly the step 2 or 3. Values can be 2 or 3 only) |
Hide confirmation email field (2nd email field) | Hide the confirmation email field in the first step of the checkout flow. |
Add to your url: &emc=;0
|
Hide phone field | Hide the phone number field in the checkout page. |
Add to your url: &phone=;0
|
Hide email field | Hide the email field in the checkout page. |
Add to your url: &email=;0
|
Hide country field | Hide the country field in the checkout page. (note: to be able to hide this field, you need to collect the value first) |
Add to your url: &country=value;0
e.g: &country=fr;0 ("fr" for FRANCE) &country=ca;0 ("ca" for Canada)… |
Hide fname field | Hide the first name field in the checkout page. (note: to be able to hide this field, you need to collect the value first) |
Add to your url: &fname=value;0 e.g: &fname=john;0 (“John” is the first name that you carried from your website) |
Hide lname field | Hide the last name field in the checkout page. (note: to be able to hide this field, you need to collect the value first) |
Add to your url: &lname=value;0
e.g: &lname=doe;0 (“Doe” is the last name that you carried from your website) |
Hide zip field | Hide the zip code field in the checkout page. (note: to be able to hide this field, you need to collect the value first) |
Add to your url: &zip=value;0 e.g: &zip=11111;0 (“11111” is the zip code that you carried from your website) |
Hide language field | Hide the language field in the checkout page. (note: to be able to hide this field, you need to collect the value first) |
Add to your url: &culture=value;0
e.g: &culture=fr;0 (“fr” is the language that you carried from your website) |
Hide currency field | Hide the currency field in the checkout page. (note: to be able to hide this field, you need to collect the value first) |
Add to your url: & currency=value;0
e.g: & currency=usd;0 (“usd” is the currency value that you carried from your website) |
Hide state field | Hide the state field in the checkout page. |
Add to your url: &state=;0
|
Hide city field | Hide the city field in the checkout page. |
Add to your url: &city=;0
|
Hide address field | Hide the address field in the checkout page. |
Add to your url: &address=;0
|
Important notice:
Be cautious when hiding the “first name” and “last name” fields in the checkout as PayPal will not work in this scenario, unless the first name and last name values are carried from your side (website, app, email…). To process a transaction, PayPal requires these 2 values.
e.g: add these parameters to your checkout URL:
&fname=john;0&lname=doe;0
In this scenario, the fields “first name” and “last name” will be hidden in the checkout but the values will be carried in the checkout page, sale confirmation page and purchase confirmation email. If a customer wants to pay with PayPal, it will also work.
Upclick can hide these fields for you and only display them when PayPal is selected as a payment method.
If you hide the “first name” and the “last name” fields in the checkout but you carry these values from your side, the “cardholder name” field will be prefilled with the “first name” and “last name” values. If a customer selects PayPal as a payment method, these 2 fields will be hidden but the customer will be able to process the transaction.