Customizing PayPal checkout pages and the checkout experience

<< Merchant setup and administration guide


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.

The following checkout customization features have been deprecated:

Feature Discontinued date Replaced with
The gift and survey question options Sept. 8, 2016 None
Prompting buyers to accept marketing email messages Sept. 2016 None

Customizing PayPal checkout pages

This feature is now limited to displaying your logo image on the standard PayPal checkout page.

  • Merchants using PayPal payment buttons (PayPal Payments Standard) can use the image_url HTML variable. See HTML variables for details.
  • Merchants using Express Checkout can use the SetExpressCheckout API operation LOGOIMG NVP field or cpp-logo-image SOAP field to include your company logo.

Tailoring the checkout experience

You can customize the checkout experience further using the following features:

Auto returning the buyer to your website

With Auto return for PayPal payments, buyers will not have to click a button to return to your website after completing payments with PayPal. Auto return applies to Express Checkout as well as all PayPal Payments Standards payment buttons, including Buy Now, Shopping Cart, Subscription, Gift Certificate, and Donate buttons.

Note: The Gift Certificate button is discontinued as of February 1, 2017.

Auto return shortens the checkout flow and immediately brings your buyers back to your website upon payment completion. To set up Auto return, you need to turn it on 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.

Note: If you have turned on Auto return and have also chosen to turn on making PayPal account optional at checkout for new users, a new user will not be automatically directed back to your website but will be given the option to return.

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 has been made and that the transaction has been completed.
  • Explain that payment transaction details will be emailed to the buyer.

What Payers See with Auto Return On

With Auto Return on, instead of having to click a button on the payment confirmation page, payers see an alternative payment confirmation page for a few seconds before PayPal returns them automatically to your website.

Momentary Payment Confirmation with Auto Return On

Turning on Auto Return

Auto return is turned off by default.

To turn on Auto return:

  1. Log in to your PayPal business account at paypal.com.

  2. From the Profile menu, click Profile and settings.

  3. From the left menu, click My selling tools.

  4. In the Selling online section, click Update next to Website preferences. The Website Payment Preferences page is displayed.

  5. Under Auto Return for Website Payments, click On to enable Auto return.

  6. In the Return URL field, enter the full path of the URL, including HTTP:// or HTTPS://, to which you want to redirect buyers when their payment is complete.

    Note: PayPal checks the return URL that you enter. If the URL is not properly formatted or cannot be validated, PayPal will not activate Auto return.

  7. Scroll to the bottom of the page, and click Save.

Setting the return URL for individual transactions

For merchants using PayPal Payments Standard buttons, see override the return URL on individual transactions in the PayPal Payments Standard integration guide.

For merchants using Express Checkout, specify the RETURNURL and CANCELURL fields with the SetExpressCheckout API operation. For an example, see initiate a payment in the Express Checkout integration guide. For detailed reference information, see SetExpressCheckout (NVP or SOAP).

Subscriptions Password Management and Auto return

If you are using the Subscriptions Password Management feature of PayPal Payments Standard subscribe buttons, you must make sure that Auto return is turned off in order to display the PayPal-generated username and password to the subscriber.

Note: You can use Auto return with Subscriptions, which is a separate feature from Subscriptions Password Management.

Making PayPal account optional at checkout

With PayPal Account Optional turned on, buyers can pay by credit card without signing up for PayPal accounts. They are offered the chance to sign up for a PayPal account by using the address and credit card from the completed transaction, but they are not required to. PayPal Account Optional is turned on by default for new PayPal Premier and Business accounts.

With PayPal Account Optional turned off, 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. The use case for turning off PayPal Account Optional is if you already accept credit card payments through a different payment processor and you are implementing a PayPal solution only to let PayPal account holders select PayPal on your payment options page.

The checkout experience with account optional turned off

The following diagram illustrates the checkout steps when the PayPal Account Optional feature is turned off.

This checkout flow begins when the buyer is ready to purchase an item from your website and clicks a Buy Now button.

  1. With PayPal account optional turned-off, the buyer must either log in to PayPal or create a PayPal account.
  2. 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 the Pay Now button on the confirmation page.
  3. 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 choose to click the Print Receipt button.
  4. PayPal sends email notices to the buyer confirming the transaction and in the case of new PayPal members, an account creation notice.

Turning PayPal account optional off

The PayPal Account Optional feature is enabled by default.

To turn PayPal Account Optional off:

  1. Log in to your PayPal business account at paypal.com. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings.

    Note: If you do not see the profile icon on the top right, select Profile which appears in the top menu when the My Account tab is selected.

  2. From the left menu, click My selling tools.

  3. In the Selling online section, click the Update link next to Website preferences to see the Website Payment Preferences page.

  4. Scroll down to the PayPal Account Optional section of the page.

  5. Select the Off radio button to turn PayPal Account Optional off.

  6. Scroll to the bottom of the page, and click the Save button.

Providing 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.

  1. Follow the steps to access your custom payment page settings.
  2. Click the Options tab.
  3. Under the Merchant service options heading, select the Display your phone number to customers checkbox. The page expands to show your current phone number. You may see a link to Change or enter your phone number if you do not have a phone number on file.
  4. Click the Save button.

Getting 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.

You can enable the Contact Telephone Number feature in one of two ways:

  • Allow 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.

Important: In accordance with the PayPal User Agreement and PayPal Merchant Services Agreement, you may use contact telephone numbers only to communicate with the payer about the related transaction. You may not use them for unsolicited communication.

  1. Log in to your PayPal business account at paypal.com. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings.

    Note: If you do not see the profile icon on the top right, select Profile which appears in the top menu when the My Account tab is selected.

  2. From the left menu, click My selling tools.

  3. In the Selling online section, click the Update link next to Website preferences to see the Website Payment Preferences page.

  4. Scroll down the page to the Contact Telephone Number section.

  5. 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.

  6. Scroll to the bottom of the page and click Save.

Automatic calculation of 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.

Note: This feature does not apply to Express Checkout. Express Checkout merchants must calculate and pass sales tax to PayPal.

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 calculates the tax again and displays the new amount.

PayPal's automatic sales tax calculation feature allows you to do the following:

This feature also automatically resolves overlapping tax rates. It is possible that more than one sales tax rate will apply to a buyer. For example, in the image below, all three of the domestic sales tax rates apply to a buyer in zip code 94044.

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

Accessing your sales tax rates in your account profile

To view or modify your sales tax rates in your account profile:

  1. Log in to your PayPal business account at paypal.com. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings.

    Note: If you do not see the profile icon on the top right, select Profile which appears in the top menu when the My Account tab is selected.

  2. From the left menu, click My selling tools.

  3. 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

Setting up domestic sales tax rates

First, access your sales tax settings in your PayPal account profile. From here, you can create sales tax rates for a state, zip code, or zip code range. To add a new 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, add a tax rate for a specific zipcode and for a range of zip codes.

Add a tax rate for a State

  1. Leave the Configure sales tax by field unchanged because it defaults to the State option.
  2. Select one or more states for the rate you want to create. Hold down the CTRL or Command key to select more than one state.
  3. Enter the sales tax rate in the Tax Rate field.
  4. If applicable, click the checkbox labeled Apply rate to shipping amount.
  5. Click the Continue button to add the new rate and return to the Sales Tax page.
  6. Click the Create another button to add the new rate and then add another domestic sales tax rate.

To create a rate for a specific zip code

  1. For Configure Sales Tax by, click Zip Code.
  2. Click the Specific radio button.
  3. Enter the zip code for the rate you want to create.
  4. Enter the sales tax rate in the Tax Rate field.
  5. If applicable, click the checkbox labeled Apply rate to shipping amount.
  6. Click the Continue button to add the new rate and return to the Sales Tax page.
  7. Click the Create Another button to add the new rate and then add another domestic sales tax rate.

Setting up a domestic sales tax rate by zip code

To create a rate for a zip code range

  1. For Configure Sales Tax by, click the Zip Code option.
  2. Click the Range radio button.
  3. Enter the starting and ending zip code for the rate you want to create.
  4. Enter the sales tax rate in the Tax Rate field.
  5. If applicable, click the checkbox labeled Apply rate to shipping amount.
  6. Click the Continue button to add the new rate and return to the Sales Tax page.
  7. Click the Create Another button to add the new rate and then add another domestic sales tax rate.

Setting 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.
  1. First, access your sales tax settings in your PayPal account profile.
  2. To add a new rate, click Add New Sales Tax in the Set Up International Tax Rates box.
  3. Select the country for the rate you want to create.
  4. If you selected Canada for Country, select one or more provinces or select All Provinces. Hold down the CTRL or Command key to select more than one province.
  5. Enter the sales tax rate in the Tax Rate field.
  6. If applicable, click the checkbox labeled Apply rate to shipping amount.
  7. Click the Continue button to add the new rate and return to the Sales Tax page.
  8. Click the Create Another button if you would like to add a new rate and then add another international sales tax rate.

Editing or deleting sales tax rates

First, access your sales tax settings in your PayPal account profile.

  • To edit a sales tax rate, click the checkbox to the left of the rate and then click the Edit button.
  • To delete a sales tax rate, click the checkbox to the left of the rate and then click the Delete button.

Overriding sales tax calculations on individual transactions

Merchants using 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. See overriding sales tax calculations in the PayPal Payments Standard integration guide.

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.


Automatic calculation of shipping charges

Merchants using 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.

Note: Merchants using Express Checkout must calculate their own shipping charges. For more information on passing shipping rates to PayPal using Express Checkout, see the Express Checkout Instant Update API. Also, see the Express Checkout Customizing page, which discusses handling shipping addresses via the API.

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.

Within shipping regions, you can specify rates for different shipping methods, such as standard and express delivery.

For more information, see the following:

Shipping calculations overview

The following overview section explains PayPal's shipping calculations feature in further detail. To navigate directly to the instructions on how to modify your PayPal account profile, see Configuring 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.

  1. PayPal prompts buyers for shipping destinations
     

    Buyers click the calculate total order amount link to enter information about their shipping destinations.
     
  2. Buyers enter shipping destinations to calculate shipping charges
     

    Buyers enter information about their shipping destinations, and then they click the Update button (not shown).
     
  3. 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.
     
  4. 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 begin setting 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.

Calculating 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:

Cost                Price Ranges
&euro;3,00 EUR     &euro;0,00 EUR   -  &euro;49,99 EUR
&euro;6,00 EUR     &euro;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.

Calculating 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:

Cost           Price Ranges
5.00 GBP %     &pound;0.00 GBP   -  &pound;49.99 GBP
4.00 GBP %     &pound;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 the different kinds of shipping rates are applied when calculating shipping charges:

Calculating 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 choose between specifying a flat rate for each tier or specifying a percentage of the order amount. Click the Flat Rate or the Percent links in the Shipping Rate section to make your choice.

Flat rate shipping calculations

Assume the following shipping rate table with a basis of By Order and fixed amount pricing selected:

From(EUR)      To(EUR)       Rate(EUR)
0.01           49.99         3.00
50.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:

From(JPY)      To(JPY)       Rate(%)
0.01           49.99         5
50.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%).

Calculating 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 choose between specifying order weights in pounds or kilograms. Click the Lbs or the Kgs links in the Shipping Rate section to make your choice.

Weight-Based Shipping Calculations

Assume the following shipping rate table with a basis of By Weight:

From(Kgs)      To(Kgs)       Rate(GBP)
0.01           49.99         3.00
50.00          and up        6.00

The shipping charge for an order that weights 36.50 kg is £3.00 GBP. The shipping charge for an order that weights 66.50 kg is £6.00 GBP.

Calculating 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:

From           To            Rate(USD)
1              49            3.00
50             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.

Configuring auto-calculation of shipping charges

US Merchants

Non-US Merchants

Accessing the Shipping Calculations page

The first time you set up shipping rates, the page sequence is tailored for creating your initial shipping regions, methods, and rates.

To begin adding shipping regions, methods, and rates for the first time:

  1. Log in to your PayPal business account at paypal.com. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings.

    Note: If you do not see the profile icon on the top right, select Profile which appears in the top menu when the My Account tab is selected.

  2. From the left menu, click My selling tools.

  3. In the Shipping my items section, click the Update link next to Shipping calculations.

  4. You may 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

Adding 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.

First, 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 two ways:

  1. Click the Start button on the Shipping Calculations setup page.
  2. Or click the 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

  1. 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.

    Note: You cannot change the currency later when you edit shipping methods.
    After you select the U.S. states or foreign countries you want for the shipping region, click the Continue button to proceed to the second step of the shipping wizard.
     

  2. 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 of the shipping methods you want for the shipping region.
    Click the Create Another button to begin the configuration of the next shipping method or click the Continue button to proceed to the third and final step of the shipping wizard.
     

  3. 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 enable individual purchase transactions to override the rates for the shipping methods. Finally, click the Save Shipping Methods button 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.

Viewing an existing shipping method

To view the configuration of a shipping method:

  1. First, access the Shipping Calculations page.
  2. Select a domestic or international shipping method by clicking the checkbox next to its name.
  3. Click the View button. The View Domestic Shipping Method page or the View International Shipping Method page opens.
  4. From the review page, click the Edit Settings button if you want to alter the shipping method.
  5. Click the Back to Shipping Methods button when you are finished viewing the shipping method.

Editing an existing shipping method

To edit the configuration settings of an existing shipping method:

  1. First, access the Shipping Calculations page.

  2. Select a domestic or international shipping method by clicking the checkbox next to its name.

  3. Click the Edit button. The Edit Domestic Shipping Method page or the Edit International Shipping Method page opens.

  4. Change any of the following settings:
    Status — Select whether the shipping method is actively used to calculate shipping charges. Allowable values are: Active or Inactive, which control whether the shipping option is shown or hidden from buyers, respectively.
    Currency and Region — Displays 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: — Select whether the shipping rates can be overridden by individual transactions if the information is passed to PayPal with HTML variables in the transaction. Allowable values are: Yes or No.

    Important: Changing this setting for a specific shipping method changes the setting for all U.S. domestic and international shipping methods that use the same currency.

    Shipping Method Name — From the dropdown menu, select a name for the shipping method.
    Select Delivery Time —(Optional) From the dropdown menu, select a delivery time.
    Based On — Select the rate basis for the shipping method. Allowable values are: By Amount, By Weight and By Quantity. For more information, see Examples of Rate Bases and Shipping Calculations.
    Shipping Rates — Reconfigure the rows in the rate table to change the shipping rates that PayPal uses to calculate shipping charges when buyers select the shipping method. You can set shipping rates as fixed amounts or as percentages.

    Note: Changes that you make to active shipping methods become effective after a momentary delay.

  5. Click the Save Changes button.

Deleting 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.

Important: After you delete a shipping method, it cannot be recovered for use in future shipping calculations.

To delete one or more shipping methods:

  1. First, access the Shipping Calculations page.
  2. Select a domestic or international shipping method by clicking the checkbox next to its name.
  3. Click the Delete button.
  4. Click the Yes button in the Delete Confirmation message box.

Calculating 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:

  1. Log in to your PayPal business account at paypal.com. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings.

    Note: If you do not see the profile icon on the top right, select Profile which appears in the top menu when the My Account tab is selected.

  2. From the left menu, click My selling tools.

  3. In the Shipping my items section, click the Update link next to Postage calculations.

  4. The Postage Calculations page opens, as shown below.

Postage Calculations Page for non-U.S. Merchants

Overriding 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, first make sure that your PayPal account profile shipping options have overrides enabled, as described in the following section. Then, see the overriding shipping calculation on individual items section in the PayPal Payments Standard integration guide.

Enable or disable overrides of your shipping rates for individual transactions

Overrides are enabled by default for U.S. merchants and disabled by default for non-US merchants.

  • For U.S. merchants, this feature is enabled by default. To enable or disable this feature do the following.

    Important: Changing this setting for a specific shipping method also changes the setting for all U.S. domestic and international shipping methods that use the same currency.

    1. Access the Shipping Calculations page.
    2. Select the radio button next to an an existing shipping method, and then click the Edit button.
    3. Within that shipping method, select the Yes or No radio button for the field Use the shipping fee in the transaction instead of my calculator's settings:.
    4. Click the Save button.
  • For non-U.S. merchants, this feature is disabled by default. To enable or disable this feature do the following:

    1. Access the Postage Calculations page.
    2. Click the checkbox labeled Click here to allow transaction-based postage values to override the profile postage settings listed above (if profile settings are enabled).
    3. Click the Save button.

Configuring 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.

Configuring 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. See the locale codes reference page for more information.

Configuring 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 using PayPal payment buttons can override the default settings on individual transactions with the charset HTML form variable.

Important: If your language encoding preferences do not match the language and encoding that your website uses, your data cannot be exchanged with PayPal.

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 the following:

  • 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, or KOI8-R.

Note: For a complete list of supported character encodings, see Setting the Character Set — charset.

Changing your default website language

Changing your website language changes the character set used on your website, such as Western European, Japanese, or Russian.

  1. Log in to your PayPal business account at paypal.com. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings.

    Note: If you do not see the profile icon on the top right, select Profile which appears in the top menu when the My Account tab is selected.

  2. From the left menu, click My selling tools.

  3. Scroll to the bottom, and under More selling tools click PayPal button language encoding. The Language Encoding page opens.

  4. From the Your website’s language dropdown menu, select an appropriate setting.

  5. Click the Save button.

Changing the encoding used by your website

This feature allows 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, downloadable history logs, and email notifications.

  1. Log in to your PayPal business account at paypal.com. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings.

    Note: If you do not see the profile icon on the top right, select Profile which appears in the top menu when the My Account tab is selected.

  2. From the left menu, click My selling tools.

  3. Scroll to the bottom, and under More selling tools click PayPal button language encoding. The Language Encoding page opens.

  4. Ensure that the setting for Your website’s language is correct.

  5. Click the More Options button. The More Encoding Options page opens.

  6. From the Encoding dropdown menu, select the appropriate character encoding scheme for data that your website sends to PayPal.
    - If you want to use the same encoding scheme for receiving data that PayPal sends to your website, ensure that the Yes radio button is selected.
    - If you want to use a different encoding scheme, click the No radio button and select the encoding scheme you want to use to receive data from PayPal from the No, use dropdown menu.

  7. Click the Save button to preserve both the encoding options that you selected on this page.
    You can click the Cancel button to return to the previous page and review your choice for website language. However, selections that you made on the More Encoding Options page are lost.