User's Manual

ManualsBrandsPayPal ManualsSoftwarePayPal Merchant - 2005

121

122

123

124

125

126

127

128

129

130

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 121

Testing

Website Payments, PDT, and IPN

The PayPal Sandbox can be used to test the following functionality.

IMPORTANT:The Sandbox does not process real money.

z Web Payments: Use the Sandbox to test accepting PayPal as a payment mechanism on a

website. For more information, see the PayPal website and online help center.

z Shopping Cart Purchases: Use the Sandbox for testing the purchase of multiple items in a

single transaction and making a single payment. For more information, see Chapter 6,

“Creating Shopping Cart Buttons.”

z Subscriptions: Use the Sandbox for creating and publishing test/prototype Web pages and

other content to which only paying members will have access. For more information, see

the PayPal Subscriptions manual, which is available on the PayPal website.

z Refunds: A PayPal user providing a refund of money paid by another participant in a

transaction.

z Instant Payment Notifications (IPNs): Use the Sandbox to test such IPNs as payments

and reversals. For more information on implementing IPNs to the PayPal site, see “Instant

Payment Notification (IPN) ” on page 103.

In the Sandbox environment, an additional variable (ipn_test) is sent with IPNs, with a

value of 1 (one). The purpose of this variable is to provide clear differentiation between test

and real IPNs. It also allows developers to modify existing scripts so that they are easily

able to work with either live or Sandbox IPNs.

IMPORTANT:IPNs coming from the Sandbox cannot be verified against the live PayPal

site, and IPNs coming from the live site cannot be verified against the

Sandbox.

z Payment Data Transfer (PDTs): Use the Sandbox to test using your identity token, return

URL, and PDT settings.

For more information about implementing PDT, see “Payment Data Transfer” on page 96.

z Simulated transactions, such as difficult scenarios like successful and failed eChecks.

In order to test feature functionality in the Sandbox, you must first create a Developer Central

account. This will allow you to create multiple PayPal accounts, such as Seller and multiple

Buyer accounts, to simulate different scenarios (unconfirmed, verified, international, and so

on).