PayPal Merchant - 2005 User Manual

Last Updated: May, 2005Merchant User Manual and Integration Guide

Contents10 May, 2005 Merchant User Manual and Integration GuideDispute Notification Variables . . . . . . . . . . . . . . . . . .

Backend Integration - Payment NotificationsPayment Data Transfer12100 May, 2005 Merchant User Manual and Integration Guide3. Click the Website Paymen

Merchant User Manual and Integration Guide May, 2005 101Backend Integration - Payment NotificationsPayment Data Transfer12PDT and PayPal Account Opti

Backend Integration - Payment NotificationsPayment Data Transfer12102 May, 2005 Merchant User Manual and Integration Guidecustom=For+the+purchase+of+

Merchant User Manual and Integration Guide May, 2005 103Backend Integration - Payment NotificationsInstant Payment Notification (IPN) 12Instant Payme

Backend Integration - Payment NotificationsInstant Payment Notification (IPN) 12104 May, 2005 Merchant User Manual and Integration GuideHow IPNs Are

Merchant User Manual and Integration Guide May, 2005 105Backend Integration - Payment NotificationsInstant Payment Notification (IPN) 12so you can be

Backend Integration - Payment NotificationsInstant Payment Notification (IPN) 12106 May, 2005 Merchant User Manual and Integration GuideSetting Up IP

Merchant User Manual and Integration Guide May, 2005 107Backend Integration - Payment NotificationsInstant Payment Notification (IPN) 121. Check that

Backend Integration - Payment NotificationsProcessing Refunds12108 May, 2005 Merchant User Manual and Integration GuideThese values are absent for no

Merchant User Manual and Integration Guide May, 2005 109Backend Integration - Payment NotificationsProcessing Refunds121. Log in to your PayPal accou

Merchant User Manual and Integration Guide May, 2005 11List of TablesTable 1.1 PayPal-Supported Currencies, Currency Codes, and Maximum Transation Am

Backend Integration - Payment NotificationsProcessing Refunds12110 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 11113Using Multiple CurrenciesPayPal’s Multiple Currencies feature gives you the ability to buy

Using Multiple CurrenciesReceiving Money13112 May, 2005 Merchant User Manual and Integration Guidecurrency you do not hold, you will be asked to Acce

Merchant User Manual and Integration Guide May, 2005 113Using Multiple CurrenciesReceiving Money13Managing Currency Balances To manage your currency

Using Multiple CurrenciesReceiving Money13114 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 11514Language Encoding for Your DataThis chapter tells you how you can set your Profile preferen

Language Encoding for Your DataChanging Your Language Encoding14116 May, 2005 Merchant User Manual and Integration GuideNavigating Your Profile: Lang

Merchant User Manual and Integration Guide May, 2005 117Language Encoding for Your DataChanging Your Language Encoding14Changing Your Website Languag

Language Encoding for Your DataChanging Your Language Encoding14118 May, 2005 Merchant User Manual and Integration GuideTo change the language of dat

Merchant User Manual and Integration Guide May, 2005 119Language Encoding for Your DataChanging Your Language Encoding14More Encoding OptionsIf you k

List of Tables12 May, 2005 Merchant User Manual and Integration Guide

Language Encoding for Your DataSetting Language in Website Payments: charset14120 May, 2005 Merchant User Manual and Integration Guidedifferent encod

Merchant User Manual and Integration Guide May, 2005 12115TestingWebsite Payments, PDT, and IPNThe PayPal Sandbox can be used to test the following f

TestingYour PayPal Button15122 May, 2005 Merchant User Manual and Integration GuideYour PayPal ButtonNow that you have the HTML code in your website

Merchant User Manual and Integration Guide May, 2005 123TestingYour PayPal Button15Testing TipsYou might find the following testing tips useful when

TestingYour PayPal Button15124 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 12516Processing eChecksAn eCheck is an electronic funds transfer that withdraws money directly f

Processing eChecksRefunding eChecks16126 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 12717SecurityNotification Validation Notification validation is the process you use to validate

SecurityMulti-User Access17128 May, 2005 Merchant User Manual and Integration GuideMulti-User AccessPayPal’s Multi-User Access feature allows you to

Merchant User Manual and Integration Guide May, 2005 129SecurityMulti-User Access17Getting StartedTo use Multi-User Access:1. Log in to your PayPal B

Merchant User Manual and Integration Guide May, 2005 13List of FiguresFigure 2.1 PayPal Payment Flows . . . . . . . . . . . . . . .

SecurityUsing Secure Socket Layer (SSL)17130 May, 2005 Merchant User Manual and Integration GuideUsing Secure Socket Layer (SSL)If you have contracte

Merchant User Manual and Integration Guide May, 2005 131AHTML SamplesPayPal Buy Now and Donation Buttons HTML and VariablesBy understanding how your

HTML SamplesPayPal Buy Now and Donation Buttons HTML and VariablesA132 May, 2005 Merchant User Manual and Integration Guide<input type=”hidden” na

Merchant User Manual and Integration Guide May, 2005 133HTML SamplesPayPal Buy Now and Donation Buttons HTML and VariablesATABLE A.1 HTML and Hyperli

HTML SamplesPayPal Buy Now and Donation Buttons HTML and VariablesA134 May, 2005 Merchant User Manual and Integration Guideno_note Including a note w

Merchant User Manual and Integration Guide May, 2005 135HTML SamplesPayPal Buy Now and Donation Buttons HTML and VariablesAcpp_headerborder_colorSets

HTML SamplesPayPal Buy Now and Donation Buttons HTML and VariablesA136 May, 2005 Merchant User Manual and Integration Guidetax Transaction-based tax

Merchant User Manual and Integration Guide May, 2005 137HTML SamplesPayPal Shopping Cart HTML and VariablesAPayPal Shopping Cart HTML and VariablesPa

HTML SamplesPayPal Shopping Cart HTML and VariablesA138 May, 2005 Merchant User Manual and Integration GuideShopping Cart VariablesThe Shopping Cart

Merchant User Manual and Integration Guide May, 2005 139HTML SamplesPayPal Shopping Cart HTML and VariablesAFor more information on the additional va

List of Figures14 May, 2005 Merchant User Manual and Integration Guide

HTML SamplesPayPal Shopping Cart HTML and VariablesA140 May, 2005 Merchant User Manual and Integration Guide5. Repeat for each item included in cart.

Merchant User Manual and Integration Guide May, 2005 141HTML SamplesPrepopulating Your Customer’s PayPal Sign-Up APrepopulating Your Customer’s PayPa

HTML SamplesPrepopulating Your Customer’s PayPal Sign-Up A142 May, 2005 Merchant User Manual and Integration GuidePrepopulation for Account Signupnig

Merchant User Manual and Integration Guide May, 2005 143HTML SamplesPrepopulating Your Customer’s PayPal Sign-Up ASample HTMLThe following sample HTM

HTML SamplesPrepopulating Your Customer’s PayPal Sign-Up A144 May, 2005 Merchant User Manual and Integration Guide<input type=”hidden” name=”item_

Merchant User Manual and Integration Guide May, 2005 145BIPN and PDT VariablesIPN and PDT variables are case-sensitive. All values are lowercase, exc

IPN and PDT VariablesIPN Variables in All PostsB146 May, 2005 Merchant User Manual and Integration GuideIPN Variables in All PostsIPN Version: notify

Merchant User Manual and Integration Guide May, 2005 147IPN and PDT VariablesBasic InformationBBasic Informationpayer_statusverifiedunverifiedCustome

IPN and PDT VariablesAdvanced and Custom InformationB148 May, 2005 Merchant User Manual and Integration GuideAdvanced and Custom InformationShopping

Merchant User Manual and Integration Guide May, 2005 149IPN and PDT VariablesShopping Cart InformationBtax PayPal appends the number of the item (e.g

Merchant User Manual and Integration Guide May, 2005 15PrefaceThis DocumentThis document, the Merchant User Manual and Integration Guide, which descr

IPN and PDT VariablesShopping Cart InformationB150 May, 2005 Merchant User Manual and Integration Guidepayment_statusCanceled-ReversalCompletedDenied

Merchant User Manual and Integration Guide May, 2005 151IPN and PDT VariablesShopping Cart InformationBpending_reasonaddressauthorizationecheckintlmu

IPN and PDT VariablesCurrency and Currency ExchangeB152 May, 2005 Merchant User Manual and Integration GuideCurrency and Currency Exchangeparent_txn_

Merchant User Manual and Integration Guide May, 2005 153IPN and PDT VariablesAuctionsBAuctionssettle_amountAmount that is deposited into the account’

IPN and PDT VariablesMass PaymentB154 May, 2005 Merchant User Manual and Integration GuideMass Paymentauction_multi_itemThis is a counter used for mu

Merchant User Manual and Integration Guide May, 2005 155IPN and PDT VariablesMass PaymentBmc_currency_xTransaction-specific for Multiple CurrenciesFo

IPN and PDT VariablesSubscriptions VariablesB156 May, 2005 Merchant User Manual and Integration GuideSubscriptions VariablesAlong with other IPN vari

Merchant User Manual and Integration Guide May, 2005 157IPN and PDT VariablesSubscriptions VariablesBmc_amount2 Amount of payment for trial period 2,

IPN and PDT VariablesSubscriptions VariablesB158 May, 2005 Merchant User Manual and Integration GuideVariables for Each Subscription EventThe followi

Merchant User Manual and Integration Guide May, 2005 159IPN and PDT VariablesSubscriptions VariablesBCurrency and Exchange informationmc_grossXXmc_fe

Preface16 May, 2005 Merchant User Manual and Integration GuideTo convey additional information, this document may also apply color and underlining to

IPN and PDT VariablesDispute Notification VariablesB160 May, 2005 Merchant User Manual and Integration GuideDispute Notification VariablesVariables r

Merchant User Manual and Integration Guide May, 2005 161IPN and PDT VariablesDispute Notification VariablesBcase_idCase identification number.Format:

IPN and PDT VariablesPDT-Specific VariablesB162 May, 2005 Merchant User Manual and Integration GuidePDT-Specific VariablesThe following variables app

May, 2005 163CCountry CodesISO 3166 Standard Country CodesPayPal relies on two-character country codes defined by International Standards Organizatio

Country CodesISO 3166 Standard Country CodesC164 May, 2005Israel ILItaly ITJamaica JMJapan JPLuxembourg LUMalaysia MYMexico MXMonaco MCNetherlands NL

Merchant User Manual and Integration Guide May, 2005 17Preface

Preface18 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 191IntroductionThe Merchant User Manual and Integration Guide provides information about the maj

© 2005 PayPal Inc. All rights reserved. PayPal and the PayPal logo are registered trademarks of PayPal, Inc. Designated trademarks and brands are the

IntroductionPayPal-Supported Currencies120 May, 2005 Merchant User Manual and Integration GuidePayPal-Supported CurrenciesThe following currencies ar

Merchant User Manual and Integration Guide May, 2005 212PayPal Payments OverviewThis section provides a brief overview of each of the products descri

PayPal Payments OverviewShopping Cart222 May, 2005 Merchant User Manual and Integration GuideBenefits of Buy Now and Donations Buttons include:z Easy

Merchant User Manual and Integration Guide May, 2005 23PayPal Payments OverviewContact Telephone Number2For more information about shipping and tax,

PayPal Payments OverviewPayment Receiving Preferences224 May, 2005 Merchant User Manual and Integration GuideFor more information about IPN, “Instant

Merchant User Manual and Integration Guide May, 2005 25PayPal Payments OverviewSubscriptions2For more information about PayPal's Reporting Tools

PayPal Payments OverviewPayment Flow Overview226 May, 2005 Merchant User Manual and Integration GuidePayment Flow OverviewThe following diagram repre

Merchant User Manual and Integration Guide May, 2005 273Getting StartedYou can start accepting payments with PayPal in 5 easy steps:Step 1 - Sign Up:

Getting Started328 May, 2005 Merchant User Manual and Integration GuideFIGURE 3.2 Confirming Your Email AddressStep 3 - Add Bank Account: In order fo

Merchant User Manual and Integration Guide May, 2005 29Getting StartedManaging Your PayPal Merchant Account3credit card used on your PayPal account.

© 2005 PayPal Inc. All rights reserved. PayPal and the PayPal logo are registered trademarks of PayPal, Inc. Designated trademarks and brands are the

Getting StartedManaging Your PayPal Merchant Account330 May, 2005 Merchant User Manual and Integration GuideFIGURE 3.4 Merchant Profile PageAccount I

Merchant User Manual and Integration Guide May, 2005 31Getting StartedManaging Your PayPal Merchant Account3Payment Receiving PreferencesOnce you hav

Getting StartedManaging Your PayPal Merchant Account332 May, 2005 Merchant User Manual and Integration GuideAddresses to help you make informed decis

Merchant User Manual and Integration Guide May, 2005 33Getting StartedManaging Your PayPal Merchant Account3Smart Logos, or eBay Checkout Payments. S

Getting StartedManaging Your PayPal Merchant Account334 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 354PayPal Account OptionalWith PayPal Account Optional turned on, your customers who are new to

PayPal Account OptionalYour Customer’s Experience436 May, 2005 Merchant User Manual and Integration GuideYour Customer’s ExperienceIf you have turned

Merchant User Manual and Integration Guide May, 2005 37PayPal Account OptionalYour Customer’s Experience4Step 3: Bob is prompted to enter the shippin

PayPal Account OptionalYour Customer’s Experience438 May, 2005 Merchant User Manual and Integration GuideStep 4: Bob is then prompted to fill in his

Merchant User Manual and Integration Guide May, 2005 39PayPal Account OptionalYour Customer’s Experience4Step 5: Bob is taken to a Review page contai

4 May, 2005 Merchant User Manual and Integration Guide

PayPal Account OptionalYour Customer’s Experience440 May, 2005 Merchant User Manual and Integration GuideStep 6: Bob is taken to a payment completion

Merchant User Manual and Integration Guide May, 2005 41PayPal Account OptionalYour Customer’s Experience4Step 7: If Bob clicked Save My Info, he is t

PayPal Account OptionalYour Customer’s Experience442 May, 2005 Merchant User Manual and Integration GuideStep 9: Bob receives an email receipt for th

Merchant User Manual and Integration Guide May, 2005 435Creating Buy Now and Donation ButtonsPayPal makes it easy to accept payments for single items

Creating Buy Now and Donation ButtonsHow Buy Now and Donations Work544 May, 2005 Merchant User Manual and Integration GuideWhat Your Customer SeesSte

Merchant User Manual and Integration Guide May, 2005 45Creating Buy Now and Donation ButtonsHow Buy Now and Donations Work5Step 4: To pay for his pur

Creating Buy Now and Donation ButtonsHow Buy Now and Donations Work546 May, 2005 Merchant User Manual and Integration GuideStep 5: Bob is taken to a

Merchant User Manual and Integration Guide May, 2005 47Creating Buy Now and Donation ButtonsHow Buy Now and Donations Work5Step 6: Bob is taken to a

Creating Buy Now and Donation ButtonsHow Buy Now and Donations Work548 May, 2005 Merchant User Manual and Integration GuideStep 7: Bob receives an em

Merchant User Manual and Integration Guide May, 2005 49Creating Buy Now and Donation ButtonsBuy Now and Donations Button Factory5Step 9: Alice logs i

Merchant User Manual and Integration Guide May, 2005 5ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . .

Creating Buy Now and Donation ButtonsBuy Now and Donations Button Factory550 May, 2005 Merchant User Manual and Integration GuideCreating a Buy Now B

Merchant User Manual and Integration Guide May, 2005 51Creating Buy Now and Donation ButtonsBuy Now and Donations Button Factory5Step 4: Shipping and

Creating Buy Now and Donation ButtonsBuy Now and Donations Button Factory552 May, 2005 Merchant User Manual and Integration GuideStep 8: Miscellaneou

Merchant User Manual and Integration Guide May, 2005 53Creating Buy Now and Donation ButtonsBuy Now and Donations Button Factory5If you will be sendi

Creating Buy Now and Donation ButtonsBuy Now and Donations Button Factory554 May, 2005 Merchant User Manual and Integration GuideStep 4: Customize Yo

Merchant User Manual and Integration Guide May, 2005 55Creating Buy Now and Donation ButtonsBuy Now and Donations Button Factory51. Copy the code fro

Creating Buy Now and Donation ButtonsNotifications You Receive556 May, 2005 Merchant User Manual and Integration GuideNotifications You ReceiveYou ca

Merchant User Manual and Integration Guide May, 2005 57Creating Buy Now and Donation ButtonsNotifications You Receive5Instant Payment Notification (I

Creating Buy Now and Donation ButtonsNotifications You Receive558 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 596Creating Shopping Cart ButtonsWhen you use PayPal’s free Shopping Cart, your customers can pu

Contents6 May, 2005 Merchant User Manual and Integration GuideYour Customer’s Experience. . . . . . . . . . . . . . . . . . . . .

Creating Shopping Cart ButtonsHow It Works660 May, 2005 Merchant User Manual and Integration GuideStep 2: Bob looks at the contents of his cart and c

Merchant User Manual and Integration Guide May, 2005 61Creating Shopping Cart ButtonsHow It Works6Step 5: Bob is then prompted to enter his credit ca

Creating Shopping Cart ButtonsHow It Works662 May, 2005 Merchant User Manual and Integration GuideStep 6: Bob is taken to a Confirmation page contain

Merchant User Manual and Integration Guide May, 2005 63Creating Shopping Cart ButtonsHow It Works6Step 7: Bob is taken to a Confirmation page where h

Creating Shopping Cart ButtonsPayPal Shopping Cart Button Factory664 May, 2005 Merchant User Manual and Integration GuideWhat You SeeStep 9: Alice re

Merchant User Manual and Integration Guide May, 2005 65Creating Shopping Cart ButtonsPayPal Shopping Cart Button Factory6NOTE: You also have the opti

Creating Shopping Cart ButtonsPayPal Shopping Cart Button Factory666 May, 2005 Merchant User Manual and Integration GuideIf you have already specifie

Merchant User Manual and Integration Guide May, 2005 67Creating Shopping Cart ButtonsPayPal Shopping Cart Button Factory6Step 9: Collect additional i

Creating Shopping Cart ButtonsHow You Get Your Money668 May, 2005 Merchant User Manual and Integration Guide1. Copy the code from the Copy ‘View Cart

Merchant User Manual and Integration Guide May, 2005 69Creating Shopping Cart ButtonsNotifications You Receive62. Click the Notifications link from t

Merchant User Manual and Integration Guide May, 2005 7ContentsExamples of Custom Payment Pages . . . . . . . . . . . . . . . . . .

Creating Shopping Cart ButtonsNotifications You Receive670 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 717Adding PayPal to Your Third-party Shopping Cart Some Web developers may wish to integrate Pay

Adding PayPal to Your Third-party Shopping CartPassing the Aggregate Shopping Cart Amount to PayPal772 May, 2005 Merchant User Manual and Integration

Merchant User Manual and Integration Guide May, 2005 738Custom Payment PagesWith our Custom Payment Pages feature, you can tailor PayPal's payme

Custom Payment PagesExamples of Custom Payment Pages874 May, 2005 Merchant User Manual and Integration GuideFigure 8.2, “Payment Page with Custom Sty

Merchant User Manual and Integration Guide May, 2005 75Custom Payment PagesGetting Started8Figure 8.3, “Payment Page with Custom Style: Header Image,

Custom Payment PagesAdding a Page Style876 May, 2005 Merchant User Manual and Integration GuideAdding a Page StyleYou can add up to three page styles

Merchant User Manual and Integration Guide May, 2005 77Custom Payment PagesEditing a Page Style8Editing a Page StyleTo edit a page style:FIGURE 8.4 E

Custom Payment PagesPreviewing a Page Style878 May, 2005 Merchant User Manual and Integration Guide4. Keep or modify your page style preferences:– Pa

Merchant User Manual and Integration Guide May, 2005 79Custom Payment PagesMaking a Page Style Primary8Making a Page Style PrimaryWhen you make a pag

Contents8 May, 2005 Merchant User Manual and Integration GuideHow It Works. . . . . . . . . . . . . . . . . . . . . . . . .

Custom Payment PagesOverriding Page Style Settings880 May, 2005 Merchant User Manual and Integration GuideTo change the page style for a button you h

Merchant User Manual and Integration Guide May, 2005 81Custom Payment PagesBackground Colors and Error Messages8Background Colors and Error MessagesP

Custom Payment PagesBackground Colors and Error Messages882 May, 2005 Merchant User Manual and Integration GuideThe background color of the following

Merchant User Manual and Integration Guide May, 2005 839Calculating Shipping, Handling, and TaxYou can set up your PayPal account to automatically ca

Calculating Shipping, Handling, and TaxShipping Calculation984 May, 2005 Merchant User Manual and Integration GuideShipping CalculationDetermine whet

Merchant User Manual and Integration Guide May, 2005 85Calculating Shipping, Handling, and TaxShipping Calculation9handling_cart variables. For more

Calculating Shipping, Handling, and TaxShipping Calculation986 May, 2005 Merchant User Manual and Integration Guide

Merchant User Manual and Integration Guide May, 2005 8710Creating Customer Contact TelephoneThe Customer Contact Information Telephone is an option t

Creating Customer Contact TelephoneGetting Started1088 May, 2005 Merchant User Manual and Integration GuideWhat Your Customer SeesStep 3: When you re

Merchant User Manual and Integration Guide May, 2005 8911Auto ReturnWith Auto Return for Website Payments, merchants can eliminate the “Done” page in

Merchant User Manual and Integration Guide May, 2005 9ContentsNotification Validation . . . . . . . . . . . . . . . . . . . . .

Auto ReturnHow Auto Return Works1190 May, 2005 Merchant User Manual and Integration GuideStep 2: Bob is taken to a PayPal Payment Details page which

Merchant User Manual and Integration Guide May, 2005 91Auto ReturnHow Auto Return Works11Step 4: Bob is then taken to a confirmation page that displa

Auto ReturnHow Auto Return Works1192 May, 2005 Merchant User Manual and Integration GuideStep 6: The Widget Warehouse’s “Thank You” page appears, aga

Merchant User Manual and Integration Guide May, 2005 93Auto ReturnSetting Up Auto Return11Setting Up Auto ReturnTo set up Auto Return:1. Log in to yo

Auto ReturnSubscription Password Management and Auto Return1194 May, 2005 Merchant User Manual and Integration Guide5. Enter the Return URL to which

Merchant User Manual and Integration Guide May, 2005 9512Backend Integration - Payment NotificationsPayPal offers two payment notification methods fo

Backend Integration - Payment NotificationsPayment Data Transfer1296 May, 2005 Merchant User Manual and Integration Guidez History Log: View an onlin

Merchant User Manual and Integration Guide May, 2005 97Backend Integration - Payment NotificationsPayment Data Transfer12How It WorksBob is going to

Backend Integration - Payment NotificationsPayment Data Transfer1298 May, 2005 Merchant User Manual and Integration GuideStep 4: Bob is then taken to

Merchant User Manual and Integration Guide May, 2005 99Backend Integration - Payment NotificationsPayment Data Transfer12Step 7: The Widget Warehouse