Table of Contents Website Payments Standard Integration Guide Intended Audience How to Use This Guide Revision History How Integration Using Website Payments Standard Works The Basic Page Sequence for Website Payments Standard Begin: Buyer is Ready to Purchase 1: Buyer Logs In to PayPal 2: Buyer Reviews Payment Details 3: Buyer Views PayPal Payment Confirmation End: Buyer Returns to Merchant Website How You Get Your Money Notifications You Receive About Payments Email Transaction History Downloadable History Log Instant Payment Notification (IPN) Other Integration Features Used with Website Payments Standard Using Your PayPal Account Profile The Account Profile Account Information Financial Information Selling Preferences Correspondence Between Profile Settings and HTML Variables Branding the PayPal Payment Pages Working with Custom Payment Pages Adding or Editing a Page Style Making a Page Style Primary Overriding Page Styles On Individual Transactions Tailoring the Payment Experience PayPal Account Optional Auto Return Getting Contact Telephone Numbers Automatic Calculation of Sales Tax Setting Up Domestic Sales Tax Rates Setting Up International Sales Tax Rates Resolving Overlapping Sales Tax Rates Overriding Sales Tax Calculations on Individual Transactions Editing or Deleting Sales Tax Rates Automatic Calculation of Shipping Charges (U.S. Merchants Only) Shipping Regions Shipping Methods Shipping Rate Bases Shipping Rate Tables Shipping Rates and Currencies Adding Shipping Rates for the First Time Adding One or More Shipping Methods for a Shipping Region Using a Wizard Viewing, Editing, and Adding Shipping Rates Viewing the Configuration of an Existing Shipping Method Editing the Configuration Settings of an Existing Shipping Method Deleting One or More Shipping Methods Examples of Rate Bases and Shipping Calculations Overriding Shipping Calculations on Individual Transactions Automatic Calculation of Shipping Charges (non-U.S. Merchants Only) Examples of Cost Methods and Shipping Calculations Overriding Shipping Calculation on Individual Transactions Blocking Certain Kinds of Payments Accessing Your Payment Receiving Preferences to Block Payments Blocking Payments from U.S. Payers without a Confirmed Address Blocking Payments in Currencies that You Do Not Hold Blocking Payments from Payers with Non-U.S. PayPal Accounts Blocking Payments Initiated through the Pay Anyone Subtab Blocking Payments by Credit Card Instead of Bank Account Blocking Payments Funded with eChecks Adding Your Credit Card Statement Name Language Encoding Your Data About Language Encoding for Exchanging Data with PayPal Changing Your Default Language Encoding Allowing Multiple Users to Access Your PayPal Account Adding a User Login to Your Account Changing the Privileges for a User Login Resetting the Password for a User Login Removing a User Login Handling Multiple Currencies Managing Currency Balances Accepting or Denying Cross-Currency Payments Single-Item Payment: Buy Now Buttons Creating Buy Now Buttons Adding More Details to the Buy Now Button Copying and Pasting the Buy Now Code Avoiding Problems With Pasted HTML Code Sample HTML Code for a Buy Now Button Sample URL Code for a Buy Now Email Payment Link Multiple-Item Payment: Shopping Carts How the PayPal Shopping Cart Works What The Shopper Sees with the PayPal Shopping Cart Creating PayPal Shopping Cart Buttons Adding More Details to the PayPal Shopping Cart Button Copying and Pasting the PayPal Shopping Cart HTML Code Avoiding Problems With Pasted HTML Code Pricing Items in Multiple Currencies Sample HTML Code for an Add to Cart Button Sample HTML Code for a View Cart Button How A Third Party Shopping Cart Works What The Shopper Sees with Third Party Shopping Carts What Merchants See Integrating Third Party Shopping Carts with PayPal Required Third Party Shopping Cart Variables Passing Individual Item Details to PayPal Setting the Tax for the Entire Cart Setting the Shipping Charge for the Entire Cart Passing the Aggregate Shopping Cart Amount to PayPal Securing Your Shopping Cart Contribution Payment: Donation Buttons The Page Sequence for Donation Buttons Begin: Donor is Ready to Contribute 1: Donor Logs In to PayPal 2: Donor Reviews Contribution Details 3: Donor Views PayPal Payment Confirmation END: Donor Prints PayPal Contribution Receipt Alternative ENDs: Returning Donors to Your Website How You Get Your Contributions Notifications You Receive About Contribution Payments Email Transaction History Downloadable History Log Instant Payment Notification (IPN) Creating Donation Buttons Adding More Details to the Donation Button Copying and Pasting the Donation Code Avoiding Problems With Pasted HTML Code Sample HTML Code for a Donation Button Sample URL Code for a Donation Email Payment Link Using Authorization & Capture Basic Authorization Process Honor Period and Authorization Period Basic Authorization & Capture Scenarios Capturing A Single Authorization Batch Capturing Multiple Authorizations Voiding an Authorization Capture Within 3 Days Capture From 4 - 29 Days One Authorization, Multiple Captures, and a Refund Lower Capture Amount Capture Up to 115% Authorization Expires Void Reattempted Capture Recommendations for Best Use of Authorization & Capture Capturing Funds on Basic Authorizations Buyer Approval for Basic Authorizations Voiding Basic Authorizations Issuing Refunds Refunding Within 60 Days of Payment Refunding After 60 Days Securing Your Website Payments Standard Buttons Creating an Encrypted Button on the PayPal Website Verifying Each Payment Manually Verifying Payments with Instant Payment Notification (IPN) Encrypting Buttons Dynamically With Encrypted Website Payments (EWP) Prerequisites to Using EWP Public Key Encryption Background Setting Up The Certificates Encrypting Your HTML Code Blocking Non-encrypted Website Payments Testing in the PayPal Sandbox HTML Form Basics for Website Payments Standard Form Attributes: ACTION and METHOD Hidden Input Variables Specifying the Website Payments Standard Product: cmd Variations on Basic Variables Prompting for Quantity in Buy Now Buttons: undefined_quantity Record Keeping with Passthrough Variables Setting the Character Set: charset Setting The Return URL on Individual Transactions Desired Currency on Individual Transactions Prepopulating FORMs Sample HTML for FORM Prepopulation Overriding Addresses Stored with PayPal Sample HTML for Overriding Addresses Stored with PayPal Instant Payment Notification: notify_url HTML Variables for Website Payments Standard Technical HTML Variables HTML Variables for Individual Items HTML Variables for Payment Transactions HTML Variables for Shopping Carts HTML Variables for Displaying PayPal Payment Pages HTML Variables for Prepopulating PayPal Payment Pages Address Handling (U.S. Merchants Only) Address Handling in the Website Payments Standard Basic Page Sequence Endpoint A Endpoints B, C, and D Endpoint E Endpoints F and H Endpoints G and K Endpoint I Endpoints J and L Address Handling in the PayPal Account Optional Page Sequence Endpoint A Endpoints B, C, and D Endpoint E Endpoints F and H Endpoint G Endpoint I Endpoints J and L Endpoint K Country Codes