PayPal Website Payments Standard - 2005 User Manual

Website Payments Standard Checkout Integration Guide

For Professional Use Only

Currently only available in English.

A usage Professional Uniquement

Disponible en Anglais uniquement pour l'instant.

Last Updated: November 2005

PayPal Website Payments Standard Checkout Integration Guide

Inc. Designated trademarks and brands are the property of their respective owners.

Notice of Non-Liability

PayPal, Inc. and the authors assume no liability for errors or omissions, or for damages, resulting from the use of this Manual or the information contained in this Manual.

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Chapter 1 How Website Payments Standard Works . . . . . . . . . .15

Example of the Basic Page Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

How You Get Your Money . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Notifications You Receive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Transaction History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Downloadable History Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Instant Payment Notification (IPN). . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

How To Use This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Other Standard Products and Features . . . . . . . . . . . . . . . . . . . . . . . . . 23

Website Payments Pro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Authorization & Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Related Online Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Complementary Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Chapter 2 Using Your Merchant Account Profile and Tools . . . . . .27

The Account Profile Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Account Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Financial Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Selling Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Correspondence Between Profile Settings and HTML Variables . . . . . . . . . . . . 28

Branding PayPal’s Payment Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Working with Custom Payment Pages. . . . . . . . . . . . . . . . . . . . . . . . . . 31

Adding or Editing a Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Making a Page Style Primary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Overriding Page Style Settings On Individual Transactions . . . . . . . . . . . . . . . 33

Streamlining Purchases with Website Payment Preferences . . . . . . . . . . . . . . . . 34

Account Optional or Website Payments Express . . . . . . . . . . . . . . . . . . . . 35

Auto Return . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Automatic Calculation of Shipping and Handling Cost and Tax . . . . . . . . . . . . . 45

Blocking Certain Kinds of Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

November 20053

Contents

Adding Your Credit Card Statement Name . . . . . . . . . . . . . . . . . . . . . . . . . 49

Getting Customer Contact Telephone Numbers . . . . . . . . . . . . . . . . . . . . . . . 49

Language Encoding Your Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Multi-User Access to Your PayPal Account . . . . . . . . . . . . . . . . . . . . . . . . . 55

PayPal-Supported Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Accepting or Denying Cross-Currency Payments . . . . . . . . . . . . . . . . . . . . 57

Managing Currency Balances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Issuing Refunds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Chapter 3 Single-Item Payment: Buy Now and Donations . . . . . . . 61

Using Buy Now or Donations Button Factory . . . . . . . . . . . . . . . . . . . . . . . . 61

Adding More Details to the Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Copy and Paste the HTML Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Sample Buy Now Button HTML and Hyperlink . . . . . . . . . . . . . . . . . . . . . . . . 65

Chapter 4 Multiple-Item Payment: Shopping Cart . . . . . . . . . . . 67

How the PayPal-Hosted Shopping Cart Works . . . . . . . . . . . . . . . . . . . . . . . 67

What The Customer Sees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Button Factory for PayPal-Hosted Shopping Cart . . . . . . . . . . . . . . . . . . . . . . 72

Adding More Details to the Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Copy and Paste the Shopping Cart HTML. . . . . . . . . . . . . . . . . . . . . . . . 74

Sample HTML for PayPal-Hosted Shopping Cart . . . . . . . . . . . . . . . . . . . . . . 75

How A Third-Party Shopping Cart Works . . . . . . . . . . . . . . . . . . . . . . . . . . 76

What The Customer Sees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

What You See . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Adding PayPal to Your Third-party Shopping Cart . . . . . . . . . . . . . . . . . . . . . . 82

Required Third-Party Shopping Cart Variables . . . . . . . . . . . . . . . . . . . . . 82

Passing Individual Item Details to PayPal . . . . . . . . . . . . . . . . . . . . . . . . 82

Setting the Tax for the Entire Cart. . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Passing the Aggregate Shopping Cart Amount to PayPal . . . . . . . . . . . . . . . . 83

Chapter 5 Encrypted Website Payments . . . . . . . . . . . . . . . . 85

Creating Your Public Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Creating Your Private Key Using OpenSSL . . . . . . . . . . . . . . . . . . . . . . . 86

Creating Your Public Certificate Using OpenSSL . . . . . . . . . . . . . . . . . . . . 86

Uploading Your Public Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

4 November 2005

Contents

Downloading PayPal's Public Certificate. . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Removing Your Public Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Blocking Unencrypted Website Payments . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Chapter 6 Testing in the PayPal Sandbox . . . . . . . . . . . . . . . 89

Chapter 7 Website Payments Standard HTML FORM Basics . . . . . . 91

FORM Attributes: ACTION and METHOD . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Hidden Input Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Specifying the Website Payments Standard Product: cmd . . . . . . . . . . . . . . . . . 92

Variations on Basic Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Prompting for Quantity in Buy Now or Donations: undefined_quantity . . . . . . . . . 92

Recordkeeping with Passthrough Variables . . . . . . . . . . . . . . . . . . . . . . . 92

Setting the Character Set: charset. . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Setting Return URL on Individual Transactions . . . . . . . . . . . . . . . . . . . . . 93

Desired Currency on Individual Transactions . . . . . . . . . . . . . . . . . . . . . . 93

URL-Encoding Variable Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Prepopulating FORMs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Sample HTML for FORM Prepopulation . . . . . . . . . . . . . . . . . . . . . . . . . 94

Overriding PayPal-Stored Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Sample HTML for Overriding PayPal-Stored Shipping Addresses . . . . . . . . . . . 95

Instant Payment Notification: notify_url . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Appendix A Website Payments Standard HTML Variables . . . . . . . .99

Appendix B Country Codes . . . . . . . . . . . . . . . . . . . . . . 109

ISO 3166 Standard Country Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

November 20055

Contents

6 November 2005

List of Tables

Table 1.1 How To Use This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Table 1.2 Hyperlinks for Fees, Security, User Agreement, Policies, Online Help, and

Customer Service 24

Table 1.3 PayPal Technical Documentation . . . . . . . . . . . . . . . . . . . . . 25

Table 2.1 Order of Page Style Customization Variables . . . . . . . . . . . . . . . 33

Table 2.2 PayPal-Supported Currencies, Currency Codes, and Maximum Transaction

Amounts 56

Table 4.1 Required Third-Party Shopping Cart Variables . . . . . . . . . . . . . . 82

Table 5.1 How Encrypted Website Payments Work . . . . . . . . . . . . . . . . . 85

Table 7.1 Allowed Values for cmd Variable . . . . . . . . . . . . . . . . . . . . . . 92

Table 7.2 Character Sets and Encodings Supported by PayPal . . . . . . . . . . . 93

Table A.1 Allowed Values for cmd Variable . . . . . . . . . . . . . . . . . . . . . . 99

Table A.2 HTML Variables: IPN Control notify_url. . . . . . . . . . . . . . . . . . . 99

Table A.3 HTML Variables: Item Information . . . . . . . . . . . . . . . . . . . . . 99

Table A.4 HTML Variables: Display Information. . . . . . . . . . . . . . . . . . . .100

Table A.5 HTML Variables: Transaction Information . . . . . . . . . . . . . . . . .103

Table A.6 HTML Variables Specific to Shopping Carts . . . . . . . . . . . . . . . .104

Table A.7 HTML Variables: Individual Items in Third-Party Shopping Carts . . . . .104

Table A.8 HTML Variables: Prepopulating PayPal FORMs or Address Overriding . .105

Table A.9 HTML Variables: Prepopulating Business Account Sign-up . . . . . . . .106

Table B.1 ISO 3166 Two-Character Country Codes. . . . . . . . . . . . . . . . . .109

Website Payments Standard Checkout Integration Guide November 2005 7

List of Tables

8 November 2005Website Payments Standard Checkout Integration Guide

List of Figures

Figure 1.1 Basic Website Payments Standard Page Sequence . . . . . . 15

Figure 1.2 Beginning of Basic Page Sequence on Your Website . . . . . . 16

Figure 1.3 Customer Logs In to or Signs Up for PayPal . . . . . . . . . 17

Figure 1.4 Customer Reviews Payment . . . . . . . . . . . . . . . . . 18

Figure 1.5 Payment Confirmation or “You Made a Payment” Page on PayPal 19

Figure 1.6 Customer Returns to Your Website . . . . . . . . . . . . . 20

Figure 1.7 Account History: Recent Activity . . . . . . . . . . . . . . . 21

Figure 2.1 Account Profile Summary Page . . . . . . . . . . . . . . . 27

Figure 2.2 Uncustomized Payment Page in Standard PayPal Page Style . . 29

Figure 2.3 Complete Custom Page Style . . . . . . . . . . . . . . . . 30

Figure 2.4 Edit Custom Page Style Page . . . . . . . . . . . . . . . . 31

Figure 2.5 Website Payment Preferences on the Profile Summary Page . . 34

Figure 2.6 Page Sequence with PayPal Account Optional . . . . . . . . . 35

Figure 2.7 Momentary “You Made a Payment Page” with Auto Return On . 44

Figure 2.8 Payment Receiving Preferences . . . . . . . . . . . . . . . 47

Figure 2.9 Adding a Credit Card Statement Name . . . . . . . . . . . . 49

Figure 2.10 Prompt for Customer Contact Telephone Number . . . . . . . 50

Figure 2.11 Profile Selling Preferences for Language Encoding . . . . . . 51

Figure 2.12 Language Encoding Settings: Basic Choices . . . . . . . . . 52

Figure 2.13 Website Language Preference . . . . . . . . . . . . . . . . 53

Figure 2.14 More Language Encoding Options . . . . . . . . . . . . . . 54

Figure 2.15 Multi-User Access Link in Account Profile Summary . . . . . . 55

Figure 2.16 Multi-User Access: Adding a User . . . . . . . . . . . . . . 56

Figure 2.17 Accepting or Denying a Cross-Currency Payment . . . . . . . 57

Figure 4.1 PayPal-Hosted Shopping Cart Example: Add to Cart . . . . . 68

Figure 4.2 PayPal-Hosted Shopping Cart Example: Logging In to PayPal during

Checkout 69

Figure 4.3 PayPal-Hosted Shopping Cart Example: Confirmation Page . . 70

Figure 4.4 PayPal-Hosted Shopping Cart Example: Thank You Page After

Payment 71

Figure 4.5 PayPal-Hosted Shopping Cart Example: Email Transaction Receipt .

Figure 4.6 Third-party Shopping Cart Example: Add to Cart . . . . . . . 76

November 2005 9

List of Figures

Figure 4.7 Third-Party Shopping Cart Example: Proceed to Checkout . . . 77

Figure 4.8 Third-Party Shopping Cart Example: Logging In to PayPal during

Figure 4.9 Third-Party Shopping Cart Example: Confirmation Page . . . . 79

Figure 4.10 Shopping Cart Example: Thank You Page After Payment . . . 80

Figure 4.11 Example: Email Transaction Receipt . . . . . . . . . . . . . 80

Figure 4.12 Example: Seller’s Email Receipt . . . . . . . . . . . . . . . 81

Figure 5.1 Upload Public Certificate for EWP . . . . . . . . . . . . . . 87

Figure 5.2 Download PayPal’s Public Certificate for EWP . . . . . . . . . 88

Figure 7.1 How IPN Works: Three General Steps . . . . . . . . . . . . 96

Checkout 78

10 November 2005

List of Examples

Example 2.1 Flat Amount Shipping Calculation . . . . . . . . . . . . . . . . . . . . . 46

Example 2.2 Percentage Shipping Calculation . . . . . . . . . . . . . . . . . . . . . . 46

Example 3.1 HTML for Buy Now Button . . . . . . . . . . . . . . . . . . . . . . . . . 65

Example 4.1 HTML for PayPal-Hosted Shopping Cart “Add to Cart” Button . . . . . . . 75

Example 4.1 HTML for Passing Individual Item Detail to PayPal. . . . . . . . . . . . . 83

Example 4.2 HTML for Aggregate Cart Detail to PayPal . . . . . . . . . . . . . . . . . 84

Example 7.1 HTML for FORM Prepopulation. . . . . . . . . . . . . . . . . . . . . . . 94

Example 7.2 HTML for Overriding PayPal-Stored Address. . . . . . . . . . . . . . . . 95

Website Payments Standard Checkout Integration Guide November 2005 11

List of Examples

12 November 2005 Website Payments Standard Checkout Integration Guide

Preface

This Document

This document, the PayPal Website Payments Standard Checkout Integration Guide, is a complete revision of the version issued in September 2005.

Intended Audience

This document is for merchants whose websites obtain payments using PayPal features.

Notational Conventions

This document uses typefaces to identify the characteristics of text. These typefaces and the characteristics they imply are described below:

Typeface How Used

serif italics A document title.

A term being discussed or defined. For example: A file is a readable or writable stream of characters.

Boolean values (not keywords). For example: The function returns true if it encounters an error.

monospaced Pathnames or file names that appear in body text frames.

Code-related names that appear in body text frames. Such names are used for functions, callbacks, arguments, data structures, and fields.

For example: AbstractResponseType is the SOAP response type definition on which all PayPal API response methods are based.

Components of internet protocol requests and responses, such as HTTPS and FORM variables.

For example: The PayPal system uses a method=POST request to return IPN status variables related to subscriptions, such as txn_type.

Serif bold User interface names such as window names or menu selections.

For example: On the Profile page, click Email to confirm your email address.

San-serif oblique

Placeholders used in the context of a format or programming standard or formal descriptions of PayPal system syntax. Placeholders indicate values or names that the reader should provide.

Example: For example, amount is the variable for a single-item shopping cart, but

amount_

is the item amount for the third item in a multiple-item shopping cart.

X is the name of the variable for a multi-item shopping cart. amount_3

Website Payments Standard Checkout Integration Guide November 2005 13

Preface

To convey additional information, this document may also apply color and underlining to words or phrases that use the typefaces described above. Such use is described below:

Text attribute How Used

xxxxxx

Documentation Problems

Hypertext link to a page in the current document or to another document in the set.

Hypertext link to a URL or that initiates a web action, such as sending mail.

If you discover any errors in or have any problems with this documentation, please mail us by following the instructions below. Describe the error or problem in as much detail as possible and give us the document title, the date of the document (located at the foot of every page), and the page number or page range.

To contact Customer Service about documentation problems:

1. Go to

https://www.paypal.com/.

2. Click Help in the upper left corner of the page.

3. Click Contact Us in the lower left corner of the page.

4. In the Help by Email section, click Contact PayPal Customer Service.

5. Complete the form.

To contact Developer Technical Support about documentation problems:

1. Go to

https://developer.paypal.com/.

2. Log in to your account by entering your email address and password in the Member Log In box.

3. Click Help Center at the bottom of the box on the right side of the page.

4. Click Email PayPal Technical Support.

5. Complete the form.

14 November 2005 Website Payments Standard Checkout Integration Guide

How Website Payments Standard Works

The PayPal Website Payments Standard Checkout Integration Guide describes how you use Website Payments Standard. Website Payments Standard consists of HTML FORMs on your website that direct your customer’s web browser to the PayPal website at

http://www.paypal.com in order to pay you and then return the customer to your website.

Figure 1.1, “Basic Website Payments Standard Page Sequence,” shows the basic sequence of

web browser pages when a customer pays you with PayPal Website Payments Standard.

FIGURE 1.1 Basic Website Payments Standard Page Sequence

All features of Website Payments Standard are variations on this basic page sequence. You use HTML FORM variables and the settings in your PayPal account Profile to affect the behavior of the basic sequence.

Website Payments Standard Checkout Integration Guide November 2005 15

How Website Payments Standard Works

Example of the Basic Page Sequence

Here’s an example of the basic page sequence of Website Payments Standard. Like all examples of pages in this guide, this example is based on the PayPal sample integration, which demonstrates how PayPal has been integrated with the fictitious online store called “DesignerFotos.”

BEGIN. The customer chooses to pay with PayPal on your website.

FIGURE 1.2 Beginning of Basic Page Sequence on Your Website

This example illustrates PayPal Buy Now, which is discussed in Chapter 3, “Single-Item

Payment: Buy Now and Donations.”

16 November 2005 Website Payments Standard Checkout Integration Guide

How Website Payments Standard Works

Example of the Basic Page Sequence

The customer logs in to PayPal.

FIGURE 1.3 Customer Logs In to or Signs Up for PayPal

If the customer were new to PayPal, the customer could choose to sign up for a PayPal account.

Website Payments Standard Checkout Integration Guide November 2005 17

How Website Payments Standard Works

Example of the Basic Page Sequence

On PayPal, the customer reviews the details of the payment and makes the payment.

FIGURE 1.4 Customer Reviews Payment

At this point, the customer can choose among funding sources (credit cards, debit cards, or bank accounts recorded in the PayPal accounts) with which to pay you and can also choose among shipping addresses stored on PayPal. This example does not show the pages containing these options.

18 November 2005 Website Payments Standard Checkout Integration Guide

How Website Payments Standard Works

Example of the Basic Page Sequence

The customer sees a payment confirmation page on PayPal and clicks Return to

Merchant.

FIGURE 1.5 Payment Confirmation or “You Made a Payment” Page on PayPal

Website Payments Standard Checkout Integration Guide November 2005 19

How Website Payments Standard Works

Example of the Basic Page Sequence

END. The customer is returned to your website.

FIGURE 1.6 Customer Returns to Your Website

20 November 2005 Website Payments Standard Checkout Integration Guide

How You Get Your Money

After a customer makes a payment, your PayPal account lists the payment in your Account History, as shown below.

FIGURE 1.7 Account History: Recent Activity

How Website Payments Standard Works

How You Get Your Money

Notifications You Receive

You can be notified of payments in four ways: email, History Log, Downloadable History Log, and Instant Payment Notification (IPN).

Email

You receive email notification in the following cases:

z Successful payment

z Pending payment

z Canceled payment

If you do not want to receive email notification:

1. Click the Profile subtab of the My Account tab.

2. Click the Notifications link in the Account Information column.

Website Payments Standard Checkout Integration Guide November 2005 21

How Website Payments Standard Works

Notifications You Receive

3. Under the Payment Notifications heading, clear the I receive PayPal Website Payments and Instant Purchase checkbox.

4. Click Save.

Transaction History

Your transaction history (also called your “History) displays information about your payments. The status of each payment is one of the following statuses:

z Completed: The transaction was successful and the money was credited to your account

z Cleared: The payment cleared the sender’s account and was credited to your account

z Uncleared: The payment has not cleared the sender’s account yet

Downloadable History Log

You can download copies of your transaction history to your computer. You can specify a date range for the transactions and the format of the downloadable file. The file contains a record of your transactions.

To learn more about Downloadable History Logs, see the Order Management Integration Guide.

Instant Payment Notification (IPN)

Instant Payment Notification is a mechanism by which you to receive transaction data. IPN posts individual transaction information to a URL on your website that you have programmed to process this incoming data. To use IPN, you must activate it, because it is disabled by default.

If IPN is activated, you receive a notification in the following cases:

z When a payment is first sent, indicating that the status of the payment is Completed or

Pending

z When a payment clears, fails, or is denied, if the status was pending

To learn more about IPN, see “Instant Payment Notification: notify_url” on page 96 and the Order Management Integration Guide.

22 November 2005 Website Payments Standard Checkout Integration Guide

How Website Payments Standard Works

How To Use This Guide

Website Payments Standard has two primary components: Buy Now or Donations buttons and Shopping Cart. Both are constructed with the same basic set of HTML FORM variables. You can affect their behavior and appearance with settings in your account Profile and with additional FORM variables.

The following table summarizes the contents of this guide.

TABLE 1.1 How To Use This Guide

Feature Description See Also...

Buy Now or

Paying for single items from your website.

Donations

Shopping Cart Paying for multiple items from your website. It

comes in two forms: a shopping cart hosted on PayPal’s website and as HTML FORM variables for use in third-party shopping carts.

Custom Payment Pages Account Profile settings that brand PayPal’s pages

with your own colors and images.

“Account Optional” or Website Payments Express

Auto Return Account Profile settings that eliminate PayPal’s

Automatic Calculation of Shipping, Handling, and Tax

Customer Contact Telephone

Account Profile setting that allows a customer to pay you with credit or debit cards without having a PayPal account.

payment receipt page (step 4 in

Website Payments Standard Page Sequence

Account Profile settings that calculate shipping and handling costs and sales tax for you.

Account Profile setting that sends you the customer’s contact telephone number.

Figure 1.1, “Basic

Chapter 3, “Single-Item Payment: Buy Now and Donations

”

Chapter 4, “Multiple-Item Payment: Shopping Cart

”

“Branding PayPal’s Payment Pages” on page 29

“Account Optional or Website Payments Express” on page 35

“Auto Return” on page 43

“Automatic Calculation of Shipping and Handling Cost and Tax” on page 45

“Getting Customer Contact Telephone Numbers” on page 49

Multi-User Access Account Profile setting that allows up to seven

email addresses to share your Business account.

Encrypted Website Payments

Encrypt payment information before it is sent to PayPal to protect customer data.

“Multi-User Access to Your PayPal Account” on page 55

Chapter 5, “Encrypted Website Payments

”

Other Standard Products and Features

Website Payments Standard also includes other products and features not detailed in this guide:

Website Payments Standard Checkout Integration Guide November 2005 23

How Website Payments Standard Works

Related Online Information

z Instant Payment Notification (IPN) and Payment Data Transfer (PDT) are HTML FORM-

based mechanisms to send information about payments to programs on your website. IPN and PDT are described in the

z Subscriptions and Recurring Payments, which are described in the Subscriptions and

Recurring Payments Guide

Website Payments Pro

Website Payments Pro consists of PayPal Express Checkout and the Direct Payment Application Programming Interfaces (APIs). Rather than being based solely on HTML FORM variables (as is Website Payments Standard), these products rely on the PayPal Web Services API. For more information, see the

Authorization & Capture

Authorization & Capture supplements both Website Payments Standard and Website Payments Pro with PayPal’s enhancements to conventional credit card authorization and payment capture. It has both PayPal website tools and a Web Services Application Programming Interface (API). For more information, see the

Integration Guide.

Order Management Integration Guide.

Website Payments Pro Integration Guide.

Authorization & Capture

Related Online Information

Consult the following URLs for information about PayPal’s fees, online security, user agreement and related policies, online help, and customer service.

TABLE 1.2 Hyperlinks for Fees, Security, User Agreement, Policies, Online Help, and Customer

Service

Information URL

Fees https://www.paypal.com/fees

Online Security https://www.paypal.com/security

User Agreement and Policies

Online Help https://www.paypal.com/help

Customer Service https://www.paypal.com/wf

https://www.paypal.com/cgi-bin/webscr?cmd=p/gen/ua/ua-outside

24 November 2005 Website Payments Standard Checkout Integration Guide

How Website Payments Standard Works

Complementary Documentation

All PayPal technical documentation is listed here. The description of each guide indicates its subject matter and documentation necessary for effective use of the guide.

TABLE 1.3 PayPal Technical Documentation

Guide Title Description Prerequisites

Website Payments Standard Integration Guide

Express Checkout Integration Guide

Website Payments Pro Integration Guide

Authorization & Capture Integration Guide

Details basic PayPal payment process for shopping cart and single-item purchase. Account Profile settings for variations on basic payment process. Customization of PayPal's payment pages. HTML

FORM variables for control of payment process.

https://www.paypal.com/en_US/pdf/PP_WebsitePaymentsStandard_Integrati onGuide.pdf

Details use of Express Checkout API. PayPal placement on merchants' websites and related business rules.

https://www.paypal.com/en_US/pdf/PP_ExpressCheckout_IntegrationGuide.p df

Details use of Express Checkout and Direct Payment APIs. PayPal placement on merchants' websites and related business logic.

https://www.paypal.com/en_US/pdf/PP_WebsitePaymentsPro_IntegrationGui de.pdf

Details use of PayPal website and API for authorization and capture; relates Authorization & Capture to Express Checkout and Direct Payment.

https://www.paypal.com/en_US/pdf/PP_AuthCapture_IntegrationGuide.pdf

None

Website Payments Standard Integration Guide

z Website

Payments Standard Integration Guide

z Website

Payments Pro Integration Guide

z API Reference

Order Management Integration Guide

Details Instant Payment Notification (IPN) and Payment Data Transfer (PDT) for automated receipt of payment information after payment completion. Details IPN

FORM variables and their meanings. Also includes information about

HTML Downloadable History Logs.

Website Payments Standard Integration Guide

https://www.paypal.com/en_US/pdf/PP_OrderManagement_IntegrationGuide .pdf

Website Payments Standard Checkout Integration Guide November 2005 25

How Website Payments Standard Works

Complementary Documentation

TABLE 1.3 PayPal Technical Documentation

Guide Title Description Prerequisites

Java SDK Guide .NET SDK Guide Classic ASP Guide PHP SDK Guide

Details the use of the PayPal Software Development Kits for Java, Microsoft .NET, Microsoft Classic ASP, and PHP to simplify use of the PayPal Web Services API.

https://www.paypal.com/en_US/pdf/PP_SDK_Java_Guide.pdf https://www.paypal.com/en_US/pdf/PP_SDK_NET_Guide.pdf https://www.paypal.com/en_US/pdf/PP_SDK_ClassicASP_Guide.pdf https://www.paypal.com/en_US/pdf/PP_SDK_PHP_Guide.pdf

Sandbox User Guide Describes the PayPal Sandbox testing environment for testing website payments and

Web Services APIs. Details how to get PayPal API digital certificates.

https://www.paypal.com/en_US/pdf/PP_Sandbox_UserGuide.pdf

Web Services API Reference

Field-by-field description of all PayPal Web Services APIs, their SOAP structures, and error messages. Location of PayPal WSDL and XSD files.

https://www.paypal.com/en_US/pdf/PP_APIReference.pdf

z Website

Payments Standard Integration Guide

z Website

Payments Pro Integration Guide

z Authorization &

Capture Integration Guide

z Sandbox User

Guide

z API Reference

All other PayPal guides for an understanding of how products work

None

Subscriptions and Recurring Payments Guide

Virtual Terminal User Guide

Describes HTML services.

FORM variables for using PayPal for subscriptions to goods and

https://www.paypal.com/en_US/pdf/subscriptions.pdf

Details how to use the virtual terminal to accept credit card payments.

https://www.paypal.com/en_US/pdf/VT_user_guide.pdf

Website Payments Standard Integration Guide

None

26 November 2005 Website Payments Standard Checkout Integration Guide

Using Your Merchant Account

Profile and Tools

This chapter details how you can use your account Profile settings and other tools on the PayPal website to affect how payments are processed.

The Account Profile Summary

Use your PayPal account Profile to manage information about your PayPal account. To see your Profile, log in to your PayPal account, and click the Profile subtab of the My Account tab. The Profile has three sections: Account Information, Financial Information, and Selling Preferences.

FIGURE 2.1 Account Profile Summary Page

Website Payments Standard Checkout Integration Guide November 2005 27

Using Your Merchant Account Profile and Tools

The Account Profile Summary

Account Information

Use the Account Information column for basic account maintenance, including updating your password, adding and confirming email addresses, managing your business information, and (for Premier accounts) configuring multi-user access to your PayPal account.

Financial Information

Use the Financial Information column to organize and maintain the financial instruments associated with your PayPal account: manage your credit cards and bank accounts, activate and manage your PayPal Debit Card, maintain multiple currency balances, and view your monthly account statements.

Selling Preferences

Use the Selling Preferences column to organize the way you sell with your PayPal account, including:

z Branding PayPal’s payment pages

z Streamlining purchases with Website Payment Preferences:

– Account Optional –Auto Return – Automatic calculation of shipping, handling, and sales tax

z Payment receiving preferences for blocking certain kinds of payments

z Getting customers’ contact telephone numbers

z Language encoding your data

The majority of this chapter focuses on using Selling Preferences.

Correspondence Between Profile Settings and HTML Variables

Many Profile settings have equivalent HTML FORM variables that can control the behavior of individual transactions. After you enable a setting in your Profile, you can include FORM variables with a transaction to take advantage of that Profile setting. See the following sections for more information:

z “Overriding Page Style Settings On Individual Transactions” on page 33

z “Overriding Tax Setting on Individual Transactions” on page 46

z “Overriding Shipping Calculation on Individual Transactions” on page 46

z “Setting the Character Set: charset” on page 93

z “Setting Return URL on Individual Transactions” on page 93

z “Desired Currency on Individual Transactions” on page 93

28 November 2005 Website Payments Standard Checkout Integration Guide

Using Your Merchant Account Profile and Tools

Branding PayPal’s Payment Pages

With our Custom Payment Pages feature, you can tailor PayPal’s payment pages to the style of your website. Custom Payment Pages work with all PayPal Website Payment buttons and with the PayPal Account Optional feature.

You can add up to three custom page styles.

The pictures in this section demonstrate the types of customization you can add to your PayPal Website Payment buttons. Figure 2.2, “Uncustomized Payment Page in Standard PayPal Page

Style,” shows a payment page with no customization.

FIGURE 2.2 Uncustomized Payment Page in Standard PayPal Page Style

Branding PayPal’s Payment Pages

Website Payments Standard Checkout Integration Guide November 2005 29

Using Your Merchant Account Profile and Tools

Branding PayPal’s Payment Pages

Figure 2.3, “Complete Custom Page Style,” shows all the customization you can make.

FIGURE 2.3 Complete Custom Page Style

Page header image Page header border color Page header background color

Page background color

30 November 2005 Website Payments Standard Checkout Integration Guide

+ 86 hidden pages