Customize PayPal checkout pages
Last updated: Sept 19th, 1:44am
Your PayPal Business or Premier account profile contains the account information, financial information, and selling preferences for your organization. Using your account profile, you can set options to control the way your PayPal checkout pages look and operate, regardless of which PayPal payment solutions you use as a PayPal merchant.
This feature is now limited to displaying your logo image on the standard PayPal checkout page.
-
Merchants who use PayPal payment buttons (PayPal Payments Standard) can set the
image_url
HTML variable. -
Merchants who use Express Checkout can call the
SetExpressCheckout
API operationLOGOIMG
NVP field orcpp-logo-image
SOAP field to include your company logo.
Customize the checkout experience
You can customize the checkout experience further using the following features:
- Auto return the buyer to your website
- Make PayPal account optional at checkout
- Provide your customer service number
- Get contact telephone numbers
Auto return the buyer to your website
With auto return for PayPal payments, buyers do not click a button to return to your website after completing payments with PayPal. Auto return applies to Express Checkout and all PayPal Payments Standards payment buttons, including Buy Now, Shopping Cart, Subscription, and Donate buttons.
Auto return shortens the checkout flow and immediately brings your buyers back to your website upon payment completion. To set up auto return, you must enable it in your PayPal account profile and enter the full path of the return URL to redirect your buyers back to your website. The Return URL is applied to all of your auto return payments unless you override the return URL for individual transactions using a form or API field. In this case, the return URL passed in the form or API field will override what is specified in your account profile settings. At any time, you can specify a different return URL for all transactions by changing it in your account profile settings.
As specified in the PayPal User Agreement and PayPal Merchant Services Agreement, you must provide verbiage on the page displayed by the return URL that includes the following information:
- Communicate to the buyer that the payment was made and the transaction completed.
- Explain that payment transaction details are emailed to the buyer.
What payers see with auto return enabled
When you enable auto return, payers see an alternative payment confirmation page for a few seconds before PayPal automatically returns them to your website.
Momentary payment confirmation with auto return enabled
Enable auto return
By default, auto return is disabled.
To enable auto return:
-
Log in to your PayPal business account at paypal.com.
-
In the Profile menu, click Profile and settings.
-
In the left menu, click My selling tools.
-
In the Selling online section, click Update next to Website preferences.
-
In Auto Return for Website Payments, click On.
-
In the Return URL field, enter the full path of the URL to which you want to redirect buyers when their payment is complete. Include
HTTP://
orHTTPS://
in the path. -
At the bottom of the page, click Save.
Set the return URL for individual transactions
Merchants who use PayPal Payments Standard buttons can override the return URL on individual transactions.
Merchants who use Express Checkout can specify the RETURNURL
and CANCELURL
fields with the SetExpressCheckout
API operation. For an example, see initiate a payment in the Express Checkout integration guide.
Subscriptions password management and auto return
If you use the Subscriptions Password Management feature of PayPal Payments Standard subscribe buttons, make sure that auto return is disabled to display the PayPal-generated user name and password to the subscriber.
Make PayPal account optional at checkout
When you enable PayPal account optional, buyers can pay by credit card without signing up for PayPal accounts. Buyers can, but they are not required to, sign up for a PayPal account by using the address and credit card from the completed transaction. By default, PayPal account optional is enabled for new PayPal Premier and Business accounts.
When you disable PayPal account optional, buyers without PayPal accounts must sign up for a PayPal account. They can pay by credit card but they must agree to sign up for a PayPal account before completing their transactions and making their payments. You might want to disable PayPal account optional if you already accept credit card payments through a different payment processor and you implement a PayPal solution that lets PayPal account holders select PayPal on your payment options page.
The checkout experience with account optional disabled
The diagram illustrates the checkout steps when the PayPal account optional is disabled.
This checkout flow begins when the buyer is ready to purchase an item from your website and clicks Buy Now.
- With PayPal account optional disabled, the buyer must either log in to PayPal or create a PayPal account.
- The buyer confirms the transaction details before paying. PayPal displays a transaction confirmation page to let buyers confirm the details before completing the transaction. If the buyer created a new PayPal account, an account confirmation message is displayed at the top of the page. The buyer clicks Pay Now on the confirmation page.
- The buyer views and prints the PayPal payment confirmations. PayPal displays a payment confirmation page after the buyer pays to notify the buyer that the transaction completed successfully. This page contains the PayPal transaction ID and a link to the buyer's PayPal account overview or Activity page. The buyer can click Print Receipt.
- PayPal sends email notices to the buyer confirming the transaction and in the case of new PayPal members, an account creation notice.
Disable PayPal account optional
By default, the PayPal account optional feature is enabled.
To disable PayPal account optional:
- Log in to your PayPal business account at paypal.com.
Click your profile name in the top right corner of your account and then click Account Settings.
- From the left menu, click My selling tools.
- In the Selling online section, click the Update link next to Website preferences.
- In the PayPal Account Optional section, select Off.
- At the bottom of the page, click Save.
Provide your customer service number
If you offer buyers customer service by phone, you can provide your customer service phone number on the PayPal checkout pages. Buyers who have questions during checkout can talk to customer service agents before completing their purchases.
For merchants who use the PayPal payments button (PayPal Payments Standard), this option affects only Buy Now, Add to Cart, and Cart Upload checkout pages.
-
Access your custom payment page settings.
-
Under the Merchant service options heading on the Options tab, select Display your phone number to customers.
Your current phone number appears. If you do not have a phone number on file, you might see a link to Change or enter your phone number.
-
Click Save.
Get contact telephone numbers
Contact Telephone Number is a feature that lets you obtain the contact telephone numbers that PayPal collects from your buyers. Contact Telephone Number is off by default. PayPal always collects contact telephone numbers from PayPal account holders to help confirm their identities and to contact them if that is required to resolve problems on their accounts.
To enable the Contact Telephone Number feature, use one of these methods:
- Enable buyers to share their telephone numbers during checkout
- Require that buyers share their telephone numbers during checkout
When people share their contact telephone numbers with you, PayPal includes their shared numbers in the transaction details section of payment authorization notices sent by email. Also, PayPal displays the shared numbers in the Transaction Details page for transactions in which contact telephone numbers were shared. These actions let you and your payers know that contact telephone numbers were shared as part of the transaction.
-
Log in to your PayPal business account at paypal.com.
Click your profile name in the top right corner of your account and then click Account Settings.
-
From the left menu, click My selling tools.
-
In the Selling online section, click the Update link next to Website preferences to see the Website Payment Preferences page.
-
In the Contact Telephone Number section, select one of the following options:
- On (Optional Field). PayPal lets payers share their telephone numbers with you, as an option.
- On (Required Field). PayPal informs payers that their telephone numbers will be shared with you because you require it.
- Off (PayPal recommends this option). PayPal does not share payers’ telephone numbers with you.
-
Click Save.
Auto-calculate sales tax
With PayPal payment buttons (PayPal Payments Standard), you can have PayPal calculate sales tax (also called value-added tax or VAT) automatically. PayPal calculates sales taxes based on rates that you specify in your account profile.
You can set up the following types of tax rates:
- Domestic (U.S. only) tax rates by state or zip code.
- Canadian tax rates by province.
- International sales tax rates by country or jurisdiction.
After you set up sales tax rates in your account profile, PayPal calculates the tax for purchase transactions automatically. Buyers see the tax as a separate item during checkout, based on the shipping addresses that they provide.
Buyers see sales taxes before they pay
If buyers change their shipping addresses, PayPal re-calculates the tax and displays the new amount.
Use the PayPal automatic sales tax calculation feature to set up and manage domestic or international sales tax rates and override sales tax calculations on individual transactions.
This feature also automatically resolves overlapping tax rates. More than one sales tax rate can apply to a buyer. For example, in the following image, all three of the domestic sales tax rates apply to a buyer in the 94044 zip code.
When multiple rates apply, the most specific rate is used. For a buyer in zip code 94044, the most specific rate is the single zip code rate of 8.25%. For a buyer in zip code 94056, the most specific rate is the range of zip codes with a rate of 7.75%.
Three domestic sales tax rates
Access your sales tax rates in your account profile
To view or modify your sales tax rates in your account profile:
- Log in to your PayPal business account at paypal.com.
Click your profile name in the top right corner of your account and then click Account Settings.
- From the left menu, click My selling tools.
- In the Selling online section, click the Update link next to Sales tax to see the Sales Tax page.
Sales tax rates in your account profile
Set up domestic sales tax rates
From the sales tax settings in your PayPal account profile, you can create sales tax rates for a state, zip code, or zip code range. To add a rate, click the Add New Sales Tax link in the Set Up Domestic Tax Rates box.
You can add a tax rate for:
- A state
- A zip code
- A range of zip codes
Add a tax rate for a state
- The Configure sales tax by field defaults to the State option, which is correct.
- Select one or more states for the rate that you want to create. To select more than one state, press CTRL or Command.
- In the Tax Rate field, enter the sales tax rate.
- If applicable, select Apply rate to shipping amount.
- To add the rate, click Continue.
- To add the rate and another domestic sales tax rate, click Create another.
Add a tax rate for a zip code
- For Configure Sales Tax by, click Zip Code.
- Select Specific.
- Enter the zip code for the rate you want to create.
- Enter the sales tax rate in the Tax Rate field.
- If applicable, select Apply rate to shipping amount.
- To add the rate, click Continue.
- To add the rate and another domestic sales tax rate, click Create another.
Set up a domestic sales tax rate by zip code
Add a tax rate for a zip code range
- For Configure Sales Tax by, click the Zip Code option.
- Select Range.
- Enter the starting and ending zip code for the rate you want to create.
- Enter the sales tax rate in the Tax Rate field.
- If applicable, select Apply rate to shipping amount.
- To add the rate, click Continue.
- To add the rate and another domestic sales tax rate, click Create another.
Set up international sales tax rates
You can create the following types of international sales tax rates:
- For Canada, sales tax rates can be for one or more provinces.
- For countries other than the U.S. and Canada, sales tax rates apply to the entire country.
- Access your sales tax settings in your PayPal account profile.
- To add a rate, click Add New Sales Tax in the Set Up International Tax Rates box.
- Select the country.
- If you selected Canada, select one or more or all provinces. To select more than one province, press CTRL or Command.
- Enter the sales tax rate in the Tax Rate field.
- If applicable, select Apply rate to shipping amount.
- To add the rate, click Continue.
- To add the rate and another international sales tax rate, click Create Another.
Edit or delete sales tax rates
First, access your sales tax settings in your PayPal account profile.
- To edit a sales tax rate, select the rate and click Edit.
- To delete a sales tax rate, select the rate and click Delete.
Override sales tax calculations on individual transactions
Merchants who use PayPal payment buttons (PayPal Payments Standard) can override automatic tax calculation on an individual transaction or on individual items in a transaction, regardless of a buyer's location.
Express Checkout merchants cannot take advantage of the automatic tax calculation feature in the PayPal account profile and must calculate and pass sales tax to PayPal. For more information on tax amount fields, see the SetExpressCheckout
(NVP, SOAP) API operation reference page.
Auto-calculate shipping charges
Merchants who use PayPal payment buttons (PayPal Payments Standard) can take advantage of PayPal's automatic shipping charge calculation feature. PayPal calculates shipping charges based on rates that you specify in your account profile.
You can set up shipping rates in your PayPal account profile as follows:
- Domestic (U.S. only) shipping rates for regions defined by state or zip code.
- International shipping rates for regions defined by country or jurisdiction.
The following topics describe how to specify rates for different shipping methods, such as standard and express delivery, within shipping regions:
- Shipping calculations overview
- Configure auto-calculation of shipping charges
- Override shipping calculations on individual items or transactions
Shipping calculations overview
To set up shipping calculations in your PayPal account profile, see configure auto-calculation of shipping charges.
What buyers see during checkout
After you set up shipping rates in your account profile, PayPal calculates the shipping charges for purchase transactions automatically. PayPal prompts buyers to enter their shipping destinations on the first checkout page.
-
PayPal prompts buyers for shipping destinations
Buyers click the calculate total order amount link to enter information about their shipping destinations.
-
Buyers enter shipping destinations to calculate shipping charges
Buyers enter information about their shipping destinations, and click Update.
-
Buyers see shipping charges before they pay
PayPal calculates the shipping charges using the least expensive shipping method that you set up for the destination.
-
Buyers select their preferred shipping methods
PayPal lets buyers select their preferred shipping methods after they enter their billing information or log in to PayPal. If buyers change their shipping addresses or select a different shipping method, PayPal calculates the shipping charges again and displays the new amount.
Shipping regions
You organize your shipping rates primarily by the states and countries to which you ship your products. Some merchants make only domestic shipments. Other merchants make both domestic shipments and international shipments. Depending on territorial size, some merchants divide their domestic markets into smaller shipping regions, each with their own shipping rates.
Before you set up the shipping rates that PayPal uses to calculate shipping charges, decide whether:
- You ship only domestically or both domestically and internationally
- You want one set of rates for all U.S. domestic shipments, or you want rates for different domestic regions, such as western and eastern states
- You want one set of rates for all international shipments, or you want rates for different international regions, such as Europe and Asia
You can establish one set of shipping rates for all domestic and international destinations, but your shipping rates should reflect your costs of shipping, which generally vary between different domestic and international regions.
Shipping methods
Within each shipping region that you define, you specify specific shipping rates for the different shipping methods you want to offer buyers. A shipping method specifies a mode of shipment and the general time frame for delivery. For example, you might offer your domestic buyers two shipping methods: Standard Shipping
and Priority
.
For each region in which you offer a specified shipping method, you generally select different delivery time frames and different rates. Otherwise, you should not set up separate shipping regions.
For example, your Standard Shipping
method for the region where your shipments originate might specify a time frame of 2-3 Days
. A more distant domestic shipping region might specify a time frame of 3-7 Days
. You set the same rates for Standard Shipping
in all regions, but delivery times are longer for more distant ones.
As an alternative to differentiating on delivery time, you might differentiate on rates. For example, your Standard Shipping
method for all domestic regions might specify the same time frame of 2-3 Days
. You set more expensive rates for Standard Shipping
in more distant regions, but delivery times are the same for all regions.
Shipping rate bases
For each shipping method in each shipping region that you define, you specify the basis upon which your shipping rates are used to calculate the shipping charges for specific purchases. You can choose from the following shipping rate bases:
- Total order amount
- Total order weight
- Total item quantity
Generally, you specify the same shipping rate basis for all shipping regions and shipping methods that you define. Before you begin setting up the shipping rates that PayPal uses to calculate shipping charges, decide which basis is most suitable for the kinds of products you sell and the typical orders that your buyers place.
Shipping rate tables
For each shipping method you define, fill in a rate table to specify the rates that PayPal uses to calculate shipping charges. Rate tables let you specify tiered rates.
Shipping rate table with a basis of total order amount
Each row in a rate table represents a different tier. Each successive tier encompasses a successively increasing range within the rate basis. You specify a separate rate for each tier.
In the preceding example rate table, each successive tier encompasses an increasing range of order amounts. The first tier encompasses orders that total from $0.01 USD through and including $10.00 USD. The shipping rate for orders that fall within the first tier is 5% of the total order amount. The shipping charge for an order amount of $6.75 USD is $0.34 USD.
Shipping rates and currencies
When you set up shipping methods, specify the same currency for the shipping rates that you used to price the products on your website. Specify shipping rates for both domestic shipments and international shipments in your domestic currency, provided that you priced your products for international buyers in your domestic currency.
If you price your products in multiple currencies, specify international shipping rates in the same currencies that you priced your products for international buyers. For example, a merchant in London might price products in Pounds Sterling for British buyers, while also pricing the same products in Euros for Euro-zone buyers and U.S. Dollars for U.S. buyers.
Examples of cost methods and shipping calculations
The following examples demonstrate how different cost methods are applied when calculating shipping charges.
Calculate shipping charges with the flat amount cost method
When you choose Flat Amount as the cost method for shipping rates, PayPal expresses the costs for each price range as fixed amounts.
Flat amount cost method and shipping calculations
Assume the following shipping rates with a cost method of Flat Amount:
1Cost Price Ranges23,00 EUR 0,00 EUR - 49,99 EUR36,00 EUR 50,00 EUR - and up
The shipping charge for an order price of € 36,50 is € 3,00. The shipping charge for an order price of € 66,50 is € 6,00. This rate structure helps you recover your shipping costs from buyers.`
Calculate shipping charges with the percentage cost method
When you choose Percentage as the cost method for shipping rates, costs for each price range are expressed as percentages of the actual order price.
Assume the following shipping rates with a cost method of Percentage:
1Cost Price Ranges25.00 GBP % 0.00 GBP - 49.99 GBP34.00 GBP % 50.00 GBP - and up
The shipping charge for an order price of £ 36.50 is £ 1.83. The shipping charge for an order price of £ 66.50 is £ 2.66.
This rate structure encourages buyers to purchase more with discounted shipping rates on larger orders.
Examples of rate bases and shipping calculations
The following examples demonstrate how different shipping rates are applied when calculating shipping charges:
Calculate shipping charges based on amount of purchase
When you choose Total Order Amount or By Amount as the basis for shipping rates, tiers in the rate table represent increasing ranges of order amounts. Generally, you select By Amount as the rate basis if you want to encourage your buyers to buy more with increasing discounts on shipping charges.
You can specify a flat rate for each tier or a percentage of the order amount. Click either Flat Rate or Percent in the Shipping Rate section.
Flat rate shipping calculations
Assume the following shipping rate table with a basis of By Order and fixed amount pricing selected:
1From(EUR) To(EUR) Rate(EUR)20.01 49.99 3.00350.00 and up 2.00
The shipping charge for an order amount of € 36.50 EUR is € 3.00 EUR. The shipping charge for an order amount of € 66.50 EUR is € 2.00 EUR This rate structure encourages buyers to purchase more with discounted shipping on larger orders.
Percentage Rate Shipping Calculation
Assume the following shipping rate table with a basis of By Order and percentage rate pricing selected:
1From(JPY) To(JPY) Rate(%)20.01 49.99 5350.00 and up 4
The shipping charge for an order amount of ¥ 36.50 JYP is ¥ 1.38 JYP (36.50 x 5%). The shipping charge for an order amount of ¥ 66.50 JYP is ¥ 2.66 JYP (66.50 x 4%).
Calculate shipping charges based on weight of shipment
When you choose Total Order Weight or By Weight as the basis for shipping rates, tiers in the rate table represent increasing ranges of order weights. Generally, you select By Weight as the rate basis if you want to recover your shipping costs.
You can specify order weights in pounds or kilograms. Click either Lbs or the Kgs in the Shipping Rate section.
Weight-Based Shipping Calculations
Assume the following shipping rate table with a basis of By Weight:
1From(Kgs) To(Kgs) Rate(GBP)20.01 49.99 3.00350.00 and up 6.00
The shipping charge for an order that weighs 36.50 kg is £ 3.00 GBP. The shipping charge for an order that weighs 66.50 kg is £ 6.00 GBP.
Calculate shipping charges based on quantity of items shipped
When you choose Total Order Quantity or By Quantity as the basis for shipping rates, tiers in the rate table represent increasing ranges of order item counts. Generally, select By Quantity as the rate basis if all your products have a generally uniform size and weight, such as shoes.
Quantity-Based Shipping Calculations
Assume the following shipping rate table with a basis of By Quantity:
1From To Rate(USD)21 49 3.00350 and up 6.00
The shipping charge for an order with 36 items is $3.00 USD. The shipping charge for an order with 66 items is $6.00 USD.
Configure auto-calculation of shipping charges
US Merchants
- Access the Shipping Calculations page
- Add shipping methods
- View the configuration for a shipping method
- Edit the configuration for a shipping method
- Delete shipping methods
Non-US Merchants
Access the Shipping Calculations page
The first time that you set up shipping rates, the page sequence is tailored for creating your initial shipping regions, methods, and rates.
To add shipping regions, methods, and rates for the first time:
-
Log in to your PayPal business account at paypal.com.
Click your profile name in the top right corner of your account and then click Account Settings.
-
From the left menu, click My selling tools.
-
In the Shipping my items section, click the Update link next to Shipping calculations.
-
You might see the Shipping Calculations setup page if you're accessing this feature for the first time.
Or you might see the Shipping Calculations review page
Add shipping methods
Whenever you add a shipping method, you use one of two wizards to step you through the process. The domestic shipping wizard lets you configure shipping regions within the U.S., and the international shipping wizard lets configure foreign shipping regions. Shipping wizards let you configure a shipping region and all the shipping methods for it at one time.
Access the Shipping Calculations page in your PayPal account profile. Depending on which page you see, you can start a shipping wizard in one of these ways:
- Click Start on the Shipping Calculations setup page.
- Click Add New Shipping Method or Add Another Shipping Method link from the Shipping Calculations review page.
The steps in domestic and international shipping wizards are the same.
Page Sequence in a Shipping Wizard
-
Setting up the shipping region.
Select the U.S. states or the foreign countries for the shipping region, and select the currency in which you want to price the shipping rates for the shipping region. -
Configuring the shipping methods within the region.
Select a name and delivery time frame, specify a rate basis, and fill in the rate table. Repeat this step to configure all shipping methods for the shipping region.
Click Create Another to begin the configuration of the next shipping method or click Continue to proceed to the third and final step of the shipping wizard.
-
Saving the shipping methods configured with a shipping wizard.
Review the shipping region and the shipping methods, and Change them if you like before you save them.
You can also override shipping calculations on individual items or transactions.
Finally, click Save Shipping Methods to preserve the shipping methods that you set up with the shipping wizard. The shipping methods become available to buyers as soon as you save them.
View the configuration for a shipping method
To view the configuration for a shipping method:
- On the Access the Shipping Calculations page, select a domestic or international shipping method.
- Click View.
- On the review page, click Edit Settings to update the shipping method.
- Click Back to Shipping Methods.
Edit the configuration for a shipping method
To edit the configuration settings for a shipping method:
-
On the Access the Shipping Calculations page, select a domestic or international shipping method.
-
Click Edit.
-
Change any of the following settings:
Status Whether the shipping method is actively used to calculate shipping charges. A valid value is Active or Inactive, which control whether the shipping option is shown or hidden from buyers, respectively. Currency and Region The domestic regions or foreign countries currently selected for the shipping region. You cannot change the currency. To select different regions or countries, click the Change link. Use the shipping fee in the transaction instead of my calculator's settings Whether the shipping rates can be overridden by individual transactions if the information is passed to PayPal with HTML variables in the transaction. Valid value is Yes or No. Shipping Method Name A name for the shipping method. Select Delivery Time (Optional) A delivery time. Based On The rate basis for the shipping method. Valid value is By Amount, By Weight, or By Quantity. See Examples of Rate Bases and Shipping Calculations. Shipping Rates The shipping rates that PayPal uses to calculate shipping charges when buyers select the shipping method. Set shipping rates as fixed amounts or as percentages. -
Click Save Changes.
Delete shipping methods
You can delete one or more domestic or international shipping methods at one time. Follow the procedure below in either the Domestic Shipping Methods section or the International Shipping Methods section of the Shipping Calculations review page.
To delete one or more shipping methods:
- On the Access the Shipping Calculations page, select a domestic or international shipping method.
- Click Delete.
- Click Yes in the Delete Confirmation message box.
Calculate shipping charges automatically for non-US merchants
You can set up shipping rates in your account profile and let PayPal calculate shipping charges automatically.
To view or modify your shipping rates:
- Log in to your PayPal business account at paypal.com.
Click your profile name in the top right corner of your account and then click Account Settings.
- From the left menu, click My selling tools.
- In the Shipping my items section, click the Update link next to Postage calculations.
- The Postage Calculations page appears.
Postage Calculations Page for non-U.S. Merchants
Override shipping calculations on individual items or transactions
Sometimes you want to set special shipping rates for certain items, such as especially heavy ones that cost more to ship, or services and digital downloads that do not require shipping.
To do this, make sure that your PayPal account profile shipping options have overrides enabled. Then, override shipping calculation on individual items.
Enable overrides of shipping rates for individual transactions
By defaults, this feature is enabled for U.S. merchants.
To enable or disable this feature:
- On the Shipping Calculations page, select the shipping method.
- Click Edit.
- Within that shipping method, select Yes or No for the field.
- Click Save.
By default, this feature is disabled for non-U.S. merchants.
To enable or disable this feature:
- On the Postage Calculations page, select Click here to allow transaction-based postage values to override the profile postage settings listed above (if profile settings are enabled).
- Click Save.
Configure language encoding
Websites that use PayPal in different parts of the world work with different languages and different character encoding schemes. PayPal refers collectively to these differences as language encoding. You can set the default language encoding for your checkout pages as well as for the data that you exchange with PayPal.
Configure the language encoding of checkout pages
PayPal checkout pages are localized automatically. The display language of PayPal checkout pages can depend on the country of the buyer and of the merchant. You can also attempt to change the display language using API fields or an HTML form variable.
Configure the language encoding of your data
You can set the default language encoding that your website uses to exchange data with PayPal. When you sign up for a PayPal account, the system determines your default language and encoding based on your country of origin. For example, if you sign up with a French postal address, your language and encoding are set for Western European languages. The default settings are used for all transactions sent from your website to PayPal and all automated notifications sent from PayPal to your website. PayPal Payments Standard merchants who use PayPal payment buttons can override the default settings on individual transactions with the HTML charset
form variable.
Generally, the default language encoding preferences selected by PayPal is appropriate. In some cases, particularly in Asian countries or with certain operating systems, your default website language and/or encoding preferences may not match those used by your website. If they do not match, you must set your language encoding preferences to match the language and encoding that your website uses. Otherwise, data cannot be exchanged with PayPal.
Use your PayPal account profile to set:
- Your website's language. Set the character set used on your website, such as Western European, Japanese, or Russian.
- Encoding. Set the character encoding used on your website, such as
UTF-8
,EUC-JP
, orKOI8-R
.
Change your default website language
Changing your website language changes the character set used on your website, such as Western European, Japanese, or Russian.
- Log in to your PayPal business account at paypal.com.
- In the top right hand corner, click your name. In the dropdown that appears, chose Account Settings.
- From the left hand menu, select Website payments and then click update on PayPal button language encoding.
- On the Language Encoding screen, choose a language from the drop-down menu and click Save.
You will be taken back to your profile screen, but if you need to make further edits click on your name to go back and make other changes.
Change the encoding used by your website
This feature enables you to select an encoding for data that your website sends to PayPal. You can also choose a different encoding for the data sent by PayPal to you through Instant Payment Notification, history logs that you can download, and email notifications.
-
Log in to your PayPal business account at paypal.com.
Click your profile name in the top right corner of your account and then click Account Settings.
-
From the left menu, click My selling tools.
-
Scroll to the bottom, and under More selling tools click PayPal button language encoding. The Language Encoding page appears.
-
Ensure that the setting for Your website’s language is correct.
-
Click More Options. The More Encoding Options page appears.
-
From the Encoding drop-down menu, select the appropriate character encoding scheme for data that your website sends to PayPal.
-
To use the same encoding scheme for receiving data that PayPal sends to your website, ensure that Yes is selected.
-
To use a different encoding scheme, select No and select the encoding scheme to use to receive data from PayPal from the No, use drop-down menu.
-
-
Click Save to preserve both the encoding options that you selected on this page.
To return to the previous page and review your website language choice, click Cancel. However, selections that you made on the More Encoding Options page are lost.
Additional information
- HTML Variables for PayPal Payments Standard
- Include your company logo
- Initiate a payment
SetExpressCheckout
(NVP | SOAP)- Generate subscriber user names and passwords
- Checkout settings
- PayPal API locale codes
- Instant Payment Notification
- Download Account History
- Setting the Character Set — charset
- PayPal User Agreement
- PayPal Merchant Services Agreement