User's Manual

ManualsBrandsPayPal ManualsSoftwarePayPal Merchant - 2005

Table Of Contents

Preface
Introduction
- PayPal-Supported Currencies
- Additional Information
PayPal Payments Overview
- PayPal Account Optional
- Buy Now and Donations Buttons
- Shopping Cart
- Custom Payment Pages
- Calculating Shipping, Handling, and Tax
- Contact Telephone Number
- Auto Return
- Back-end Integration Methods
  - Instant Payment Notification
  - Payment Data Transfer
- Payment Receiving Preferences
- Refunds
- Multi-User Access
- Reports
- Subscriptions
- Payment Flow Overview
Getting Started
- Managing Your PayPal Merchant Account
  - Account Profile
  - Payment Receiving Preferences
PayPal Account Optional
- Turning PayPal Account Optional On or Off
- Your Customer’s Experience
  - What Your Customer Sees
Creating Buy Now and Donation Buttons
- How Buy Now and Donations Work
  - What Your Customer Sees
  - What You See
- Buy Now and Donations Button Factory
- Notifications You Receive
Creating Shopping Cart Buttons
- How It Works
  - What Your Customer Sees
  - What You See
- PayPal Shopping Cart Button Factory
  - Getting Started
  - Creating Your Shopping Cart Button
- How You Get Your Money
- Notifications You Receive
Adding PayPal to Your Third- party Shopping Cart
- Passing the Aggregate Shopping Cart Amount to PayPal
  - Passing Individual Items to PayPal
Custom Payment Pages
- Examples of Custom Payment Pages
- Getting Started
- Adding a Page Style
- Editing a Page Style
- Previewing a Page Style
- Making a Page Style Primary
- Removing a Page Style
- Overriding Page Style Settings
- Background Colors and Error Messages
Calculating Shipping, Handling, and Tax
- Getting Started
- Sales or Value Added Tax Collection
  - Overriding Tax Setting Per Transaction
- Shipping Calculation
Creating Customer Contact Telephone
- How It Works
  - What You See
  - What Your Customer Sees
- Getting Started
- Notifications You Receive
Auto Return
- How Auto Return Works
- Setting Up Auto Return
- Subscription Password Management and Auto Return
Backend Integration - Payment Notifications
- Emails
- Reporting
- Instant Payment Notification (IPN) and Payment Data Transfer (PDT)
- Payment Data Transfer
- Instant Payment Notification (IPN)
- Processing Refunds
Using Multiple Currencies
- Receiving Money
  - Accepting Payments
  - Managing Currency Balances
Language Encoding for Your Data
- Background Information
- Changing Your Language Encoding
- Setting Language in Website Payments: charset
Testing
- Website Payments, PDT, and IPN
- Your PayPal Button
  - Testing Tips
  - Third-Party IPN Testing Solutions
Processing eChecks
- Blocking eChecks
- Refunding eChecks
Security
- Notification Validation
- Button Encryption
- Multi-User Access
  - Getting Started
- Using Secure Socket Layer (SSL)
  - General Information
  - SSL Certificate Providers
HTML Samples
- PayPal Buy Now and Donation Buttons HTML and Variables
- PayPal Shopping Cart HTML and Variables
- Prepopulating Your Customer’s PayPal Sign-Up
IPN and PDT Variables
- About These Tables of Variables
- test_ipn Variable in Sandbox
- IPN Variables in All Posts
- Buyer Information
- Basic Information
- Advanced and Custom Information
- Shopping Cart Information
- Currency and Currency Exchange
- Auctions
- Mass Payment
- Subscriptions Variables
- Dispute Notification Variables
- PDT-Specific Variables
Country Codes
- ISO 3166 Standard Country Codes

Merchant User Manual and Integration Guide May, 2005 71

Adding PayPal to Your Third-

party Shopping Cart

Some Web developers may wish to integrate PayPal payment processing with their own third-

party shopping cart instead of the standard PayPal Shopping Cart. Please use the following

instructions and variables to allow your buyers to pay with PayPal when they are ready to

check out after adding all of their items to your third-party shopping cart.

There are now two ways to integrate your third-party shopping cart with the PayPal payment

flow. The first is to pass in the aggregate amount of the Cart payment, rather than of the

individual items. The second is to pass details of the items that have been selected to PayPal,

instead of an aggregated amount for the entire Cart.

For a complete list of variables, see “PayPal Shopping Cart HTML and Variables” on

page 137.

NOTE: Posting the necessary variables to PayPal as described in the following instructions

will probably require you to implement some scripting on your website.

Passing the Aggregate Shopping Cart Amount to PayPal

If you wish, you may aggregate your entire shopping cart and pass the total amount into

PayPal’s Buy Now code. In other words, you will need to post a single name for the entire cart

and the total price of the cart’s contents as though it were a purchase of a single item.

One drawback of this method is that your buyers will not be able to see the individual items

appearing in their carts. In addition, you cannot change our variable names, nor can you add

your own variable names.

Passing Individual Items to PayPal

If your third-party shopping cart can be configured to pass individual items to PayPal,

information about the items will be included in the buyer’s and seller’s History logs and

notifications. To include information about the items, you will post HTML form elements to a

new version of PayPal’s Shopping Cart flow. This process is much like the one described in

Passing Aggregate Shopping Cart Amount to PayPal, with the following exceptions:

1. Set the cmd variable to _cart.

2. Replace this required HTML line:

with