Home

PayPal Merchant - 2005 User's Manual

Contents

1. Aluminum Widgets The surprisingly compact Widget E 019983763 is a powerful Steel Widgets no compromise solution for Outdoor Widgets widget professionals who are Indoor Widgets ion we road and raren WENI e office but who never want to be A without the speed and power of Plastic Widgets an automotive widget It slices dices and it will even make bread Sale Price 142 50 Titanium Widgets Global Industries Inc All rights reserved 2003 Step 2 Bob is taken to a PayPal Payment Details page which displays the details of the payment he is about to make Payments by EPAR e Glob Global Industries Inc Ope i Widget Warehouse Payment Details Secure Transaction Ey PayPal is the secure payment processor for your seller To continue PRIVACY please enter the required information below BBBOnLine Pay To Widget Warehouse Payment For Widget Currency U S Dollars K Amount 142 50 USD If you have never paid through PayPal _ Click Here PayPal Login Email Address pdeboe paypal cOM problems logging in PayPal Password Forget your password Continue Step 3 Bob enters his PayPal account information into the PayPal Login fields Merchant User Manual and Integration Guide May 2005 97 Pe Backend Integration Payment Notifications Payment Data Transfer Step 4 Bob is then taken to a confirmation page that displays the details of his selection information about how his automatic payments wi
2. Header Background Color optional Enter the background color for the header using HTML hex code The color code must be six digits long and should not contain the symbol If the Header Image URL is present then the header will be a 750 pixel wide by 90 pixel high space at the top of the payment page If the Header Image URL is not present the header height will be reduced to 45 pixels Header Border Color optional Enter the border color for the header using HTML hex code The color code must be six digits long and should not contain the symbol The header border is a 2 pixel perimeter around the header space Background Color optional Enter the background color for the payment page using HTML hex code The color code must be six digits long and should not contain the symbol 4 Click Preview to preview your page style or click Save to save it The next time you create a button you have the option to apply a page style to the payment pages associated with it To do so click Add More Options on the button creation page and select a page style from the Custom Payment Page Style menu Note The settings described here can also be specified with HTML lt FORM gt input variables passed through at a transaction level For more information see Table A 2 Shopping Cart Variables on page 138 76 May 2005 Merchant User Manual and Integration Guide Custom Payment Pages Editing a Page Style Editing a Pag
3. Profile Selling Preferences Auctions Sales Tax Shipping Calculations Shipping Preferences USPS Preferences UPS Preferences Payment Receiving Preferences Instant Payment Notification Preferences PayPal Shops Reputation Seller Eligibility for PayPal Buyer Protection Website Payment Preferences Encrypted Payment Settings Custom Payment Pages Inyoice Template Language Encoding Merchant User Manual and Integration Guide Language Encoding for Your Data Changing Your Language Encoding Changing Your Website Language The Language Encoding page displays the setting for your website s language as shown in the following illustration With the Your website s language drop down menu you change the setting FIGURE 14 2Language Encoding Settings Basic Choices Paypal My Account Overview Send Money Add Funds Language Encoding Log Out Help Merchant Tools Auction Tools Request Money Withdraw History Resolution Center Use the following drop down menu to select the language you use on your website The language on your website determines the encoding method that is used for the data sent to PayPal from the website payment buttons Your website s language Mobile Mass Pay Money Market ATM Debit Card BillPay Referrals About Us Accounts Fees More Options Cancel Privacy Buyer Credit Security Ce
4. Shipping Address If you would like your customers to be prompted to provide a shipping address choose Yes If you choose No your customers will not be asked to provide a shipping address 66 May 2005 Merchant User Manual and Integration Guide Creating Shopping Cart Buttons PayPal Shopping Cart Button Factory Step 9 Collect additional information from your customers Note Select Yes if you would like your customers to be able to include a note to you with their payment If you select No your customers will not be given the opportunity to include a note Note Title If you are allowing your customers to include a note with their payment you may choose a title for the note field By including a title you can prompt your buyers to enter specific information like a User ID or special instructions There is a 40 character limit on your note field title If you do not enter a title your customers will see Special Instructions optional as the note field title Step 10 Choose the email address at which you want to receive payment If you have more than one confirmed email address attached to your PayPal account you can specify the address at which you would like to receive your email payment notifications when your customers pay you Step 11 Copy and paste the PayPal Shopping Cart code When you have finished filling out the PayPal Shopping Cart Button Factory form click Continue Copy the code from the For Web pages text
5. Testing Tip 2 In your Website Payments button HTML code add or modify the return and rm variables as follows replacing the URL with the URL for your website lt input type hidden name return value http w mysite com ipn cgi gt lt input type hidden name rm value 2 gt Then with your buyer account click the Website Payments button and complete the transaction Once you get to the PayPal Payment Complete page you can use your browser s View Source function to view the values of the posted IPN variables at the bottom of the code Testing Tip 3 You can put debugging print statements into your IPN script PayPal recommends creating a debugging mode of your script that you can turn on and off by adding or removing variable comments Set the return variable in your Website Payments button HTML code to point to your IPN URL When you complete the payment the output of your script s print statements will be sent to your browser Third Party IPN Testing Solutions PayPal also provides links to a number of third party IPN testing solutions through the PayPal Developer Network at https www paypal com us cgi bin webscr cmd p pdn 3p solutions ipntools outside Merchant User Manual and Integration Guide May 2005 123 Your PayPal Button 124 May 2005 Merchant User Manual and Integration Guide Processing eChecks An eCheck is an electronic funds transfer that withdraws money directly from your buyer s ban
6. Receiving fees are assessed in the currency in which the funds were sent Payments converted to your primary currency are converted at a competitive exchange rate To learn more about receiving money in multiple currencies see the Multiple Currencies FAQs in the PayPal online Help Center If you use Instant Payment Notification IPN see Table B 3 IPN and PDT Variables Shopping Cart Information on page 152 for more information about Multiple Currencies variables May 2005 Merchant User Manual and Integration Guide Using Multiple Currencies Receiving Money Managing Currency Balances To manage your currency balances please go to the Currency Balances section of your Profile where you can e Select your primary currency e Open or close a currency balance e Transfer funds between currency balances Funds transferred from one currency balance to another will be transferred at a competitive exchange rate To learn more about managing currency balances see the Multiple Currencies FAQs in our Help Center Merchant User Manual and Integration Guide May 2005 113 E Using Multiple Currencies Receiving Money 114 May 2005 Merchant User Manual and Integration Guide Language Encoding for Your Data This chapter tells you how you can set your Profile preferences to indicate the language and character encoding that your website uses Background Information Websites that use PayPal in different parts ofthe world
7. TABLE B 6 IPN and PDT Variables Mass Pay Variable Name txn type payment _ status payment _ date masspay _ txn id x receiver _ email x mc_gross xX mc fee x Possible Values masspay Completed Denied Processed Transaction specific for Multiple Currencies Transaction specific for Multiple Currencies Description This payment was sent via Mass Pay Completed For Mass Pay payments this means that all of your payments have been claimed or after a period of 30 days unclaimed payments have been returned to you Denied For Mass Pay payments this means that your funds were not sent and the Mass Payment was not initiated This may have been caused by lack of funds Processed Your Mass Payment has been processed and all payments have been sent For Mass Pay payments the first IPN is the date time when the record set is processed and the second IPN is the date time when all payments are completed returned For Mass Pay payments a unique transaction ID generated by the PayPal system where x is the record number For Mass Pay payments the primary email address of the payment recipient where x is the record number The gross amount for the amount where x is the record number For Mass Pay payments the transaction fee associated with the payment where x is the record number May 2005 Merchant User Manual and Integration Guide TABLE B 6 IPN and PDT Variables Mass Payment IPN
8. handling cart variables For more information and a complete list of the Buy Now button variables see Sample Buy Now Button HTML on page 131 To make sure that the shipping HTML in your Shopping Cart Button overrides your Profile Shipping Calculation settings 1 Goto the Shipping Calculations page in your Profile 2 Click the Click here to allow transaction based shipping values to override the profile shipping settings listed above if profile settings are enabled checkbox 3 Click Save Merchant User Manual and Integration Guide May 2005 85 ES Calculating Shipping Handling and Tax Shipping Calculation 86 May 2005 Merchant User Manual and Integration Guide Creating Customer Contact Telephone The Customer Contact Information Telephone is an option that provides you with a contact telephone number for your buyer When you activate this option your customers are asked to include a Contact Telephone Number with their payment information PayPal will share this number with you In accordance with our User Agreement you may use this Contact Telephone Number only to communicate with the buyer about the related purchase You may not use this number for unsolicited commercial messages How It Works When you enter your payment preferences on the Website Payment Preferences page you will have the opportunity to request a Contact Telephone Number from your buyer You can choose to make the Contact Telephone
9. 1 Check that the payment _ status is Completed 2 Ifthe payment status is Completed check the txn id against the previous PayPal transaction you have processed to ensure it is not a duplicate 3 After you have checked the payment _ status and txn_id make sure the receiver email is an email address registered in your PayPal account 4 Check that the price mc_gross and currency mc_currency are correct for the item item name or item number Once you have completed the above checks you may update your database based on the information provided If you receive an INVALID response you should investigate In some cases this response is caused by an IPN error possibly from a change in the IPN format To determine if it is an IPN error first examine your code If you need further assistance go to http www paypal com wf click the Seller Tools topic and then click Instant Payment Notification IPN Specifying Your Notification URL If you only need to receive your IPNs at a single URL you can enter that URL in the Preferences section of your Profile If you would like to receive payment notifications for different payments at different URLs 1 e if you need to separate payments made to different websites you run you can manually pass the IPN URL with each payment by including it in that payment s HTML code Use the notify url field to pass this information The notify url for a specific payment will be saved and
10. gt lt input type hidden name business value amyrowe x com gt Merchant User Manual and Integration Guide May 2005 143 144 HTML Samples Prepopulating Your Customer s PayPal Sign Up lt inp lt inp lt inp lt inp lt inp lt inp lt inp lt inp lt inp lt inp lt inp lt inp lt inp lt inp border 0 secure gt lt form gt FE Ce ee CE Er CE eer A EE EE e E ER CYP CYP CYP CYP CYP CYP CYP CYP CYP CYP CYP x item name value hat gt item number value 123 gt 007 gt first_ name value John gt last_name value Doe gt address1 value 9 Elm Street gt address2 value Apt 5 gt CYP CYP gt lue 610 gt lue 555 gt lue 1234 gt hidden nam hidden nam hidden name amount value 15 hidden nam hidden nam hidden nam hidden nam hidden name city value Berwyn gt hidden name state value PA hidden name zip value 19312 gt hidden name night phone a va hidden name night phone b va hidden name night phone c va imag SRC http images paypal com images x click but01 gif CYP name submit alt Make payments with May 2005 PayPal it s fast free and Merchant User
11. making the total purchase 39 50 If your customer s subtotal is 66 50 your customer is charged 6 00 for shipping making the total purchase 72 50 Choose the Flat Amount radio button with the beneath it and enter a flat amount for each dollar amount increment Click Save to save your changes Percentage A percentage is charged based on the subtotal of a purchase Here s an example EXAMPLE 9 2 Percentage Shipping Calculation Your percentage settings are 0 00 through 49 99 5 50 00 4 Ifyour customer s subtotal is 36 50 your customer is charged 5 x 36 50 1 83 for shipping making the total purchase 38 33 Ifyour customer s subtotal is 66 50 your customer is charged 4 x 66 50 2 66 for shipping making the total purchase 69 16 Choose the Percentage radio button with the beneath it and enter a percentage for each dollar amount increment Click Save to save your changes Overriding Your Shipping Calculation In some cases you might want to set a special shipping rate for an item for example if the item is especially heavy and costs more to ship or if it is a service which does not require shipping charges To charge a different shipping amount for an item include the shipping cost in the HTML for that Buy Now button using the shipping shipping2 and 84 May 2005 Merchant User Manual and Integration Guide Calculating Shipping Handling and Tax Shipping Calculation
12. Item Product Number HIS 0001 How did you hear about us PayPal Shops Featured Shop Buyer Robert Smith May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons PayPal makes it easy to accept payments for single items through your own website The Buy Now and Donations Buttons features can be implemented in minutes giving you easy access to business and donors from PayPal s millions of members and any other buyer on the Web Because using Buy Now and Donations Buttons to send and receive payments is secure both you and your customers remain protected PayPal automatically encrypts your confidential information using the Secure Sockets Layer SSL protocol with an encryption key length of 128 bits the highest level commercially available Your customers will not need to share their private financial information e g credit card or bank account numbers during the transaction so they can complete payment while retaining security The flexibility of our Buy Now and Donations Buttons feature will keep your website working for you You can accept payments from current PayPal members as well as people who have just signed up for our service and you won t lose your customers after they have made a purchase or donation the payment process lets you return buyers to your website not lose them to ours Other benefits of Buy Now and Donations Buttons include e Easy to implement no CGI scriptin
13. There are three choices for this preference e Yes Accepts the payment regardless of the currency in which the payment is made e No accept them and convert them to U S Dollars Accepts the payment but automatically converts to U S Dollars e Ask Me You may choose to accept or deny a payment that is received in a currency you do not currently hold on a transaction by transaction basis If you accept the payment it becomes a completed transaction If you deny a particular payment the sender of the payment will be notified that the payment has been denied and will be credited with the payment amount PayPal does not charge fees for denied payments Blocking Payments From Users With Non U S PayPal Accounts Since many international addresses cannot be confirmed you may choose to block payments from users with non U S PayPal accounts in order to qualify for the Seller Protection Policy SPP Blocking Payments Initiated From the Pay Anyone Subtab This preference allows you to choose whether or not to receive payments initiated via the Pay Anyone subtab of the Send Money tab on the PayPal website If you choose to block these payments you will accept only payments initiated via PayPal s Buy Now Buttons Donations PayPal Shopping Cart Subscriptions and Recurring Payments Winning Buyer Notification Mass Payments Money Requests Post Sale Manager Invoices May 2005 Merchant User Manual and Integration Guide Getting Started Ma
14. number This allows the merchant to cross reference the payment Merchant User Manual and Integration Guide May 2005 155 156 IPN and PDT Variables Subscriptions Variables Subscriptions Variables Along with other IPN variables the following variables are included in Subscriptions IPNs TABLE B 7 Subscriptions Variables Possible Variable Values txn_type subscr failed ubscr ancel Q vn ubscr ayment ubscr ignup subscr eot nn u subscr modify subscr date subscr_ effective periodl period2 period3 amount1 amount2 amount3 mc _amountl Character Description Limit ubscr_ signup subscription sign up ubscr cancel subscription cancellation ubscr failed subscription payment failure ubscr payment subscription payment ubscr eot subscription s end of term Ann un unu un DW ubscr modify subscription modification Start date or cancellation date depending on whether transaction is subscr signup or subscr cancel Date when the subscription modification will be effective only for txn_type subscr modify optional Trial subscription interval in days weeks months years example a 4 day interval is periodl 4 D optional Trial subscription interval in days weeks months or years Regular subscription interval in days weeks months or years Amount of payment for trial period 1 for USD payments otherwise blank opti
15. order Privacy Contact Telephone 408 967 2342 Getting Started Use the following instructions to activate the Customer Contact Information Telephone option 1 Log in to your PayPal account at https www paypal com Click the My Account tab Click the Profile link Click the Website Payment Preferences link n a op o Select the option you prefer On Optional Field On Required Field or Off Recommended y Complete the rest of the selections on the page 7 Click Save Notifications You Receive You receive an email notification when a buyer makes a purchase 88 May 2005 Merchant User Manual and Integration Guide Auto Return With Auto Return for Website Payments merchants can eliminate the Done page in the Website Payments flow and automatically return or redirect buyers to their site upon payment completion By decreasing the Website Payments purchasing process by 1 3 and automatically bringing buyers back to their site merchants provide their buyers with a quicker more seamless and continuous purchasing experience Merchants with premier or business accounts can enable Auto Return by turning it on specifying the URL to redirect the buyer upon payment completion and agreeing to the terms that require that the merchant provide payment done messaging on the page assigned to the return URL Auto Return applies to all PayPal Website Payments including Buy Now Don
16. submit value Upload Cart gt lt form gt Additional Variables The additional variables that PayPal offers to customize your form post are the same as the additional variables for Buy Now and Donations May 2005 Merchant User Manual and Integration Guide HTML Samples EEN PayPal Shopping Cart HTML and Variables For more information on the additional variables please to the HTML and Hyperlink Variables section of the PayPal Buy Now Buttons HTML Code and Variables section of Appendix A 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 Cart Amount to PayPal with the following exceptions 1 Set the cmd variable to cart 2 Replace this required HTML line lt input type hidden name cmd value xclick gt with lt input type hidden name cmd value _cart gt 3 Add anew variable called upload by adding the following line between the lt form gt and lt form gt tags lt input type hidden name upload value 1 gt 4 Define item details For each of the following item specific parameters define a new
17. windows 1251 windows 1252 windows 1253 windows 1254 windows 1255 windows 1256 windows 1257 windows 1258 windows 874 Thai windows 949 Korean x mac greek x mac turkish x mac centraleurroman x mac cyrillic ebcdic cp us ibm 1047 Setting Language in Website Payments charset In the HTML for your PayPal website payment buttons such as for Buy Now Website Payments Website Payments Express you can use the charset HTML variable to specify the character set or character encoding of the data you collect in your website forms and send to PayPal PayPal sends data to you in the same character set or encoding you specify with the charset variable For a complete list of the allowable values for the charset variable see Table 14 1 Character Sets and Encodings Supported by PayPal May 2005 Merchant User Manual and Integration Guide 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 e 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 e 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 e Subscriptions Use the Sandbox for crea
18. Alice s site immediately after clicking Pay on the Payment Confirmation page The Payment Completion page can be merchant hosted if the merchant has turned on Auto Return To learn more about Auto Return see Chapter 11 Auto Return Merchant User Manual and Integration Guide May 2005 47 Creating Buy Now and Donation Buttons How Buy Now and Donations Work Step 7 Bob receives an email receipt for this transaction confirming his payment and including a copy of his payment details Receipt for your Payment Message Plain Text File Edit View Insert Format Tools Actions Help From service paypal com Sent Tue 5 14 2002 6 21 PM This email confirms that you have paid Alice s Used Books 17 00 using PayPal Amount 17 00 Transaction ID 4KK313372N3534454 Item Product Name Herodotus The History Item Product Number HIS 0001 How did you hear about us PayPal Shops Featured Shop Buyer Robert Smith What You See Step 8 Alice receives an email notification of Bob s payment Notification of Payment Received Message Plain TEM all File Edit view Insert Format Tools Actions Help From robertsmith beethoven com Sent Tue 5 14 2002 6 21 PM This email confirms that you have received a Payment for 17 00 from Robert Smith robertsmith beethoven com View the details of this transaction online at https www l com vst id 1GW76191NF4 Amount 17 00 Transaction ID 1GW76191NF408160D Total shippi
19. Buyer Credit Security Center Contact Us User Agreement Developers Shops Gift Certificates Points PayPal an eBay company Copyright 1999 2004 PayPal All rights reserved Information about FDIC pass through insurance 1 Begin at the Custom Payment Page Styles page For more information see Getting Started on page 75 2 Click the radio button next to the page style you wish to edit 3 Click Edit Merchant User Manual and Integration Guide May 2005 77 az Custom Payment Pages Previewing a Page Style 4 Keep or modify your page style preferences Page Style Name required Enter a name up to 30 characters in length The name can contain letters numbers and the underscore mark but no other symbols or spaces The Page Style Name will be used to refer to the page style within your PayPal account and in the HTML code for your PayPal Website Payment buttons Header Image URL optional Enter the URL for an image that is a maximum size of 750 pixels wide by 90 pixels high larger images will be cut to this size The image must be in a valid graphics format such as gif jpg png or swf The image will appear at the top left of the payment page Norte PayPal recommends that you enter an image URL only if the image is stored on a secure https server Otherwise your customer s Web browser will display a message that the payment page contains insecure items Header Background Color optional
20. Encoding at PayPal Sign up When you sign up for a new business account with PayPal the PayPal system determines your character set and its encoding based on your country of origin as specified by you during sign up For example if your postal address indicates France by default your Selling Preferences language encoding is set to a Western language character set Merchant User Manual and Integration Guide May 2005 115 116 Language Encoding for Your Data Changing Your Language Encoding Navigating Your Profile Language Encoding To see or change the default language encoding for your PayPal Business account log in to your account and click the Profile tab click Language Encoding at the bottom Selling Preferences column as shown in the following diagram FIGURE 14 1Profile Seller Preferences for Language Encoding FEET Send Money Request Money My Account Overview Add Funds Withdraw History Profile Summary To edit your Profile information please click on a link below Account Information Financial Information Email Street Address Credit Cards Phone Bank Accounts Password Currency Balances Notifications BillPa Time Zone Redeem Gift Certificates and Points Multi User Access Monthly Account silactezs Statements Business Information Merchant initistad Close Account Payments May 2005 Merchant Tools Resolution Center Log Out Help Auction Tools
21. Enter the background color for the header using HTML hex code The color code must be six digits long and should not contain the symbol If the Header Image URL is present then the header will be a 750 pixel wide by 90 pixel high space at the top of the payment page If the Header Image URL is not present the header height will be reduced to 45 pixels Header Border Color optional Enter the border color for the header using HTML hex code The color code must be six digits long and should not contain the symbol The header border is a 2 pixel perimeter around the header space Background Color optional Enter the background color for the payment page using HTML hex code The color code must be six digits long and should not contain the symbol 5 Click Preview to preview your page style or click Save to save it Previewing a Page Style To preview a page style 1 Begin at the Custom Payment Page Styles page For more information see Getting Started on page 75 2 Click the radio button next to the page style you wish to preview 3 Click Preview 78 May 2005 Merchant User Manual and Integration Guide Custom Payment Pages E Making a Page Style Primary Making a Page Style Primary When you make a page style Primary it is applied to all of your payment pages unless you specify otherwise To learn how to apply a page style other than your Primary style Chapter 8 Custom Payment Pages NoTE If
22. FlOWIEVVOTKS lt a id a a a ee 97 Enabling Payment Data Transfer 0 e 99 Setting Up Payment Data Transfer 0 o eee 101 Instant Payment Notification IPN 0 0002 e o 103 How It Works eea evia e a a e e a e a e a a a a e T E a a a A 103 How IPNs Are Sent ae a a ee 104 Setting Up IPN s es sadean ee Bea ar a eee AS 106 Notification Validation 2 a a 106 Using IPN with Multiple Currencies 2 0 a 107 Dispute Notification o e 108 Processing Refunds 1 108 Chapter 13 Using Multiple Currencies 4111 Receiving Money e e 111 Accepting Payments a 111 Managing Currency Balances aoaaa a o 113 Chapter 14 Language Encoding for Your Data 115 Background Information oaa a a 115 Changing Your Language Encoding ao a a 115 Your Default Language Encoding at PayPal Sign up aa aaa a a 115 Navigating Your Profile Language Encoding aoaaa aa a 116 Changing Your Website Language aooaa a a 117 More Encoding Options 2 a 119 Setting Language in Website Payments charset 120 Chapter 15 Testing lt lt lt 6 8 206 es wg eae a wee ee 121 Website Payments PDT andIPN 0 00020 eee ee eee 121 Your PayPal Button ss i a ee 4 a4 a be aa be ek ea ee Ae ed 122 Testing TIPS pae 2 amp 4 tee 2b be Adee he eh ee Ch BED
23. Guide PayPal Payments Overview ESE Subscriptions For more information about PayPal s Reporting Tools see https www paypal com us cgi bin webscr cmd p xcl rec reports intro outside Subscriptions PayPal Subscriptions and Recurring Payments is a service that will let you accept recurring payments for your service When you set up Subscriptions you can offer your subscribers a trial period special introductory rates and a regular rate Your subscribers will be billed automatically according to the terms you dictate removing the hassle of keeping track of which payments you have and have not received For more information about PayPal Subscriptions and Recurring Payments see the PayPal Subscriptions manual which is available on the PayPal website Merchant User Manual and Integration Guide May 2005 25 PayPal Payments Overview Payment Flow Overview Payment Flow Overview The following diagram represents an overview of the PayPal payment flows FIGURE 2 1 PayPal Payment Flows Key p No PayPal cookie i No PayPal cookie Merchant PayPal Account Merchant site PayPal Account Optional on Buy button Optional off PayPal page PayPal Interstitial PayPal cookie shown for few eae 4 before redirecting v baad PayPal Account Website Payment Website Payment Optional gt N Login Signup Login or Continue Continue Logged in is in PayPal Account Website Payment Optional Payment S
24. History Item Number HIS 0001 Item Amount 15 00 Quantity i Total 15 00 a Merchant User Manual and Integration Guide May 2005 63 az Creating Shopping Cart Buttons PayPal Shopping Cart Button Factory What You See Step 9 Alice receives an email notification of Bob s payment Notification of Payment Received Message Plain es lol xj File Edit View Insert Format Tools Actions Help From robertsmith beethoven com Sent Tue 5 14 2002 6 21 PM This email confirms that you have received a Payment for 17 00 from Robert Smith robertsmith beethoven com View the details of this transaction online at https www paypal com vst id 1GW76191NF4081600D Amount 17 00 Transaction ID 1GW76191NF408160D Total shipping 2 00 Quantity 1 Item Product Name Herodotus The History Item Product Number HIS 0001 Step 10 Alice logs into her PayPal account to check the payment Bob has sent FP Payment From Robert Smith May 14 2002 Completed Step 11 The funds from Bob s payment are now reflected in Alice s PayPal account balance She ships the books to her satisfied customer U S Business Account Overview Name Alice s Used Books Alice Jones Email alice mystore com Add email Status Verified 0 Balance 16 21 Currently earning 1 20 PayPal Shopping Cart Button Factory With the PayPal Shopping Cart your buyers can make a single payment when they purchase multi
25. Integration Guide Preface This Document This document the Merchant User Manual and Integration Guide which describes how to use and integrate PayPal features for merchants replaces the PayPal Merchant User Manual and Integration Guide issued in February 2005 Intended Audience This document is written for merchants whose websites use PayPal features to obtain payments from PayPal members 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 sele
26. Items to PayPal 0 a 139 Prepopulating Your Customer s PayPal Sign Up 141 Prepopulation for Website Payments Buttons 0 141 Prepopulation for Account Signup a ooa e 142 Sample HTML ioa io aia e ge e Bee eo he a a e 143 Appendix B IPN and PDT Variables 145 About These Tables of Variables 0 020002 2s 145 test_ipn Variable in Sandbox e 145 IPN Variables in All POStS lt o sorae aene don e 146 Buyer Naman a a E a aA a aA a a a T a 146 Basic Information ee 147 Advanced and Custom Information 00002 eee ee eee 148 Shopping CartInformation 2 0000 eee ee 148 Currency and Currency Exchange 00000 eee eee 152 AUGOS aiia ui le oe RO e oe Go ted db do ea ea a a ed oe E 153 Mass Payments i ic dec ho E oe ee Pe Geode er ae ae Sie Gee Be 154 Subscriptions Variables ee 156 Merchant User Manual and Integration Guide May 2005 9 fon Contents Dispute Notification Variables 0 00020 eee eee ee 160 PDT Specific Variables ooa aa ee 162 Appendix C Country Codes 163 ISO 3166 Standard Country Codes eo 163 10 May 2005 Merchant User Manual and Integration Guide Table 1 1 Table 1 2 Table 8 1 Table 14 1 Table A 1 Table A 2 Table A 3 Table A 4 Tabl
27. Log in to your PayPal account at https www paypal com 2 Click the Profile sub tab 3 Click the Custom Payment Pages link under the Selling Preferences heading to get to the Custom Payment Page Styles page 4 From this page you can add edit preview and remove page styles as well as make any page style your primary style Merchant User Manual and Integration Guide May 2005 75 az Custom Payment Pages Adding a Page Style Adding a Page Style You can add up to three page styles To add a page style 1 Begin at the Custom Payment Page Styles page 2 Click Add 3 Enter your page style preferences Page Style Name required Enter a name up to 30 characters in length The name can contain letters numbers and the underscore mark but no other symbols or spaces The Page Style Name will be used to refer to the page style within your PayPal account and in the HTML code for your PayPal Website Payment buttons Header Image URL optional Enter the URL for an image that is a maximum size of 750 pixels wide by 90 pixels high larger images will be cut to this size The image must be in a valid graphics format such as gif jpg png and swf The image will appear at the top left of the payment page Norte PayPal recommends that you enter an image URL only if the image is stored on a secure https server Otherwise your customer s Web browser displays a message that the payment page contains insecure items
28. Optional With PayPal Account Optional turned on your customers who are new to PayPal will be able to make credit card payments without signing up for a PayPal account This setting is available from your Profile for Premier and Business accounts PayPal Account Optional is turned on by default for all U S Premier and Business accounts Y our customers who already have PayPal accounts will go through the same Website Payments experience to which they re accustomed which is shown in the How It Works section of the Creating Buy Now and Donations Buttons section of this manual Your new customers or existing customers who are new to PayPal will go through a checkout that doesn t require PayPal signup but they will have that option available after completing the payment Whether customers sign up for a PayPal account or not you can set your Buy Now Donations and Shopping Cart Buttons to return them to your website and you will still receive the same notification emails as in the current checkout flow Turning PayPal Account Optional On or Off 1 Log in to your PayPal account at https www paypal com Click the Profile subtab Click the Website Payment Preferences link in the Selling Preferences column bb O N Scroll down to the PayPal Account Optional section of the page Select On to turn PayPal Account optional on or Off to turn it off and continue using the existing Website Payments flow for all o
29. Please enter the following information exactly as it appears on your credit card statement and click Continue Checkout below Your financial information will be kept secure How does PayPal keep my information safe Card Type Select Credit Card Number Expiration Date 1 y 2004 First Name Bop as it appears on card Last Name as it appears on card Buyer Email Address PayPal will use your ernail address to send you a receipt of this transaction Your email address will be kept private and will not be shared Email Address Credit Card Billing Address Enter the address where you receive your credit card bills Address 1 Address 2 optional City State Zip Coide or 9 digits Country United States Phone Number Enter the phone number you use for billing contact on this credit card This information will be kept confidential and will only be used to authorize this payment or to provide customer service PayPal will not share your phone number Home Telephone Privacy Security Measure Enter the characters as they are shown in the box below This will further increase the security of your account and the PayPal network This is not your password Help Chere ae mo Gl it Message to Seller Optional Enter your information in the field below Back Continue Checkout Cancel May 2005 Merchant User Manual and Integration Guide PayPal Account Optional Your Customer s Exp
30. Processing eChecks Refunding eChecks 126 May 2005 Merchant User Manual and Integration Guide 1 Security Notification Validation Notification validation is the process you use to validate your IPN data For more information about Notification Validation see Notification Validation on page 106 Button Encryption If you choose Button Encryption in the Button Factory which is the default value your website payments will be secure thus both you and your customers remain protected PayPal automatically encrypts your confidential information using the Secure Sockets Layer SSL protocol with an encryption key length of 128 bits the highest level commercially available Y our customers will not need to share their private financial information e g credit card or bank account numbers during the transaction so they can complete payment while retaining security NoTE Encrypting your button code is highly recommended but doing so has three limitations e The HTML code generated for an encrypted button will not be editable so if you are accustomed to modifying your button code manually you may want to clear this option e You will not be able to encrypt your button 1f it has dynamically generated code from the Add More Options page such as drop down Option fields see step 5 If you need Option fields for your products then you will want to turn encryption off by selecting No e Also you cannot create an email
31. address Use this email to provide any credits Unique customer ID Character Length 64 64 127 128 200 40 40 20 64 127 13 May 2005 Merchant User Manual and Integration Guide IPN and PDT Variables E Basic Information TABLE 17 1 IPN and PDT Variables Buyer Information Character Variable Name Possible Values Description Length payer verified Customer has a Verified PayPal account status unverified Customer has an Unverified PayPal account Basic Information TABLE B 1 IPN and PDT Variables Basic Information Character Variable Name Possible Values Description Length business Email address or account ID of the payment recipient i e the 127 merchant Equivalent to receiver email if payment is sent to primary account and essentially an echo of the business variable passed in the Website Payment button HTML code receiver _ Primary email address of the payment recipient i e the 127 email merchant If the payment is sent to a non primary email address on your PayPal account the receiver email will still be your primary email receiver id Unique account ID of the payment recipient i e the merchant 13 This is the same as the recipient s referral ID item name Item name as passed by you the merchant Or if not passed by 127 you as entered by your customer If this is a shopping cart transaction PayPal will append the number of the item e g item namel item name2 item
32. and PDT Variables Mass Pay Variable Name me currency x payment _ gross x status x payment fee x unique id x Possible Values Transaction specific for Multiple Currencies Transaction specific for USD payments only Completed Failed Reversed Pending Transaction specific for USD payments only Description For Mass Pay payments the currency of the amount and fee where x is the record number Currently this currency can only be in USD however there are plans to add multi currency in the future If the payment is USD then the value for this is the same as that for the mc_gross_x where x is the record number if the currency is not USD then this is an empty string For Mass Pay payments the status of the payment where x is the record number Completed The payment has been processed regardless if this was originally a unilateral payment Failed The payment failed because there was not enough funds in the balance Reversed This is for unilateral payments that were not claimed after 30 days and have been returned to the Sender Or the funds have been returned because the Receiver s account was locked Pending This is for unilateral payments that are unclaimed If the payment is USD then the value is the same as that formc_fee x where X is the record number if the currency is not USD then this is an empty string For Mass Pay payments the unique ID from input where x is the record
33. cgi bin webscr cmd p gen ua ua outside https www paypal com fees help https www paypal com wf 20 May 2005 Merchant User Manual and Integration Guide PayPal Payments Overview This section provides a brief overview of each of the products described in this manual PayPal Account Optional With PayPal Account Optional turned on your customers who are new to PayPal will be able to make credit card payments without signing up for a PayPal account This setting is available from your Profile and is available to Premier and Business accounts PayPal Account Optional is turned on by default for all U S Premier and Business accounts This means that your customers who already have PayPal accounts will go through the same Website Payments experience to which they re accustomed Y our new customers or existing customers who are new to PayPal will go through a checkout that doesn t require PayPal signup however they will have that option available after completing the payment Whether customers sign up for a PayPal account or not you can set your Buy Now Donations and Shopping Cart Buttons to return them to your website and you will still receive the same notification emails as in the current checkout flow For more information about PayPal Account Optional see Chapter 4 PayPal Account Optional Buy Now and Donations Buttons PayPal makes it easy to accept donations and payments for singl
34. flow that occurs when PayPal Account Optional is turned off and the user must create a PayPal account to complete the transaction For more information about the PayPal Account Optional setting see Chapter 11 Auto Return What Your Customer Sees Step 1 Bob goes to Alice s website and clicks Add to Cart When he has chosen all of the books he wants he clicks View Cart Home Art Language History Science The Histor Herodotus The History Herodotus Translated by David Grene gt Condition Like new slightly worn binding Price 15 00 Add to Cart Merchant User Manual and Integration Guide May 2005 59 az Creating Shopping Cart Buttons How It Works Step 2 Bob looks at the contents of his cart and clicks Checkout Payments by Alice s Used Books _Qty Remove Options Price Herodotus The History 1 m HIS 0001 15 00 Homer The Illiad amp The Odyssey 1 D HIS 0125 20 00 Shipping tax and handling costs will be calculated upon checkout Amount 35 00 Update Cart Checkout Step 3 Bob is taken to a PayPal Payment Details page which shows the items he has added to his Cart Payment Details PayPal is the authorized payment processor for Alice s Used Books Pay To Alice s Used Books Payment For Shopping Cart View Contents Amount 35 00 Step 4 Bob is prompted to log in to his PayPal account but he is not already a PayPal member so he follows the instru
35. he ee ee a 123 Third Party IPN Testing Solutions 2 0 2 2 00000 e o eo 123 Chapter 16 Processing eChecks 125 Blocking Checks lt o a e a e a 125 Refunding eChecks s sess iara enad aa e e ea 125 Chapter 17 Security 46468 lt 64 44 ee dia es 127 8 May 2005 Merchant User Manual and Integration Guide Contents ion Notification Validation 0 o ee 127 Button Encryption 2 ba a aa a aLa a a a a eea a F 127 Multi User Access ee 128 Getting Stamed 6 cs ok ee a a a A i Re O A 129 Using Secure Socket Layer SSL aoa aa a e e 130 General Information 2 0200 ee ee 130 SSL Certificate Providers 020000022 130 Appendix A HTML Samples 131 PayPal Buy Now and Donation Buttons HTML and Variables 131 Integrating Buy Now Buttons with your Shopping Cart 131 Sample Buy Now Button HTML e eo 131 Sample Buy Now Hyperlink o e o 132 Buy Now and Donations HTML and Hyperlink Variables 132 PayPal Shopping Cart HTML and Variables 0 e 2 137 PayPal Shopping Cat HTML e 137 Standard Add to Cart HTML o o 137 Shopping Cart Variables e 138 Adding PayPal Checkout To Your Third Party Shopping Cart 138 Passing Individual
36. hidden name cmd value _cart gt Merchant User Manual and Integration Guide May 2005 71 Adding PayPal to Your Third party Shopping Cart Passing the Aggregate Shopping Cart Amount to PayPal 3 Add a new variable called upload by adding the following line between the lt form gt and lt form gt tags lt input type hidden name upload value 1 gt 4 Define item details For each of the following item specific parameters define a new set of values that correspond to each item that was purchased via your third party cart Append _xto the variable name where x is the item number starting with 1 and increasing by one for each item that is added 5 Repeat for each item included in cart Include a set of required variables and any optional variables from the table above for each item included in your buyer s cart The first item included in the cart should be defined with parameters ending in _1 suchas item name 1 amount_1 and so on Similarly the second item should be denoted with variables like item name 2 amount 2 and so on IMPORTANT The _xvalues must increment by one continuously in order to be recognized If you skip from item 1 to item 3 without defining an item 2 the third item will be ignored To specify currency All monetary variables amount_x shipping x shipping2_x handling x tax_x and tax cart are interpreted in the currency designated by the currency code variable posted with the payment Beca
37. information as shown in the following diagram Merchant User Manual and Integration Guide May 2005 29 30 Getting Started Managing Your PayPal Merchant Account FIGURE 3 4 Merchant Profile Page My Account Send Money Overview Add Funds Profile Summary To edit your Profile information Account Information Email Street Address Phone Password Notifications Multi User Access Business Information Close Account Account Information Request Money Withdraw History click on a link below Financial Information Credit Cards Bank Accounts Currency Balances BillPay Redemption Codes Monthly Statements Merchant Tools Auction Tools Profile Selling Preferences Auctions Sales Tax Shipping Calculations Shipping Preferences Payment Receiving Preferences Instant Payment Notification Preferences PayPal Shops Reputation Use the Account Information column to perform basic account maintenance including updating your password adding and confirming email addresses and managing your business information Financial Information Use the Financial Information column to organize and maintain all of the financial instruments associated with your PayPal account including adding credit cards and bank accounts activating and managing your PayPal Debit Card maintaining your Multiple Currency Balances and viewing your Monthly Account Statements Selling Pre
38. is a Shopping Cart transaction please to the following Shopping Cart Information section for more information Option 2 name as requested by you If this is a Shopping Cart transaction please to the following Shopping Cart Information section for more information Option 2 choice as entered by your customer If this is a Shopping Cart transaction see Table B 3 IPN and PDT Variables Shopping Cart Information on page 148 for more information Character Length 127 255 255 64 200 Shopping Cart Information TABLE B 3 IPN and PDT Variables Shopping Cart Information Variable Name num_cart_ items Possible Values Description If this is a PayPal Shopping Cart transaction number of items in cart May 2005 Merchant User Manual and Integration Guide TABLE B 3 IPN and PDT Variables Shopping Cart Information IPN and PDT Variables Shopping Cart Information Variable Name tax option namel option selectionl _ x option name2 option _ selection2 x mc_gross x mc handling x mc shipping x Possible Values Transaction specific for Multiple Currencies Transaction specific for Multiple Currencies Transaction specific for Multiple Currencies Description PayPal appends the number of the item e g item_name1 item name2 The tax xis only included if there was a specific tax amount applied to a particular shopping cart item Be
39. item you wish to sell Currency required Choose the currency in which you would like this payment to be denominated This field will default to the currency of your primary balance Step 2 Choose an image for your button If you are going to be receiving payments from your website choose the image for the button you would like your customers to click to make their purchase To display your own image enter the URL of the image s location in the URL field Note All items added to a PayPal Shopping Cart must be denominated in a single currency which is determined by the currency specified for the first item added to the Cart Once one item is added to a Cart buyers will not be allowed to add any items listed in other currencies to that Cart To change the currency buyers must either Checkout and purchase the items in the first currency or remove all existing items from the Cart and add the items of the second currency The best option is to list all of your items in the same currency If you do not have additional details to add to your button such as sales tax shipping or your logo click Create Button Now and go to Step 12 Otherwise click Add More Options to see the fields listed in Step 3 12 Step 3 Calculate shipping and tax If you have already specified shipping rates in your Profile they will be listed under Shipping Cost Calculation For more information about calculating shipping see Chapter 9 Calculating
40. link if you choose to encrypt your button Merchant User Manual and Integration Guide May 2005 127 128 Security Multi User Access Multi User Access PayPal s Multi User Access feature allows you to set up multiple logins and give others different levels of access to your PayPal account so your employees only have access to the parts of your Paypal account that they need to complete their jobs For example if you want to provide your customer service representatives with their own login with limited permissions so that they only have the ability to view balances and perform refunds but not the ability to edit profiles send money withdraw funds and so on My Account Send Money Request Money Overview Add Funds Withdraw Multi User Access Current Users Auction Tools History Back to Profile Summary The users below currently have access to your PayPal account To add a user to your account click Add To edit a user s privileges choose the radio button of the user in question and click Edit User Name benlistwon Amelia Emerson Edit Change Password Remove Change your Administrative Email Address User ID nettles1234 ameliaemerson Add Note If you have given others access to your account in the past please reset the Primary password to your account as a safety precaution Using the Multi User Access feature you can give your employees access to any combinat
41. must not be changed lt form target paypal action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value _cart gt lt input type hidden name business value nora alice paypal com gt lt input type hidden name item name value Baseball Hat gt t t lt input type hidden name item number value 12345 gt lt input type hidden name amount value 15 00 gt lt input type hidden name cn value How Did You Hear About Us gt lt table gt lt tr gt lt td gt lt input type hidden name on0 value Color gt Color lt select name os0 gt lt option value Red gt Red lt option value Green gt Green lt option value Blue gt Blue lt select gt lt td gt lt tr gt lt table gt lt input type image src https www paypal com images x click but22 gif border 0 name submit alt Make payments with PayPal it s fast free and secure gt lt input type hidden name add value 1 gt lt form gt Merchant User Manual and Integration Guide May 2005 137 138 HTML Samples PayPal Shopping Cart HTML and Variables Shopping Cart Variables The Shopping Cart variables are the same as the Buy Now and Donation variables The following table lists all of the variables that are specific to the Shopping Cart Button For more information on the additional variables please to the HTML and Hyperlink Variables section of the Pa
42. number Pass through variable for you to track purchases It will get 127 passed back to you at the completion of the payment If omitted no variable will be passed back to you quantity Quantity as entered by your customer or as passed by you the merchant If this is a shopping cart transaction we will append the number of the item e g quantityl quantity2 Merchant User Manual and Integration Guide May 2005 147 148 IPN and PDT Variables Advanced and Custom Information Advanced and Custom Information TABLE B 2 IPN and PDT Variables Advanced and Custom Information Variable Name invoice custom memo tax option namel option selectionl option name 2 option selection2 Possible Values Description Pass through variable you can use to identify your Invoice Number for this purchase If omittted no variable will be passed back to you Custom value as passed by you the merchant These are pass through variables that are never presented to your customer Memo as entered by your customer in PayPal Website Payments note field Amount of tax charged on payment If this is a Shopping Cart transaction to the following Shopping Cart Information section for more information Option 1 name as requested by you If this is a Shopping Cart transaction please to the following Shopping Cart Information section for more information Option 1 choice as entered by your customer If this
43. payment page is not allowed The color makes the fields the customer must complete difficult to read FIGURE 8 5 Example of Unallowed Background Color Merchant User Manual and Integration Guide May 2005 81 82 Custom Payment Pages Background Colors and Error Messages The background color of the following payment page is allowed Unlike in the previous example the fields displayed in red are easy to read FIGURE 8 6 Example of Allowable Background Color Shipping Information Select a cteppeng preferanse and then cbc Continua Checkout bakra Shipping No stepping required onina download payment for a service afc E Gripping requerad book t shirt atc Pesse ship to the address we entered below Salect the country for your baling and stepping addrasses Both address0s must bo in ihi car Country Country need Sian r Select Coontry First heme Last Mamit E Address 1 Address 7 optional City abel hor 9 digits Country Yrited 514165 Milling Address 15 ihe above address Mao your credit card kiling promit O Wes E Ho fro we ll ack you for it later To verify that your background color is allowed enter its hex code into the Background Color field on the Custom Payment Pages page under the Profile subtab of the My Account tab and click Preview The background color is allowed if you are able to preview the payment page with your chosen background color If y
44. purchase and including a copy of the payment details the Widget Warehouse s business information and his confirmed shipping address The way to send and P ESAR a Teceive money online Protect Your Account Info Dear Bob Deboe Make sure you never provide your y password to fraudulent websites This email confirms that you Bob Deboe have paid Widget Warehouse 162 50 using PayPal To safely and securely access the PayPal website or your account open up a new web browser e g Internet Explorer or Netscape and type in the PayPal URL A https www paypal corn to be Payment Details sure you are on the real PayPal site Amount 162 50 USD PayPal will never ask you to enter your i password in an email Transaction ID 78H54514UY26 For more information on protecting yourself Quantity 1 from fraud please review our Security Tips Iter Product at me oe https www paypal com securitytips Protect Your Password You should never give your PayPal password to anyone including PayPal employees Enabling Payment Data Transfer Turning On PDT To turn on PDT 1 Click the My Account tab 2 Click the Profile subtab Merchant User Manual and Integration Guide May 2005 99 100 Backend Integration Payment Notifications Payment Data Transfer 3 Click the Website Payment Preferences link as shown in the following diagram Selling Preferences Auctions Sales Tax Shipping Calculations Shipping Pref
45. text right clicking your mouse and clicking Copy In your website files open the code for the Web page from which you wish to collect payment Paste the code you just copied into your Web page file wherever you would like the image to appear typically next to the description of the donation service by pressing Ctrl V or right clicking on your mouse and selecting Paste If you will be sending your donors the Donations link via email 54 May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons Buy Now and Donations Button Factory 1 Copy the code from the For Emails text box by highlighting all of the text and pressing Ctrl C or by highlighting all of the text right clicking on your mouse and selecting Copy 2 Open the email you wish to send 3 Paste the code you just copied into your email by either pressing Ctrl V or right clicking on your mouse and selecting Paste When your donors receive the email the code will appear as a link Clicking the link will take them to your PayPal payments page NoTE HTML Tips Please ensure that the HTML code on your Web page exactly matches the code you copied from PayPal Some HTML editors may add delete or change some characters in your code If this is the case please change the code on your Web page to exactly match the code you copied You can copy the code into a new Notepad document reselect all of the code copy then paste it into
46. the browser before the redirection is complete IPN e Does not require Auto Return to be enabled e At the end of the website payment flow PayPal POSTs the IPN data asynchronously i e not as part of the website payment flow e IPNs will also POST for eCheck clearings reversals and refunds SSL Security Not Required for IPN Because credit card and bank information is not transmitted in Instant Payment Notification IPN PayPal does not require the use of SSL to encrypt IPN transmissions Payment Data Transfer Payment Data Transfer PDT provides merchants with the ability to display transaction details to buyers who are redirected back to their site upon payment completion Norte You must enable Auto Return for Website Payments to use Payment Data Transfer Auto Return brings your buyers back to your website immediately after payment completion Auto Return applies to PayPal Website Payments including Buy Now Donations Subscriptions and Shopping Cart For more information on Auto Return Chapter 11 Auto Return May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications Payment Data Transfer How It Works Bob is going to purchase a widget from the Widget Warehouse Step 1 Bob goes to the Widget Warehouse website finds the widget he wants and clicks Buy Now GD nasties Global Industries Inc peas Widget Warehouse Wooden Widgets EADAE Widget 019983763
47. website you need to include the View Cart buttons so your customers can quickly proceed to checkout when they are ready Merchant User Manual and Integration Guide May 2005 67 68 Creating Shopping Cart Buttons How You Get Your Money 1 Copy the code from the Copy View Cart button HTML box by highlighting all of the text and pressing Ctrl C or by highlighting all of the text right clicking on your mouse and choosing Copy 2 Open each Web page from which you would like your customers to be able to get to their PayPal Shopping Carts 3 Paste the code you just copied into your Web page file where you would like your View Cart button to appear by either pressing Ctrl V or by right clicking on your mouse and choosing Paste Note You also have the option of prepopulating your customer s information For more information and a list of variables see Prepopulating Your Customer s PayPal Sign Up on page 141 How You Get Your Money After your customer has made his payment 1 You will receive an email notification of the payment 2 Your customer will receive an email receipt for the payment 3 Your PayPal account will reflect the payment You can view this information from your Account History or download it as part of your History transaction log Notifications You Receive Email You can be notified of payments in these three ways email history transaction log and downloadable h
48. work with different languages Human languages are represented in computing by the terms character set and character encoding A character set is a computer representation of all the individual possible letterforms or word symbols of a language For instance ASCII or American Standard Code for Information Interchange is a common character set that has been used for decades to represent the letterforms numbers punctuation and symbols of American English Another example of a character set is Big 5 which is the most widely implemented Chinese character set in Taiwan Character encoding on the other hand refers to how a particular character set is represented internally in data processing that is how the individual characters are actually stored and operated on There many different kinds of character encodings For example an encoding might allow 7 8 or 16 computer bits for a single character PayPal refers to these two terms together as language encoding Changing Your Language Encoding This section describes the default character encoding PayPal assumes for you and how you can change that setting With your Language Encoding preferences you can precisely control the encoding of the data that PayPal should expect from your website s use of any PayPal website payment button such as Buy Now Donation or Website Payments and the encoding of the data that your website expects to receive back from PayPal Your Default Language
49. x on1 x mustbe 200 defined for os1_X to be recognized 5 Repeat for each item included in cart Note Include a set of required variables and any optional variables from the table above for each item included in your buyer s cart The first item included in the cart should be defined with parameters ending in _1 such as item_name_1 amount_1 and so forth Similarly the second item should be denoted with variables like item name 2 amount 2 etc The x values must increment by 1 in sequence in order to be recognized If you skip from item 1 to item 3 without defining an item 2 the third item is ignored To specify currency All monetary variables amount_x shipping x shipping2_x handling x tax x and tax cart are interpreted in the currency designated by the currency code variable posted with the payment Because currency code is not item specific there is no need to append _x to the currency code variable name If no currency code variable is posted we will assume that all monetary values are in U S Dollars To specify cart wide tax Use the tax_cart variable to specify a tax amount that applies to the entire purchase rather than to individual items The tax cart variable overrides any per item tax amount specified with tax_x 140 May 2005 Merchant User Manual and Integration Guide HTML Samples aa Prepopulating Your Customer s PayPal Sign Up Prepopulating Your Customer s P
50. your Web editor Please be sure that when you paste the HTML code for your button you are pasting this information into a field that accepts HTML code If you paste this code into a standard text field the code will be posted to your Web page as standard text How You Get Your Money After your customer has made his payment 1 You will receive an email notification of the payment 2 Your customer will receive an email receipt for the payment 3 Your PayPal account will reflect the payment you can view this information from your account history or download it as part of your history transaction log For more information about payment related notifications see Notifications You Receive on page 56 and Chapter 12 Backend Integration Payment Notifications Merchant User Manual and Integration Guide May 2005 55 56 Creating Buy Now and Donation Buttons Notifications You Receive Notifications You Receive Email History You can be notified of payments in these three ways email history transaction log and downloadable history transaction log You can be notified of payments in these four ways email history transaction log downloadable history transaction log and if you have activated it Instant Payment Notification IPN You receive an email notification in the following cases e Successful Payment e Pending Payment e Cancelled Payment If you do not want to receive payment notifications via em
51. 40 Merchant User Manual and Integration Guide May 2005 133 134 HTML Samples PayPal Buy Now and Donation Buttons HTML and Variables TABLE A 1 HTML and Hyperlink Variables for Buy Now and Donations Buttons Name no note no shipping cancel return return rm page style cpp header _ image cpp headerb ack color Character Description Length Including a note with payment If set to 1 your customer will not be prompted to include a note If omitted or set to 0 your customer will be prompted to include a note The buyer s shipping address If omitted or set to 0 your customer will be prompted to include a shipping address If set to 1 your customer will not be asked for a shipping address If set to 2 your customer will be required to provide a shipping address An internet URL where the user will be returned if payment is cancelled for example a URL on your site which hosts a Payment Cancelled page If omitted users will be taken to the PayPal website The internet URL where the customer will be returned after completing the payment for example a URL on your site that hosts a Thank you for your payment page If omitted your buyer will be taken to the PayPal website Return URL behavior If set to 1 and if return is set upon completion of the payment the buyer will be sent back to the return URL using a GET method and no transaction variables wil
52. 47 Make Changes Complete Checkout Cancel Merchant User Manual and Integration Guide May 2005 39 40 PayPal Account Optional Your Customer s Experience Step 6 Bob is taken to a payment completion page where he sees his Receipt ID for this transaction and Alice s customer service contact information He can use both to contact Alice with any questions about his purchase Alice s Used Books Payments by REPAR Welcome Shipping Billing Review Done You Have Completed Your Transaction Your purchase from Alice s Used Books is complete It will appear on your credit card statement as PAYPAL ALICESUSEDB Save the Receipt ID below either by writing it down or by printing out this page PayPal has also emailed a copy of the receipt to the email address you provided please keep it for your records You will need this information to identify yourself if you require any customer support from PayPal or the merchant Contact Information Business Name Alice s Used Books Contact Email helpQmystore com Contact Phone 888 888 8888 Save Your Information With PayPal You ve just made a payment with PayPal Save your information with us and you can shop online securely quickly and easily e Save time by entering your credit card information only once e Check out more quickly at millions of websites and online auctions that accept PayPal e Keep your credit card safe with PayPal your financial information
53. Chapter 8 Custom Payment Pages Sets the background color for the header of the payment page Valid character set is 6 character HTML Hex code in ASCII This variable is not case sensitive May 2005 Merchant User Manual and Integration Guide HTML Samples EEN PayPal Buy Now and Donation Buttons HTML and Variables TABLE A 1 HTML and Hyperlink Variables for Buy Now and Donations Buttons Character Name Description Length cpp headerb Sets the border color around the header of the payment page The border is a 2 order color pixel perimeter around the header space which has a maximum size of 750 pixels wide by 90 pixels high Valid character set is 6 character HTML Hex code in ASCII This variable is not case sensitive cpp payflow Sets the background color for the payment page below the header Valid _color character set is 6 character HTML Hex code in ASCII This variable is not case sensitive Certain background colors that conflict with PayPal s error messages are not allowed For more information see see Chapter 8 Custom Payment Pages address _ If set to 1 the address passed in via prepopulation fields will override the override user s stored address The user will be shown the passed in address but will not be able to edit it If the address is not valid i e missing required fields including country or not included then no address will be shown cbt Sets the text for the Continue button on the PayPa
54. Details PayPal is the authorized payment processor for Alice s Used Books Pay To Alice s Used Books Payment For Herodotus The History Quantity fi Amount 15 00 Step 3 Bob is prompted to log in to his PayPal account however he is not already a PayPal member so he clicks If you have never paid through PayPal Click Here as shown in the following picture PayPal Login Email Address Po Problems logging in PayPal Password Pp 7 Forget your password 44 May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons How Buy Now and Donations Work Step 4 To pay for his purchase or donation Bob is prompted to add a credit card email address and password which creates his new PayPal account Payments by REAR Billing Information Select Your Country Select the country where you live then click Select Country Choose a Country Select Credit Card Information Please enter the information on your credit card First Name O Last Name o Card Type Select Card Type Credit Card Number IO Expiration Date for 7 2003 7 Address 1 lS Address 2 SC rt optional Cito PA State zip Code So 9 digits Country United States Home Telephone Enter country code first We will email you a receipt You can use this email address and password to log in to PayPal and view more details about your payment Email Address Your passw
55. Downloadable Logs aaoo a 56 Instant Payment Notification IPN 2 0 o eo 57 Chapter 6 Creating Shopping Cart Buttons 59 How lt Works 59 What Your Customer Sees e 59 What You Se ee 64 PayPal Shopping Cart Button Factory 22 2 20 222004 64 Getting Started a 65 Creating Your Shopping Cart Button 0 e e o 65 How You Get YourMoney 2 deda a iia raea 68 Notifications You Receive 2 2 68 Boe e di eh bab waned ee eb add e bach ded Bare 3 68 A O cease eaten ee E E E E A E E E 69 Downloadable Logs a 69 Instant Payment Notification IPN aaa o 69 Chapter 7 Adding PayPal to Your Third party Shopping Cart 71 Passing the Aggregate Shopping Cart Amount to PayPal 71 Passing Individual Items to PayPal o 71 Chapter8 Custom Payment Pages 73 May 2005 Merchant User Manual and Integration Guide Contents ion Examples of Custom Payment Pages a aoaaa aa e 73 Getting Started 4 da 4 bse ba pbs baa hd eed SE Ae Ee EA ee He 75 Adding a Page Style 2 a 76 Editing a Page Style 2 ee 77 Previewing a Page Style e 78 Making a Page Style Primary o e 79 Removing a Page Style o 79 Overriding Page Style Settings 0 0000 2 e o 79 Background Colors and Error Mes
56. E C 1 ISO 3166 Two Character Country Codes Country Code Israel IL Italy IT Jamaica JM Japan JP Luxembourg LU Malaysia MY Mexico MX Monaco MC Netherlands NL New Zealand NZ Norway NO Portugal PT Singapore SG South Korea KR Spain ES Sweden SE Switzerland CH Thailand TH Taiwan TW Turkey TR United Kingdom GB United States US Uruguay UY Venezuela VE 164 May 2005
57. ENTE Merchant User Manual and Integration Guide Last Updated May 2005 Merchant User Manual and Integration Guide 2005 PayPal Inc All rights reserved PayPal and the PayPal logo are registered trademarks of PayPal 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 2005 PayPal Inc All rights reserved PayPal and the PayPal logo are registered trademarks of PayPal 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 May 2005 Merchant User Manual and Integration Guide Preface Chapter Chapter Chapter Contents 1 Introduction PayPal Supported Currencies a Additional Information 2 PayPal Payments Overview PayPal Account Optional Buy Now and Donations Buttons o Shopping Cart 222022005 Custom PaymentPages 0 Calculating Shipping Handling and Tax Contact Telephone Number 20084 Auto Ret
58. Manual and Integration Guide IPN and PDT Variables IPN and PDT variables are case sensitive All values are lowercase except those for payment status which have an initial capital letter Data Type IPN posts contain only alphanumeric characters Maximum Field Lengths The maximum field length for each returned field is 127 characters with the exception ofthe custom and memo fields which have a maximum length of 255 characters The unique PayPal Transaction ID is 17 characters long URL Encoding Values posted by IPN are URL encoded For example the colon in http is translated to 3A in the IPN post About These Tables of Variables The tables in this appendix group IPN variables by different characteristics e IPN Variables in All Posts on page 146 e Buyer Information on page 146 e Advanced and Custom Information on page 148 e Shopping Cart Information on page 148 e Currency and Currency Exchange on page 152 Auctions on page 153 e Mass Payment on page 154 e Dispute Notification Variables on page 160 e Dispute Notification Variables on page 160 e PDT Specific Variables on page 162 Transaction Specifc Variable Values Unless otherwise indicated in the table column labeled Possible Values the value of an IPN or PDT variable is always specific to the transaction whose information is being posted test_ipn Variable in Sandbox In the Sandbox environ
59. No your customers will not be given the opportunity to include a note Note Title If you are allowing your customers to include a note with their payments you may choose a title for the note field By including a title you can prompt your buyers to enter specific information like a User ID or special instructions There is a 40 character limit on your note field title If you do not enter a title your customers will see Special Instructions optional as the note field title Step 10 Choose an email address to receive payment If you have more than one confirmed email address added to your PayPal account you can specify the address at which you would like to receive your email payment notifications when your customers pay you Step 11 Copy and paste the HTML code When you have finished filling out the Buy Now Button Factory form click Create Button Now If your customers will be making purchases through your website Copy the code from the For Web Pages text box by highlighting all of the text and pressing Ctrl C or by highlighting all of the text right clicking your mouse and choosing Copy In your website files open the code for the Web page from which you wish to collect payment Paste the code you just copied into your Web page file wherever you would like the image to appear typically next to the description of the item or service by either pressing Ctrl V or by right clicking on your mouse and selecting the Paste opt
60. NoTE If you enable button encryption you will not be able to create an email link Creating a Donations Button Step 1 Enter the details for your donations NoTE All fields are optional Donation Name Service Enter the reason for payment or the name of your organization charity here If you do not enter anything in this field your donors may complete this field Donation ID Number You may use this field to differentiate payments e g to enter a campaign name This field will not be displayed to your donors at the time of payment but they will see it in their transaction details on the PayPal website Donation Amount If you would like to collect a pre determined amount you may enter it in the Donation Amount field If you would like your donors to determine their donation amounts do not enter a price in this field Users will be prompted to enter a donation amount when they make payment Norte If you leave the Donations Amount field blank your donors can choose the amounts of their donations Currency Choose the currency in which you would like this payment to be denominated This field will default to the currency of your primary balance Step 2 Choose a Donations button to put on your website Choose the image for the button you would like your donors to click to make their purchase To display your own image enter the URL of the image s location in the URL field If you are also creating an email link co
61. Number optional required or turn it off Off 1s the recommended default option because buyers value their privacy and prefer to keep unsolicited communications to a minimum What You See Step 1 You can select the option you want to use to activate the Contact Telephone Number feature If you do not want to request a contact telephone number from your buyer you can select the Off radio button You will see the following on the Website Payment Preferences page Contact Telephone Number When you activate this option your customers will be asked to include a Contact Telephone Number with their payment information Learn more Note Selecting On Required Field could have a negative effect on buyer conversion Contact Telephone on Optional Field O On Required Field O off PayPal recommends this option Step 2 On the Transaction Details page you will see the buyer s contact telephone number Contact Telephone 208 721 5404 Payment Type Instant Tracking Information Provide your buyer with tracking and order status information Learn More Merchant User Manual and Integration Guide May 2005 87 MX Creating Customer Contact Telephone Getting Started What Your Customer Sees Step 3 When you require the buyer s contact telephone number your buyer will see the information below Contact Telephone Information Your seller has requested a Contact Telephone Number in the event you need to be contacted regarding your
62. PDT Specific Variables 0 o ee 162 ISO 3166 Two Character Country Codes 163 Merchant User Manual and Integration Guide May 2005 11 a List of Tables 12 May 2005 Merchant User Manual and Integration Guide List of Figures Figure 2 1 PayPal Payment Flows 2 26 Figure 3 1 Business Account Sign up we ee ee ee ee 27 Figure 3 2 Confirming Your Email Address 4 4 28 Figure 3 3 Adding a Bank Account 28 Figure 3 4 Merchant Profile Page 4 30 Figure 3 5 Payment Receiving Preferences Cb me eee ao BL Figure 8 1 Payment Page in Standard PayPal Page les ha ES tara ath O Figure 8 2 Payment Page with Custom Style Header Image and Header Border 74 Figure 8 3 Payment Page with Custom Style Header Image Image Border and Background Color 75 Figure 8 4 Editing Page Style Settings 4 4 77 Figure 8 5 Example of Unallowed Background Color 81 Figure 8 6 Example of Allowable Background Color 82 Figure 14 1 Profile Seller Preferences for Language Encoding 116 Figure 14 2 Language Encoding Settings Basic Choices 117 Figure 14 3 Website Language Preference 118 Figure 14 4 More Language Encoding Options 119 Merchant User Manual and Integration Guide May 2005 a List of Figures 14 May 2005 Merchant User Manual and
63. Shipping Handling and Tax Merchant User Manual and Integration Guide May 2005 65 az Creating Shopping Cart Buttons PayPal Shopping Cart Button Factory If you have already specified your tax rate from your Profile it will be listed under Sales Tax Calculation For more information about calculating tax see Chapter 9 Calculating Shipping Handling and Tax Step 4 Add option fields to your button Let your customers specify information about their purchases by creating an option field You can use option fields to specify information such as color size or gift wrapping Options must not change the price of an item but will let you collect additional information from your customer without extra email communication Each Shopping Cart Button may have up to two option fields and you may use a drop down menu or a text box to collect the information Option Field Type Choose the type of option field drop down menu or text box If you choose drop down menu you will enter the different choices If you choose text box your customer will enter his choice Option Name Enter the name of your option There is a 60 character limit on option names Drop Down Menu Choices If you are using a drop down menu enter your menu choices There is a 30 character limit per choice with a maximum of 10 choices Use a carriage return press Enter to separate each choice Step 5 Select a View Cart button Choose the image f
64. abetic characters only 2 language Available languages are US English UK English German and Japanese night _ The area code for U S phone numbers or Numeric characters only 3 phone a the country code for non U S phone numbers This will prepopulate the buyer s home phone number Merchant User Manual and Integration Guide May 2005 141 142 HTML Samples Prepopulating Your Customer s PayPal Sign Up TABLE A 5 Prepopulation Variables for Website Payments Character Variable Value Requirements Limit night_ The 3 digit prefix for U S phone Numeric characters only 3 phone b numbers or the entire phone number for non U S phone numbers excluding country code This will prepopulate the buyer s home phone number night The 4 digit phone number for U S phone Numeric characters only 3 phone c numbers This will prepopulate the buyer s home phone number Prepopulation for Account Signup TABLE A 6 Prepopulation Variables for Account Signup Character Variable Value Requirements Limit action cmd _ext enter redirect_ _registration run cmd first name Alphanumeric 128 last name Alphanumeric 128 address1 Alphanumeric 128 address2 Alphanumeric 128 city Alphanumeric 128 state alphabetic 2 zip Numeric 5 email Alphanumeric 127 business Alphanumeric 128 address1 business _ Alphanumeric 128 address2 business Alphanumeric 128 city May 2005 Merchant User Manual and Integration Guide HTML S
65. ables Shopping Cart Information TABLE B 3 IPN and PDT Variables Shopping Cart Information Variable Name Possible Values Description payment _ Canceled Canceled Reversal This means a reversal has been canceled For status Reversal example you won a dispute with the customer and the funds for the Completed transaction that was reversed have been returned to you Denied Completed The payment has been completed and the funds have been added Failed successfully to your account balance Pending Denied You denied the payment This happens only if the payment was Refunded previously pending because of possible reasons described for the Reversed PendingReason element Processed Failed The payment has failed This happens only if the payment was made from your customer s bank account Pending The payment is pending See PendingReason for more information Refunded You refunded the payment Reversed A payment was reversed due to a chargeback or other type of reversal The funds have been removed from your account balance and returned to the buyer The reason for the reversal is specified in the reason_code variable Processed A payment has been accepted 150 May 2005 Merchant User Manual and Integration Guide IPN and PDT Variables EEN Shopping Cart Information TABLE B 3 IPN and PDT Variables Shopping Cart Information Variable Name Possible Values Description pending address This variable is set only if paym
66. accepting subscription payments Changing your preferences may affect these payments Block payments from U S users who do not provide a Confirmed Address Yes No C Ask Me Block payments if they are sent to me in a currency that I do not hold Yes No accept them and convert them to U S Dollars Ask Me Block Payments from users who FP Have non U S PayPal accounts Do not have credit cards on file Subscription payments only I Initiate payments from the Send Money tab If checked you may enter an Alternate Payment URL for your buyers Alternate Payment URL optional IP a Block Payments funded by I Credit card when the sender has a bank account I eCheck for PayPal Website Payments and Auction Logo payments The Credit Card Statement Name is the name that will appear on your customers credit card statements The name can only be 11 alpha numeric characters in length including spaces Credit Card Statement ALiCES USED HB Name cara Blocking Payments From U S Users Without a Confirmed Address This preference allows you to better manage your risk by screening out payments where the buyer chooses not to share his Confirmed Address with you PayPal provides Confirmed Merchant User Manual and Integration Guide May 2005 31 32 Getting Started Managing Your PayPal Merchant Account Addresses to help you make informed decisions when shipping goods To be eligible for PayPal s Seller Prote
67. account using the PayPal Account Optional feature View various product flows to better visualize your end product Review recommended solutions and best practices The Merchant User Manual and Integration Guide includes information about and instructions for using the following features Buy Now Buttons Donations Buttons Shopping Cart Buttons PayPal Account Optional Custom Payment Pages Instant Payment Notification Payment Data Transfer Multi User Access Shipping Handling and Tax Auto Return Merchant User Manual and Integration Guide May 2005 19 fl Introduction PayPal Supported Currencies PayPal Supported Curren cies The following currencies are supported by PayPal TABLE 1 1 PayPal Supported Currencies Currency Codes and Maximum Transation Amounts Maximum Transaction Code Currency Amount AUD Australian Dollar 12 500 AUD CAD Canadian Dollar 12 500 CAD EUR Euro 8 000 EUR GBP Pound Sterling 5 500 GBP JPY Japanese Yen 1 000 000 JPY USD U S Dollar 10 000 USD Additional Information The following table lists URLs you can consult for more information about PayPal Norte In most cases you must log in to PayPal to see this additional information TABLE 1 2 Additional Information Information Fees Onlines Security User Agreement and Policies Online Help Customer Service URL https www paypal com fees https www paypal com security https www paypal com
68. acknowledge that I have read and agree to PayPal s User Agreement Click Continue only once It will take an average of 60 seconds for your information to be submitted Continue Merchant User Manual and Integration Guide May 2005 61 Creating Shopping Cart Buttons How It Works Step 6 Bob is taken to a Confirmation page containing the details of his payment Because Alice has activated her Shipping Preferences the shipping costs are automatically added to Bob s order He clicks Pay to complete the payment Confirm Your Payment Check the following details and click the Pay button below to complete your payment Pay To Alice s Used Books User Status Verified Business Member 0 Payment For Shopping Cart Currency U S Dollars Ed Amount 35 00 Shipping amp Handling 2 00 Total Amount 37 00 PayPal Shopping Cart Contents Qty Item Options Price Herodotus The History Gift Wrap Yes E HIS 0001 15 00 Homer The Iliad amp The Odyssey 1 HIS 0125 20 00 Amount 35 00 Source of Funds Credit Card 37 00 from MasterCard XXXX XXXX XXXX 0439 More Funding Options Shipping Information Ship to 10245 SW Arborcrest Way Portland OR 97225 USA Confirmed Add Address No shipping address required Pay Cancel 62 May 2005 Merchant User Manual and Integration Guide Creating Shopping Cart Buttons How It Works Step 7 Bob is taken to a Confirmation page where he sees the details of hi
69. act Information Enter the contact information for the owner of this business If you are 3 the owner or contact person for this business enter your information First Name Last Name Work Telephone la Business Owner Address Leave this section empty if your business owner s address and company address are 57 the same Address 1 Address 2 22222 optional City State v elpt 5 or 9 digits Country U S A Step 2 Confirm Email Address After completing the two page signup PayPal will send you an email to confirm your email address Open your email and click the link in the email we sent you You will be taken to a PayPal page and asked to enter your password as shown in the following diagram Once you have successfully entered your password your email address will be confirmed IMPORTANT PayPal representatives will never ask you for your password and will never ask you to enter your password or financial information in an email or send such information in an email Ifyou believe someone has learned your password please change it immediately and contact PayPal customer service as soon as possible Merchant User Manual and Integration Guide May 2005 27 28 Getting Started FIGURE 3 2 Confirming Your Email Address Welcome Send Money Request Money Merchant Tools Auction Tools Enter Password Secure Transaction Y Please enter your PayPal password to confirm your email address Password Forget y
70. ail 1 Click the Profile subtab of the My Account tab 2 Click the Notifications link from the left hand menu 3 Find the Payment Notifications heading and clear the I receive PayPal Website Payments and Instant Purchase checkbox 4 Click Save Y our transaction history log History contains information about your payments Each payment will have one of these options as its status e Completed The transaction was successful and the money was credited to your account e Cleared The eCheck payment has cleared the sender s account and has been credited to your account e Uncleared The eCheck payment has not cleared the sender s account yet Downloadable Logs Log in to your PayPal account go to the History subtab of the My Account tab and choose the Download My History link in the Quick Links menu Click the All Activity radio button or enter the dates of the entries you want to download choose the type of file you would like to download Comma delimited Tab delimited Quicken or QuickBooks and click Download My History The downloaded file will contain a record of all of your payments May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons po Notifications You Receive Instant Payment Notification IPN If you have Instant Payment Notification activated you will receive an IPN when a payment is first sent which will state the status of the payment Completed or Pending I
71. amples ES Prepopulating Your Customer s PayPal Sign Up TABLE A 6 Prepopulation Variables for Account Signup Character Variable Value Requirements Limit business Alphanumeric 2 state business _ Numeric 5 zip business _ Alphabetic 2 country business Alphanumeric 128 cs email business cs Numeric 3 _ phone a business _ Numeric 3 cs phone b business Numeric 4 cs phone c business _ Alphanumeric 128 url business _ The area code for U S phone numbers or Numeric 3 night phone the country code for non U S phone a numbers This will prepopulate the buyer s home phone number business _ The 3 digit prefix for U S phone Numeric 3 night phone numbers or the entire phone number for _b non U S phone numbers excluding country code This will prepopulate the buyer s home phone number business _ The 4 digit phone number for U S phone Numeric 4 night phone numbers This will prepopulate the Cc buyer s home phone number Sample HTML The following sample HTML shows how the optional pre population fields would be included in your payment buttons The field entries would need to be dynamically generated by your website and included in the URL to which your customers are sent when they try to make a PayPal payment lt form action https www paypal com cgi bin webscr method POST gt lt input type hidden name cmd value ext enter gt lt input type hidden name redirect cmd value _xclick
72. any subsequent updates to that payment e g cleared eCheck will be sent to that notify url When you pass a notify url in your HTML code it will override any preferences you set in your Profile Using IPN with Multiple Currencies With multiple currencies you can accept payments in anyt of the PayPal supported currencies see PayPal Supported Currencies on page 20 As a result your IPNs will then include information about the currency of the payment The following overview explains how IPN interacts with multiple currencies Norte If you are using one of PayPal s Website Payments solutions e g PayPal Shopping Cart and would like to be paid in a currency other than U S Dollars you will need to set up your buttons for your currency of choice payment_gross and payment_fee These variables reflect the amount received and corresponding fee of U S Dollar USD payments If the amount received and fee deducted are in a currency other than USD the variables will still appear in your IPN but will have no values in them NOTE payment fee is not always present in IPNs such as when a payment is pending Merchant User Manual and Integration Guide May 2005 107 108 Backend Integration Payment Notifications Processing Refunds These values are absent for non USD payments so that IPN scripts will not process these amounts as USD However legacy IPN scripts will continue to work as before as long as the merchant only receive
73. ations Shopping Cart and Subscriptions How Auto Return Works This example shows the Auto Return flow with Custom Payment Pages but without the PayPal Account Optional feature Bob is going to purchase a widget from the Widget Warehouse Step 1 Bob goes to the Widget Warehouse website finds the widget he wants and clicks Buy Now al i Global Industries Inc Widget Warehouse Wooden Widgets Rubber Widgets Widget 019983763 Aluminum Widgets The surprisingly compact Widget z 019983763 is a powerful Steel Widgets no compromise solution for Outdoor Widgets widget professionals who are on e road and ey NA e office but who never want to be Automotive widgets without the speed and power of Plastic Widgets an automotive widget It slices dices and it will even make bread Titanium Widgets Sale Price 142 50 Global Industries Inc All rights reserved 2003 Merchant User Manual and Integration Guide May 2005 90 Auto Return How Auto Return Works Step 2 Bob is taken to a PayPal Payment Details page which displays the details of the payment he is about to make Payments by AJARI o Global Industries Inc Iss ndustis Widget Warehouse Secure Transaction E Payment Details PayPal is the secure payment processor for your seller To continue PRIVACY please enter the required information below BBBOnLine Pay To Widget Warehouse Payment For Widget Currency U S Dollar
74. ayPal an eBay company Copyright 1999 2004 PayPal All rights reserved Information about FDIC pass through insurance Click Save to save your selection or Cancel to to leave the setting unchanged 118 May 2005 Merchant User Manual and Integration Guide Language Encoding for Your Data CE Changing Your Language Encoding More Encoding Options If you know and want to specify the exact standard name of your website s character encoding click More Options on the Language Encoding page to open the More Encoding Options page shown in More Language Encoding Options on page 119 The More Encoding Options page allows you to specify the character encoding should expect from your website and the encoding of data PayPal sends to your website FIGURE 14 4More Language Encoding Options REMET Log Out Help My Account Send Money Request Money Merchant Tools Auction Tools Overview Add Funds Withdraw History Resolution Center Profile More Encoding Options Use the following drop down menu to select the encoding used on your website Encoding Do you want to use the same encoding for data sent from PayPal to you e g IPN downloadable logs emails Yes No use windows 1252 y For more information on adding multiple languages to your website payment buttons or IPN please refer to the Integration Guide cars The encoding selection in the Encoding
75. ayPal Sign Up If you have already collected your customer s information you can pass this information to PayPal to prepopulate the first page of a new customer s sign up The fields and parameters are listed in the following table You can pass all or none of this data as necessary While your customer s sign up page will be prepopulated it will still be editable To pass this information to the PayPal payment pages post the variable name and the associated data to PayPal in the HTML in the form of variable name value You will also need to change your cmd value to_ ext enter and add a new variable redirect cmd whose value should be _xclick For more examples please to the following sample code Prepopulation for Website Payments Buttons TABLE A 5 Prepopulation Variables for Website Payments Character Variable Value Requirements Limit email Customer s email address Alphanumeric characters only 127 first name First name Alpha characters only 32 last_name Last name Alpha characters only 64 address1l Street 1 of 2 fields Alphanumeric characters only 100 address2 Street 2 of 2 fields Alphanumeric characters only 100 city City Alphanumeric characters only 40 state State Must be 2 character official 32 abbreviation zip Zip Numeric characters only 32 country Sets shipping and billing country Please Alphabetic characters only 2 to Appendix C for acceptable country codes le Defines the buyer s checkout flow Alph
76. ayment Data Transfer you must turn on Auto Return Payment Data C On Transfer off Identity Token ime8Wn6 ZISil9BdnDY4g570zrgYomzimewyXqrwba45qFj1h8eiR3cUFhe For security reasons the identity token will not be sent to you however once you have enabled PDT it will permanently appear below the Payment Data Transfer On Off radio buttons on the Website Payments Preferences page May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications Payment Data Transfer PDT and PayPal Account Optional Feature The PayPal Account Optional no longer requires your customers who are new to PayPal to create a PayPal account to complete a purchase they will go through an alternate checkout and will have the option to sign up afterward Customers who already have PayPal accounts will continue to enjoy the privileges of those accounts such as payment history and integration with eBay Auctions and their checkout experience will remain the same This PayPal Account Optional feature is available for Buy Now Donations and Shopping Cart buttons but not for Subscription buttons The PayPal Account Optional feature is enabled by default Ifthe merchant has turned on Payment Data Transfer and has not disabled PayPal Account Optional a new user will not be automatically directed back to the merchant website but will be given the option to return When the buyer clicks Continue the transaction ID associated with t
77. ayment Details Secure Transaction E PayPal is the authorized payment processor for Globe Industries PRIVACY PRA Pay To Globe Industries Payment For Steel Widget Currency U S Dollars El Amount 15 00 USD PayPal Login Welcome Back Email Address Problems logging in PayPal Password Forget your password Continue Merchant User Manual and Integration Guide May 2005 73 az Custom Payment Pages Examples of Custom Payment Pages Figure 8 2 Payment Page with Custom Style Header Image and Header Border shows a custom header image and header border color FIGURE 8 2 Payment Page with Custom Style Header Image and Header Border ravments by PEAR Globe A Payment Details Secure Transaction Ej PayPal is the authorized payment processor for Globe Industries PRIVACY PERA Pay To Globe Industries Payment For Steel Widget Currency U S Dollars E Amount 15 00 USD PayPal Login Welcome Back Email Address Problems logging in PayPal Password Forget your password Continue 74 May 2005 Merchant User Manual and Integration Guide Custom Payment Pages E Getting Started Figure 8 3 Payment Page with Custom Style Header Image Image Border and Background Color shows a custom header image header border color and page background color FIGURE 8 3 Payment Page with Custom Style Header Image Image Border and Background Color Globe Getting Started pu
78. bits that have affected your account balance each month e Merchant Sales Reports Every week receive valuable analysis of revenue by sales channel and currency Merchant User Manual and Integration Guide May 2005 95 96 Backend Integration Payment Notifications Payment Data Transfer e History Log View an online record of your received and sent payments e Downloadable Logs Keep track of your transaction history by downloading it into various file formats suitable for financial settlements For more information about PayPal s reports see http www paypal com cgi bin webscr cmd p xcl rec reports intro outside Instant Payment Notification IPN and Payment Data Transfer PDT PDT s primary function is to display payment transaction details to buyers when they are automatically redirected back to your site upon payment completion however there are cases where you will not receive notification of all transactions such as with pending transactions refunds and reversals For these reasons or if you are using this data to fulfill orders PayPal strongly recommends that you also enable Instant Payment Notification IPN Both IPN and PDT send back the same data however there are several important differences PDT e Requires Auto Return to be enabled e Auto Return will include an ID that can be used to query PayPal for the complete transaction details e Itis possible to miss a notification if the user closes
79. box by highlighting all of the text and pressing Ctrl C or by highlighting all of the text right clicking your mouse and choosing Copy Open the Web page file into which you d like to add your Shopping Cart Button Paste the code you just copied into your Web page file wherever you would like the button to appear typically next to the description of the item or service by either pressing Ctrl V or by right clicking on your mouse and choosing Paste Note HTML Tip Please ensure that the HTML code on your Web page exactly matches the code you copied from PayPal Some HTML editors may add delete or change some characters in your code If this is the case please change the code on your Web page to exactly match the code you copied You can copy the code into a new Notepad document reselect all of the code copy then paste it into your Web editor Please be sure that when you paste the HTML code for your button you are pasting this information into a field that accepts HTML code If you paste this code into a standard text field the code will be posted to your Web page as text Step 12 Create Add to Cart buttons for all of your items Click Create Another Button to create more Add to Cart buttons following the previous Steps 1 5 Once you have created Add to Cart buttons for all of the items you are selling proceed to Step 13 Step 13 Copy the View Cart button HTML code Now that you have placed your Add to Cart buttons on your
80. button This field specifies the URL of a script that can process the IPN For a complete list of IPN fields variables and sample code see IPN and PDT Variables on page 145 Code samples for the following development environments is also available on the PayPal website at http www paypal com cgi bin webscr cmd p xcl rec ipn code outside e ASP Net C e ASP VBScript e Cold Fusion e Java JSP e PERL e PHP Notification Validation Once your server has received the Instant Payment Notification you will need to confirm it by constructing an HTTP POST to PayPal Your POST should be sent to https www paypal com cgi bin webscr This post back of the IPN data to a secure PayPal URL i e https prevents spoofing so you can be sure that the IPN came from PayPal NoTE It is possible to implement IPN without SSL 1 e http but then the IPN data that is received and posted back is not secure You must post all of the form variables you received exactly as you received them You will also need to append a variable named cmd with the value _notify validate e g cmd notify validate to the POST string PayPal will respond to the post with a single word VERIFIED or INVALID in the body of the response When you receive a VERIFIED response perform the following checks May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications Instant Payment Notification IPN
81. cause profile tax may apply to other items in the cart the sum of tax x might not total to tax PayPal appends the number of the item e g option namel option name2 where x represents the number of the shopping cart detail item PayPal appends the number of the item e g option_selectionl option selection2 where x represents the number of the shopping cart detail item PayPal appends the number of the item e g option name2 option name2 where x represents the number of the shopping cart detail item PayPal appends the number of the item e g option selectionl option selection2 where x represents the number of the shopping cart detail item The amount is in the currency of mc_currency where x is the shopping cart detail item number The sum of mc_gross_x should total mc_gross The is the shopping cart detail item number The handling cart cart wide Website Payments variable is also included in the mc_handling variable for this reason the sum of mc_handling_x might not be equal to mc_handling This is the combined total of shipping and shipping2 WebsitePayments variables where x is the shopping cart detail item number The shippingx variable is only shown when the merchant applies a shipping amount for a specific item Because profile shipping might apply the sum of shippingx might not be equal to shipping Merchant User Manual and Integration Guide May 2005 149 NENE IPN and PDT Vari
82. ccounts such as Seller and multiple Buyer accounts to simulate different scenarios unconfirmed verified international and so on Merchant User Manual and Integration Guide May 2005 121 122 Testing Your PayPal Button Your PayPal Button Now that you have the HTML code in your website or in your email you should test it Click the link in the email or click the button on your Web page A PayPal hosted payment page should appear with payment details you specified Because your PayPal user information is saved in a cookie on your computer you will see your own PayPal username Your customers will not see your username Instead e If your customer is already a PayPal member he will see his PayPal username here e If your customer is not yet a PayPal member he will see a sign up page To view this from your computer click the link that says something like If you are not Bob Smith Click Here After testing in the Sandbox PayPal recommends testing your button implementation with the live PayPal system Here s an easy way to do it 1 Sign up for a Personal PayPal account if you don t already have one and add a credit card to the account This will be your buyer account Note According to the PayPal User Agreement you may have both one Personal and one Premier Business account Please do not set up any additional PayPal accounts as this may result in your account access being limited 2 Make sure t
83. ction Policy and to help reduce your risk of dealing with fraudulent buyers ship to a buyer s Confirmed Address There are three choices for this preference e Yes All payments from U S buyers without a Confirmed Address will be blocked All U S buyers will be required to provide a Confirmed Address in order to pay you e No All payments will be accepted To maximize your sales select No e Ask Me You may choose whether to accept or deny payment without a Confirmed Address on a case by case basis This option allows you the flexibility to decide whether you want to take on the risk of not having the buyer s Confirmed Address for each transaction If you accept the payment it becomes a completed transaction If you deny a particular payment the sender of the payment will be notified that the payment has been denied and will be credited with the payment amount PayPal does not charge fees for denied payments Blocking Payments in a Currency You Do Not Hold You can use your PayPal account to accept payments in U S Dollars Canadian Dollars Euros Pounds Sterling and Yen When you receive a payment in a currency you do not hold PayPal will prompt you to open a balance for that currency convert it to your primary balance or deny the payment Payments in currencies for which you hold a balance will automatically be applied to the correct balance and you will see a summary of each currency balance in your Account Overview page
84. ctions For example On the Profile page click Email to confirm your email address Merchant User Manual and Integration Guide May 2005 15 a Preface 16 Typeface How Used San serif Placeholders used in the context of a format or programming standard or formal oblique 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 X is the name of the variable for a multi item shopping cart amount _ 3 is the item amount for the third item in a multiple item shopping cart 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 Hypertext link to a page in the current document or to another document in the set XXXXXX Hypertext link to a URL or that initiates a web action such as sending mail Documentation Problems If you discover any errors in or have any problems with this documentation please e mail us by following the instructions below Describe the error or problem as completely 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 Click Help in th
85. ctions at the top of the screen PayPal Login Email Address Problems logging in PayPal Password Forget your password 60 May 2005 Merchant User Manual and Integration Guide Creating Shopping Cart Buttons How It Works Step 5 Bob is then prompted to enter his credit card information email address and password creating his new PayPal account Note Existing PayPal users log in to their accounts directly and skip Step 5 Select Your Country Select the country where you live then click Select Country Choose a Country Select Credit Card Information Please enter the information on your credit card First Name Last Name Card Type y Select Card Type Credit Card Number Expiration Date jor 7 2003 Address 1 Address 2 optional City no State a Zip Code s or 9 digits Country United States Home Telephone Enter country code first We will email you a receipt You can use this email address and password to log in to PayPal and view more details about your payment Email Address Your password should be 8 characters minimum and is case sensitive Write it down Create PayPal l Password Confirm PayPal l Password Security Measure Enter the characters as they are shown in the box below This will further increase the security of your account and the PayPal network This is not your password Help KN NG IN LIS OND By clicking Continue I
86. cy of the payment For non payment subscription IPNs this is the currency of the subscription This is the total handling amount associated with the transaction If this is a shopping cart transaction to the Shopping Cart Information section for more information This is the total shipping amount associated with the transaction If this is a shopping cart transaction see also Shopping Cart Information on page 148 for more information May 2005 Merchant User Manual and Integration Guide IPN and PDT Variables Boo Auctions TABLE B 4 IPN and PDT Variables Currency and Currency Exchange Information Variable Name Possible Values Description settle_ Amount that is deposited into the account s primary balance after a currency amount conversion from automatic conversion through your Payment Receiving Preferences or manual conversion through manually accepting a payment settle_ Currency of settle amount currency exchange _ Exchange rate used if a currency conversion occurred rate payment _ Transaction Full USD amount of the customer s payment before transaction fee is gross specific for subtracted Will be empty for non USD payments This is a legacy field USD payments replaced by mc_gross If this amount is negative it signifies a refund or only reversal and either of those payment statuses can be for the full or partial amount of the original transaction payment fee Transaction USD transaction fee a
87. drop down menu is based on the country of origin you specified at sign up To change the encoding selection click the Encoding drop down menu and select one of the available encodings For a complete list of supported encodings see Table 14 1 Character Sets and Encodings Supported by PayPal on page 120 For data that PayPal should send to you you have the option to specify the same or a different encoding To use the same encoding as your website click the Yes radio button To use a Merchant User Manual and Integration Guide May 2005 119 120 Language Encoding for Your Data Setting Language in Website Payments charset different encoding click the No use radio button and select the desired encoding from the associated drop down menu TABLE 14 1 Character Sets and Encodings Supported by PayPal Big5 Traditional Chinese in Taiwan EUC JP EUC KR EUC TW gb2312 Simplified Chinese gbk HZ GB 2312 Traditional Chinese in Hong Kong ibm 862 Hebrew with European characters ISO 2022 CN ISO 2022 JP ISO 2022 KR ISO 8859 1 Western European Languages ISO 8859 2 ISO 8859 3 ISO 8859 4 ISO 8859 5 ISO 8859 6 ISO 8859 7 ISO 8859 8 ISO 8859 9 ISO 8859 13 ISO 8859 15 KOI8 R Cyrillic Shift_JIS UTF 7 UTF 8 UTF 16 UTF 16BE UTF 16LE UTF16_ Platform Endian UTF16_Opposit eEndian TF 32 TF 32BE TF 32LE TF32 Platform Endian UTF32_Opposit eEndian U U U U US ASCII windows 1250
88. e A 5 Table A 6 Table 17 1 Table B 1 Table B 2 Table B 3 Table B 4 Table B 5 Table B 6 Table B 7 Table B 8 Table B 9 Table B 10 Table C 1 List of Tables PayPal Supported Currencies Currency Codes and Maximum Transation Amounts 20 Additional Information 2 o e 20 Order of Customization Variables 80 Character Sets and Encodings Supported by PayPal 120 HTML and Hyperlink Variables for Buy Now and Donations Buttons 133 Shopping Cart Variables 0 00004 138 Third Party Shopping Cart Variables 138 Variables for Individual Items in Third Party Shopping Carts 139 Prepopulation Variables for Website Payments 141 Prepopulation Variables for Account Signup 142 IPN and PDT Variables Buyer Information 146 IPN and PDT Variables Basic Information 147 IPN and PDT Variables Advanced and Custom Information 148 IPN and PDT Variables Shopping Cart Information 148 IPN and PDT Variables Currency and Currency Exchange Information 152 IPN and PDT Variables Auctions 2 153 IPN and PDT Variables Mass Pay 04 154 Subscriptions Variables 2 0 0 0 156 IPN Variables with Each Subscription Event 158 Dispute Notification Variables o 160
89. e Style To edit a page style FIGURE 8 4 Editing Page Style Settings RayPal j Log Out Help Merchant Tools Auction Tools My Account Send Money Request Money Overview Add Funds Withdraw History Resolution Center Profile Edit Custom Page Style Back to Profile Summary Customize PayPal s payment pages to match the style of your website Learn more Page Style Name Please choose a name containing up to 30 characters and no spaces Page Style Name l Header Image URL Please specify an image that is a maximum size of 750 pixels wide by 90 pixels high Larger images will be cut to this size The image you choose will appear at the top left of the payment page We recommend providing an image only if it is stored on a secure https server Header Image URL Header Background Color Please enter the background color for the header using HTML hex code Header Background Color Header Border Color Please enter the border color for the header using HTML hex code The border will be a 2 pixel perimeter around the header space which is 750 pixels wide by 90 pixels high Header Border Color Payment Flow Background Color Please enter the background color for the payment pages using HTML hex code Certain colors are not allowed Background Color L Save Preview Cancel Mobile Mass Pay Money Market ATM Debit Card BillPay Referrals About Us Accounts Fees Privacy
90. e items through your own website The Buy Now and Donations Buttons feature can be implemented in minutes giving you easy access to business from PayPal s millions of members and any other buyer on the Web Because using Buy Now and Donations Buttons to send and receive payments is secure both you and your customers remain protected PayPal automatically encrypts your confidential information using the Secure Sockets Layer SSL protocol with an encryption key length of 128 bits the highest level commercially available Your customers will not need to share their private financial information e g credit card or bank account numbers during the transaction so they can complete payment while retaining security However using button encryption does impose some limitations and therefore PayPal does offer both encrypted and unencrypted button options The flexibility of our Buy Now Buttons feature will keep your website working for you You can accept payments from current PayPal members as well as people who have just signed up for our service and you won t lose your customers after they have made a purchase the payment process lets you return buyers to your website not lose them to ours Merchant User Manual and Integration Guide May 2005 21 22 PayPal Payments Overview Shopping Cart Benefits of Buy Now and Donations Buttons include e Easy to implement no CGI scripting necessary e Noup front costs you ll have the sa
91. e upper left corner of the page Click Contact Us in the lower left of the page Chose Help by Email a 91 Complete the form To contact Developer Technical Support about documentation problems 1 Log in to your account at https developer paypal com by entering your email address and password in the Member Log In box 2 Click Help Center at the bottom of the box on the right side of the page 3 Click Email PayPal Technical Support 4 Complete the form May 2005 Merchant User Manual and Integration Guide Preface E Merchant User Manual and Integration Guide May 2005 17 EN Preface 18 May 2005 Merchant User Manual and Integration Guide Introduction The Merchant User Manual and Integration Guide provides information about the majority of PayPal s features and instructions for using these features to meet your online payment needs Use the Merchant User Manual and Integration Guide to Quickly and easily set up eCommerce functionality with PayPal For example learn how to integrate PayPal into your website in minutes with the PayPal Shopping Cart or Buy Now buttons Learn more advanced techniques and tools to get the most out of the PayPal products For example set up Instant Payment Notification to integrate PayPal payments with your business s back end operations Understand what your buyers see when they pay with PayPal For example review what it means for a new buyer to optionally create a PayPal
92. ent status Pending reason authorizatio address The payment is pending because your customer did not include a ahai confirmed shipping address and your Payment Receiving Preferences is set intl such that you want to manually accept or deny each of these payments To teo change your preference go to the Preferences section of your Profile currency authorization You set lt PaymentAction gt unilateral Authorization lt PaymentAction gt on SetExpressCheckoutRequest upgrade and have not yet captured funds e a echeck The payment is pending because it was made by an eCheck that has o er not yet cleared intl The payment is pending because you hold a non U S account and do not have a withdrawal mechanism You must manually accept or deny this payment from your Account Overview multi currency You do not have a balance in the currency sent and you do not have your Payment Receiving Preferences set to automatically convert and accept this payment You must manually accept or deny this payment unilateral The payment is pending because it was made to an email address that is not yet registered or confirmed upgrade The payment is pending because it was made via credit card and you must upgrade your account to Business or Premier status in order to receive the funds upgrade can also mean that you have reached the monthly limit for transactions on your account verify The payment is pending because you are not yet verified You must v
93. entering your Tax Rate for that state in the Tax Rate field All your customers who reside in the country or state you select are automatically charged the tax rate you choose You can specify a different tax rate for each U S state and any of the listed countries There are radio buttons that allow you to apply tax to an item only or to an item and any shipping and handling costs as you desire Click Save to save your changes NoTE If you are entering the rate for a U S state ensure that the Country drop down menu is set to United States Overriding Tax Setting Per Transaction The tax variable is an optional transaction based tax override variable with which you can set a flat tax amount on a single transaction regardless of the buyer s location For more information about this and other variables see Appendix A HTML Samples Merchant User Manual and Integration Guide May 2005 83 ES Calculating Shipping Handling and Tax Shipping Calculation Shipping Calculation Determine whether you would like to charge your customers for shipping as a flat amount or a percentage of the total purchase amount Flat Amount A flat amount is charged based on the subtotal of a purchase Here s an example EXAMPLE 9 1 Flat Amount Shipping Calculation Y our flat amount settings are 0 00 through 49 99 3 00 50 00 6 00 If your customer s subtotal is 36 50 your customer is charged 3 00 for shipping
94. ents take 3 4 business days to clear you may not want to accept them for your Instant Purchase and Buy Now buttons If you choose to block these payments you will not receive eCheck payments through PayPal Website Payments and Auction Logos Users who attempt to pay via eCheck will be prompted to add a credit card to their account before completing the transaction If you choose not to block these payments you will receive eCheck payments through PayPal Website Payments or Auction Logos eCheck payments will be listed as Pending and will not be credited to your PayPal Account for 3 4 business days Adding the Credit Card Statement Name This preference allows you to specify the name that will appear on your customers credit card statements When a buyer pays you by credit card your Credit Card Statement Name will appear with the word PAYPAL next to the charge on the statement e g PAYPAL MYCCNAME The Credit Card Statement Name can be up to 11 English and or German characters in length including spaces and cannot contain special characters e g amp etc This name will be converted to ALL CAPS and may be truncated by some credit card processors The Credit Card Statement Name should accurately reflect your business or legal name Merchant User Manual and Integration Guide May 2005 33 fe Getting Started Managing Your PayPal Merchant Account 34 May 2005 Merchant User Manual and Integration Guide PayPal Account
95. ere are two back end integration methods Instant Payment Notification and Payment Data Transfer Instant Payment Notification PayPal s Instant Payment Notification IPN allows you to integrate PayPal payments with your website s back end operations IPN provides immediate notification and confirmation of PayPal s payments you receive allowing you to e Customize your website s response to customer purchases in real time e Track customers through the notification s pass through variables e Automate your fulfillment operations e Store transaction information in your own database Once you activate IPN you will receive an IPN when a payment is first received that will display the status of the payment Completed or Pending If the payment status was Pending you will receive another IPN when the payment clears fails or is denied IPN can be seamlessly integrated with each of the PayPal Website Payments solutions Buy Now Buttons PayPal Shopping Cart Subscriptions and Recurring Payments and Donations as well as with regular PayPal Send Money and Mass Pay payments and lets you focus on selling not on manually tracking your orders Merchant User Manual and Integration Guide May 2005 23 PayPal Payments Overview Payment Receiving Preferences For more information about IPN Instant Payment Notification IPN on page 103 Payment Data Transfer Payment Data Transfer PDT provides merchants with the ability to display
96. erences UPS Preferences Payment Receiving Preferences Instant Payment Notification Preferences PayPal Shops Reputation Guarantee Preferences Seller Eligibility for PayPal Buyer Protection Website Payments Preference Custom ala Pages The Website Payment Preferences page opens 4 Click the Payment Data Transfer On radio button as shown in the following diagram Payment Data Transfer optional Payment Data Transfer allows you to recei are made The use of Payment Data Trans your Return URL Please note that in order on Auto Return Payment Data ion Transfer C Off Note You must enable Auto Return in order to use Payment Data Transfer Auto Return can also be enabled from the Website Payment Preferences page 5 Click Save Getting and Using the Identity Token When you click Save and save your PDT preferences a message will appear at the top of the page indicating that you have successfully saved your preferences Your identity token will also appear in the context of this message You will need to pass this identity token along with the transaction token to PayPal in order to receive information that confirms that the payment is complete Payment Data Transfer optional Payment Data Transfer allows you to receive notification of successful payments as they are made The use of Payment Data Transfer depends on your system configuration and your Return URL Please note that in order to use P
97. erience Step 5 Bob is taken to a Review page containing the details of his purchase Because Alice has activated Profile based Shipping for all of her transactions the Shipping amount for this purchase 2 00 is automatically added to Bob s purchase He clicks Complete Checkout to complete his purchase NoTE For more information about setting Shipping preferences see Chapter 9 Calculating Shipping Handling and Tax Alice s Used Books Payments by FEAR Welcome Shipping Billing Review Done Review Your Payment Information Please review the following details to make sure they are correct Click Complete Checkout to complete your payment or click Make Changes if you need to edit your information The financial information shown below will be kept confidential and the shipping information will only be shared with the merchant in order to complete your purchase This credit card transaction will appear on your bill as ALICESUSEDB Pay To Alice s Used Books Payment For Herodotus The History Quantity 1 Currency U S Dollars E Amount 15 00 USD US Shipping amp 2 00 USD landling Total Amount 17 00 USD My Shipping Info Shipping Address 303 Bryant St Mountain View CA 94041 United States Make Changes My Billing Info Credit Card XXXX XXXX XXXX 4623 First Name Bob Last Name Buyer Billing Address 304 Bryant St Mountain View CA 94041 United States Phone Number 650 464 71
98. erify your account before you can accept this payment other The payment is pending for a reason other than those listed above For more information contact PayPal Customer Service reason code chargeback This variable is only set if payment _ status Reversed or Refunded guarantee chargeback A reversal has occurred on this transaction due to a chargeback buyer by your customer complaint guarantee A reversal has occurred on this transaction due to your customer refund triggering a money back guarantee other buyer complaint A reversal has occurred on this transaction due to a complaint about the transaction from your customer refund A reversal has occurred on this transaction because you have given the customer a refund other A reversal has occurred on this transaction due to a reason not listed above payment _ Time Date stamp generated by PayPal system format 18 30 30 Jan 1 2000 date PST txn id A unique transaction ID generated by the PayPal system Character length and limitations 17 Merchant User Manual and Integration Guide May 2005 151 152 IPN and PDT Variables Currency and Currency Exchange TABLE B 3 IPN and PDT Variables Shopping Cart Information Variable Name Possible Values parent_txn_ id txn type cart send money web accept payment _ echeck type instant Description In the case of a refund reversal or canceled reversal this variable contains the txn_id of the ori
99. es lt input type hidden name cancel return value http www yoursite com cancel htm gt lt input type hidden name no note value 0 gt lt table gt lt tr gt lt td gt lt input type hidden name on0 value Color gt Color lt select name 0s0 gt lt option value Red gt Red lt option value Green gt Green lt option value Blue gt Blue lt select gt lt td gt lt tr gt lt table gt lt input type hidden name cn value How Did You Hear About Us gt lt input type image src http images paypal com images x click but01 gif name submit alt Make payments with PayPal it s fast free and secure gt lt form gt Sample Buy Now Hyperlink The same inputs would generate the following hyperlink Note Several optional fields are included in this example The text is URL encoded https www paypal com xclick business jsmaith 40paypal com amp undefined_quantity l amp item _name Baseball Hat amp item number 123 amp amount 5 95 amp no_shipping 1 amp return http 3A www your site com thankyou htm amp cancel_ return http 3A www yoursite com cancel htm amp cn How didty outhear about us 3F amp currency code USD NOTE Some Web browsers do not work properly with hyperlinks more than 1 000 characters Buy Now and Donations HTML and Hyperlink Variables The following table lists all of the available variables for a Buy Now or Donatio
100. f the payment was Pending you will receive another IPN when the payment clears fails or is denied To learn more about IPN see Instant Payment Notification IPN on page 103 Merchant User Manual and Integration Guide May 2005 57 Creating Buy Now and Donation Buttons Notifications You Receive 58 May 2005 Merchant User Manual and Integration Guide Creating Shopping Cart Buttons When you use PayPal s free Shopping Cart your customers can purchase multiple items with a single payment browse your entire selection and view a consolidated list of all their items before purchasing The PayPal Shopping Cart is a low cost way for you to accept credit card and bank account payments and can be fully integrated with your website in a few easy steps Save time and money with PayPal s hassle free Shopping Cart e Easy to implement no CGI scripting necessary e No up front costs you ll have the same low fee schedule as when you receive other PayPal payments e Sell with ease PayPal maintains detailed transaction records on our website The PayPal Shopping Cart also offers customizable buttons and secure payments to help you improve your buyer experience so happy customers become repeat customers Get the most out of your website today start using the PayPal Shopping Cart How It Works Bob who is new to PayPal is going to purchase several books from Alice s website The following example depicts the
101. f your customers 5 Click Save to save your preference The setting you choose for PayPal Account Optional affects all of your existing and new Buy Now Donations and Shopping Cart buttons for customers who are new to PayPal Your customers who already have PayPal accounts will see no change in their checkout experience they will log in as usual at the time of payment and complete the transaction from within the PayPal account Merchant User Manual and Integration Guide May 2005 35 A PayPal Account Optional Your Customer s Experience Your Customer s Experience If you have turned PayPal Account Optional off the checkout experience for a customer who doesn t currently have a PayPal account is the same as in the past the customer is required to sign up for a PayPal account to complete the payment and then returned to your website If you have PayPal Account Optional turned on the checkout experience for a customer who doesn t currently have a PayPal account does not require the PayPal account signup to complete the transaction thus shortening the time and effort necessary on the customer s part What Your Customer Sees Step 1 Bob goes to Alice s website and clicks Buy Now Home Art Language History Science cH Herodotus The History Herodotus Translated by David Grene Condition Like new slightly wom binding Price 15 00 Buy Now Step 2 Bob is taken to a PayPal Payment Details page which sho
102. ferences Use the Selling Preferences column to organize the way you sell with your PayPal account including editing your Payment Receiving Preferences tax and shipping May 2005 Merchant User Manual and Integration Guide Getting Started Managing Your PayPal Merchant Account Payment Receiving Preferences Once you have set up your PayPal account you re ready to start receiving payments Your Payment Receiving Preferences let you manage the types of payments you receive including e Block payments from U S users that do not have a confirmed address e Block payments sent to you in a currency you do not hold e Block payments from users with non U S PayPal accounts e Block payments from users who initiate payments from the Pay Anyone subtab e Block payments funded by credit cards when the sender has a bank account e Block payments funded by eCheck for PayPal Website Payments and Smart Logo payments To edit your Payment Receiving Preferences e Log in to your PayPal account e Click the Profile subtab of the My Account tab e Click the Payment Receiving Preferences link in the Selling Preferences column The Payment Receiving Preferences page opens as shown in the following diagram FIGURE 3 5 Payment Receiving Preferences My Account Send Money Request Money Merchant Tools Auction Tools Overview Add Funds Withdraw History Profile Payment Receiving Preferences Back to Profile Summary Note You are currently
103. g necessary e No up front costs you ll have the same low fee schedule used as when you receive other PayPal payments e Sell with ease PayPal maintains detailed transaction records on our website e Improve buyer experience with customizable buttons and secure payments happy customers become repeat customers How Buy Now and Donations Work Bob who is new to PayPal is going to make a purchase or a donation on Alice s Used Books website Depending on the PayPal Account Optional setting Alice has chosen in the Website Payments Preferences of her Profile Bob s purchasing experience may differ from what is shown here The following example depicts the flow that occurs when PayPal Account Optional is turned off and the user must create a PayPal account to complete the transaction For more information about the PayPal Account Optional setting see Chapter 4 PayPal Account Optional Merchant User Manual and Integration Guide May 2005 43 5538 Creating Buy Now and Donation Buttons How Buy Now and Donations Work What Your Customer Sees Step 1 Bob goes to Alice s website and clicks Buy Now or Donations Home Art Language History Science Hiss Herodotus The History Herodotus Translated by David Grene Condition Like new slightly worn binding Price 15 00 Buy Now Step 2 Bob is taken to a PayPal Payment Details page which shows the details of the payment he is about to make Payment
104. ginal transaction while txn_id contains a new ID for the new transaction Character length and limitations 17 cart Transaction created by customer via the PayPal Shopping Cart feature send money Transaction created by customer from the Send Money tab on the PayPal website web accept Transaction created by customer via Buy Now Donation or Auction Smart Logos echeck This payment was funded with an eCheck instant This payment was funded with PayPal balance credit card or Instant Transfer Currency and Currency Exchange TABLE B 4 IPN and PDT Variables Currency and Currency Exchange Information Variable Name Possible Values mc gross mc fee mc currency See table of supported currencies mc handling mc shipping Description Full amount of the customer s payment before transaction fee is subtracted Equivalent to payment_ gross for USD payments If this amount is negative it signifies a refund or reversal and either of those payment statuses can be for the full or partial amount of the original transaction Transaction fee associated with the payment mc_gross minus mc_fee will equal the amount deposited into the receiver email account Equivalent to payment fee for USD payments If this amount is negative it signifies a refund or reversal and either of those payment statuses can be for the full or partial amount of the original transaction fee For payment IPNs this is the curren
105. ging Multiple Currencies payments Accepting Payments PayPal lets you choose what currencies to accept and how you would like to accept them When a buyer sends a payment in a currency you hold the funds will automatically appear in your account in the balance of the given currency When a buyer sends a payment in a Merchant User Manual and Integration Guide May 2005 111 112 Recent Activity Au Activity Hy Auctions mea File Type TofFrom HamefEmaill Amount Date Staas PF Payment From Hedo Ware EUR 50 00 Sep 29 2002 Urea Filo Selected ters _File Al Using Multiple Currencies Receiving Money currency you do not hold you will be asked to Accept or Deny the payment as shown in the following diagram My Account Send Money Request Money Merchant Tools Auctlon Tools Accept or Deny a Payment You have received a payment of 250 00 Euros from Neda Ware Mented Business Member 61 What would you like to do with this payment C Agcept this payment convert if to 47 99 US Dollars and transfer if to my Y S Gellar Balance C Apcapt this payment in Euros and create a Euro Balance in my PayPal account O Deny thie payment Submit Cancel e Accept the payment and open a new currency balance e Accept the payment and convert it to your primary currency e Block the payment You can also set up your Payment Receiving Preferences to indicate how you would like to handle incoming currency payments
106. hat your Business Premier account is Verified This is your seller account 3 Go to your Web browser and click the button you ve created Use the login and password for your buyer account to purchase the item You can use penny 01 transactions and still refund the entire amount 4 Check the results of your button test by looking at the emails received by both accounts and by viewing the History page for each account They should be similar to those shown in the How lt Works section 5 Log in to your seller account and refund the payment To refund a payment go to the Transaction Details page and follow the Refund Payment link at the bottom of the page The refund reverses the entire payment including transaction fees Remember that you have 60 days to refund the payment This testing method is free of charge and lets you complete the entire process yourself You can also have friends or trusted clients buy test items then refund them if you would prefer not to open a second PayPal account May 2005 Merchant User Manual and Integration Guide Your PayPal Button Testing Tips You might find the following testing tips useful when testing your buttons Testing Tip 1 PayPal recommends starting with one of PayPal s code samples available at https www paypal com ipn under the Code Samples section There are code samples for the following development environments e ASP VBScript e ColdFusion e ava JSP e PERL e PHP
107. he Return URL that explains that payment transaction details will be emailed to the buyer Example Thank you for your payment Your transaction has been completed and a receipt for your purchase has been emailed to you You may log into your account at www paypal com to view details of this transaction Save Cancel Merchant User Manual and Integration Guide May 2005 93 ii Auto Return Subscription Password Management and Auto Return 5 Enter the Return URL to which you want your buyers redirected upon payment completion in the Return URL field You Return URL must meet the following requirements Per the user agreement you must provide content on the page displayed by the Return URL that helps the buyer understand that the payment has been made and that the transaction has been completed You must provide content on the page displayed by the Return URL that explains that payment transaction details will be emailed to the buyer Your Return URL must be specify a server that is available and be properly formatted Note If the Return URL that you supply is not valid PayPal displays the standard Payment Done page upon payment completion 6 Click Save Subscription Password Management and Auto Return If you use or plan to use Subscriptions Password Management you must make sure that Auto Return is turned off in order to display the PayPal generated username and password to the buyer NoTE You can use Aut
108. he transaction is sent The merchant returns the transaction ID along with their identity token and PayPal then sends the merchant payment information that confirms that the payment is complete The buyer is directed back to the merchant site where the transaction information is displayed However if the buyer does not click Continue they will not be directed back the merchant s site and PDT will not be initiated Setting Up Payment Data Transfer Once you have activated PDT every time a buyer makes a website payment and is redirected to your return URL a transaction token will be passed along as a GET variable to this return URL In order to properly use PDT and display transaction details to your customer you should fetch the transaction token variable name tx and retrieve transaction details from PayPal by constructing an HTTP POST to PayPal Your POST should be sent to https www paypal com cgi bin webscr You must post the transaction token using the variable tx and the value of the transaction token previously received e g tx transaction token and the special identity token using the variable at and the value of your PDT identity token e g at identity token You will also need to append a variable named cmd with the value_notify synch for example cmd _notify synch to the POST string PayPal will respond to the post with a single word SUCCESS or FAIL on one line in the body of the response When you receive a SUCCESS respon
109. igned up Shipping Confirmation P let Auto Return aymen oe ete turned on v PayPal Account Optional Website Payment ae Payment Receipt Billing v PayPal Account Auto Return Optional interstitial Review Payment complete Payment complete User clicks Continue v optional PayPal Account signup L Optional Done Redirect vw falar le User clicks Continue Save info PayPal Account i Optional Merchant site New PayPal Thank You Account 26 May 2005 Merchant User Manual and Integration Guide Getting Started You can start accepting payments with PayPal in 5 easy steps Step 1 Sign Up Go to https www paypal com and click the Sign Up link in the upper right hand corner of the page Click the Business link to sign up for a Business account as shown in the following diagram Make sure to write down the email address you use and the password you choose in the future you will use them to login to your PayPal account FIGURE 3 1 Business Account Sign up Business Account Sign Up Personal l Business Non U S Sign Up Business Information If you are a group organization government entity non profit sole proprietor or 5 partnership please sign up here for a Business Account Business Name Alice s Used Books Industry Choose an Industry yl Address 1 23 man Address 2 optional City State i 5 or 9 digits Country U S A Business Owner Cont
110. imilar to the following Note Several optional fields are shown IMPORTANT You can change the values for any of the variables with the exception of the first two lines lt form target paypal action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value _xclick gt These lines are required and must not be changed lt form action https www paypal com cgi bin webscr method post gt lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden nam nam nam nam nam nam nam nam nam nam nam e cmd value _xclick gt e business value jsmith paypal com gt e return value http w yoursite com thankyou htm gt e undefined quantity value 1 gt e item name value Baseball Hat gt e item number value 123 gt e amount value 5 95 gt e custom value merchant_custom value gt e invoice value merchant invoice 12345 gt e no shipping value 1 gt e image url value https www yoursite com logo gif gt Merchant User Manual and Integration Guide May 2005 131 132 HTML Samples PayPal Buy Now and Donation Buttons HTML and Variabl
111. ing Options Shipping Information Ship to 1234 Main Street Walnut Creek CA 95599 Add Address C No shipping address required Pay Cancel Step 5 A payment confirmation page appears that informs Bob that his payment has been completed and that he is being automatically redirected back to the Widget Warehouse site The page also displays a success URL that the user can click manually if the redirect fails Payments by EPAR E Indust You Made A Payment Your payment for 162 50 USD has been completed You are now being redirected to Widget Warehouse If you are not redirected within 10 seconds click here Merchant User Manual and Integration Guide May 2005 91 41 Auto Return How Auto Return Works Step 6 The Widget Warehouse s Thank You page appears again informing Bob that his transaction is complete and that a receipt for the purchase has been emailed to him The page also displays a link to PayPal that Bob can use to view details of the transaction if necessary as well as links that he can use to continue shopping Global Industries Inc Widget Warehouse Saas Thank you for your payment Your transaction has been completed Rubber Widgets Aluminum We dgets E Steel Widgets Payment Detalle Outdoor Widgets Item Widget ndoor Widgets Automotive Widgets Amount 162 50 Plastic Widget Email bdeboe merchanttv Titanium Widgets Ship to Bob Deboe 1234 Main Street Walnu
112. ion Note HTML Tips Please ensure that the HTML code on your Web page exactly matches the code you copied from PayPal Some HTML editors may add delete or change some characters in your code If this is the case please change the code on your Web page to exactly match the code you copied You can copy the code into a new Notepad document reselect all of the code copy then paste it into your Web editor Please be sure that when you paste the HTML code for your button you are pasting this information into a field that accepts HTML code If you paste this code into a standard text field the code will be posted to your Web page as standard text For more tips on placing your payment on your Web page please refer to the Help section of your Web page editor May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons Buy Now and Donations Button Factory If you will be sending your customers the payment link via email Copy the code from the For Emails text box by highlighting all of the text and pressing Ctrl C or by highlighting all of the text right clicking on your mouse and choosing Copy Open the email you wish to send Paste the code you just copied into your email by either pressing Ctrl V or by right clicking on your mouse and selecting the Paste option When your customers receive the email the code will appear as a link Clicking the link will take them to your PayPal payments page
113. ion of the following PayPal Account features e Send Money e Mass Payments U S Accounts only e Request Money e Add Funds e Refunds e BillPay U S Accounts only e Withdraw Funds e Cancel Payments e View Balance e View Profile e Edit Profile e Settlement File e Scheduled Downloads Log e API Activation and Authorization May 2005 Merchant User Manual and Integration Guide Security 17 Multi User Access Getting Started To use Multi User Access 1 Log in to your PayPal Business account 2 Go to your Profile and click the Multi User Access link 3 Specify your Administrative Contact email address which is the email address that will receive notifications about your account activity 4 Add up to 9 separate logins to your account For every login select a User ID and password and specify what account privileges the user has permission to access e g Refunds Send and Request Money My Account Send Money Request Money Merchant Tools Auction Tools Overview Add Funds Withdraw History Profile Add Users _See Demo Give a user permission to access this account by creating a User ID below Begin by providing the user s full name first and last a user name and a password You currently have 2 users added to your account and may add 7 more User s Name First and Last Henry Jones The User ID must be at between 10 and 16 characters long can only contain letters and numbers no
114. is never shared Save My Info Continue If Bob clicks Save My Info he will be taken to a page where he can enter the rest of the information needed to create a PayPal account see Step 7 The information Bob has already entered to complete the transaction will automatically carry forward If he clicks Continue he will be redirected to either Alice s site or to PayPal depending on how she has set her return preferences for the button May 2005 Merchant User Manual and Integration Guide PayPal Account Optional Your Customer s Experience Step 7 If Bob clicked Save My Info he is taken to a page where he can complete signup for a PayPal account Once he has filled in the fields he clicks Save Information to create the account Alice s Used Books Payments by REPART Save Your Customer Information With PayPal Save the address and payment information you ve already entered into a United States PayPal account and you can shop more quickly and easily all across the Web Just choose a password and create answers to the security questions below to save your information for later Email Address and Create a Password You must have access to this email address in order to complete registration Your email address will be kept confidential and will not be shared The password you choose must be at least 8 characters long Email Address SSCS Create a PayPal 22222 Password Retype Password 2222222 Securi
115. is notification will be sent as a hidden FORM POST to the URL you specified and will include all of the payment information The FORM variables for these notifications are available in Appendix A of this manual Norte IPN will translate special characters into URL encoding format For example the colon in http is translated to 3 A in the IPN post Merchant User Manual and Integration Guide May 2005 103 Pe Backend Integration Payment Notifications Instant Payment Notification IPN How IPNs Are Sent Step 1 Your buyer comes to your website and clicks on a PayPal Buy Now button to make a purchase Home Art Language History Science ThH Herodotus The History Herodotus Translated by David Grene Condition Like new slightly worn binding Price 15 00 Buy Now Step 2 After your buyer checks the payment details and sends the payment he will see a confirmation page as shown in the following diagram You Made A Payment Payment Information A payment of 17 00 has been sent to Alice s Used Books You will receive an email receipt for this transaction shortly For details on your transaction please contact Alice s Used Books Item Name Herodotus The History Add free gift wrap No How did you hear about us PayPal Shops Featured Shop Item Number HIS 0001 Shipping amp Handling 2 00 Amount 15 00 Quantity 1 Total Amount 17 00 Contact Information Business Name Alice
116. istory transaction log You can be notified of payments in these four ways email history transaction log downloadable history transaction log and if you have activated it Instant Payment Notification IPN You receive an email notification in the following cases e Successful Payment e Pending Payment e Cancelled Payment If you do not want to receive payment notifications via email 1 Click the Profile subtab of the My Account tab May 2005 Merchant User Manual and Integration Guide Creating Shopping Cart Buttons CAEN Notifications You Receive 2 Click the Notifications link from the left hand menu 3 Find the Payment Notifications heading and clear the I receive PayPal Website Payments and Instant Purchase checkbox 4 Click Save History Your transaction history log History contains information about your payments Each payment has one of the following statuses e Completed The transaction was successful and the money was credited to your account e Cleared The eCheck payment has cleared the sender s account and has been credited to your account e Uncleared The eCheck payment has not cleared the sender s account yet Downloadable Logs Log in to your PayPal account go to the History subtab of the My Account tab and choose the Download My History link in the Quick Links menu Choose the All Activity radio button or enter the dates of the entries you want to download choose the type of fi
117. k account It s just like writing a check only it is done electronically When your buyer has a PayPal balance or uses an Instant Transfer or a credit card the money is instantly credited to the your PayPal account However when your buyer sends money with an eCheck the transaction is held as pending for three to four business days and will have a Pending status in the History and IPN log until the electronic funds transfer has cleared your bank Your balance does not reflect the eCheck payment until the funds transfer is complete Nore Users receive a follow up email when you use an eCheck If you have enabled IPN you will automatically receive notification when the eCheck clears or fails For more information about IPN see Instant Payment Notification IPN on page 103 Blocking eChecks You also have the option of blocking eChecks using your Payment Receiving Preferences For more information about blocking eChecks and other Payment Receiving Preferences see Payment Receiving Preferences on page 24 Refunding eChecks You can refund an eCheck including eChecks that have not cleared for 60 days after it was originally sent eCheck refunds will credit the sender s PayPal account not the bank account from which the eCheck originated Norte You can refund any payment including eChecks for 60 days after the payment was originally sent Merchant User Manual and Integration Guide May 2005 125 16
118. l Payment Complete page Requires Return URL to be set Transaction Information currency _ The currency of the payment Defines the currency in which the monetary code variables amount shipping shipping2 handling tax are denoted Possible values are USD U S Dollar EUR Euro GBP Pound Sterling CAD Canadian Dollar JPY Yen If omitted all monetary fields will be interpreted as U S Dollars custom Pass through variable that will never be presented to your customer If 256 omitted no variable will be passed back to you handling The cost of handling This is not quantity specific The same handling will be charged regardless of the number of items purchased If omitted no handling charges will be assessed invoice Pass through variable you can use to identify your Invoice Number for this 256 purchase If omittted no variable will be passed back to you shipping The cost of shipping this item if you have enabled item specific shipping costs If shipping is used and shipping2 is not defined this flat amount will be charged regardless of the quantity of items purchased If you are using item based shipping make sure the override check box is checked in your Profile If omitted and your Profile based shipping is enabled your customer will be charged the amount or percentage defined in your Profile shipping2 The cost of shipping each additional item If omitted and your Profile based shipping is e
119. l be submitted If set to 2 and if return is set the buyer will be sent back to the return URL using a POST method to which all available transaction variables will also be posted If omitted or set to 0 GET methods will be used for all Shopping Cart transactions in which IPN is not enabled POST methods with variables will be used for the rest Sets the Custom Payment Page Style for payment pages associated with this button link The value of page_style is the same as the Page Style Name you chose when adding or editing the page style You can add and edit Custom Payment Page Styles from the Profile subtab of the My Account tab If you would like the button link to always reference the style you make Primary set this variable equal to primary If you would like this button link to reference the default PayPal page style set this variable equal to paypal The page_style variable has a maximum length of 30 characters Valid character set is alphanumeric ASCII lower 7 bit characters only plus underscore It cannot include spaces Sets the image you choose to appear at the top left of the payment page The image can have a maximum size of 750 pixels wide by 90 pixles high Valid character set is URL safe characters The cpp_header_image variable has no character limit because the image is not stored on our database It is recommended that you only provide an image that is stored on a secure https server For more information see
120. le for a button you have already created you can modify the button s HTML code replacing the value of the page_style variable with the Page Style Name of the style you wish to apply The next time the button is clicked its payment pages will appear in the new style When passed through at a transaction level Custom Payment Page variables are used to customize the payment pages and override any page styles set in profile settings or page settings Customization variables are applied in the following order TABLE 8 1 Order of Customization Variables Custom Option Description 1 Custom Payment Pages See Table A 2 Shopping Cart Variables on page 138 Variable at a Transaction level 2 Primary Page Style ata A valid page style can be passed through at a Transaction level Transaction level that overrides any page styles set in profile settings or page settings 3 Primary Page Style in You can create and select the primary style in profile settings Profile 4 Default PayPal Page The default page style used when an alternative is not selected Style in Profile and designated as primary 80 May 2005 Merchant User Manual and Integration Guide Custom Payment Pages E Background Colors and Error Messages Background Colors and Error Messages PayPal s error message system highlights errors in red PayPal does not allow certain background colors that make these error messages unreadable The background color of the following
121. le you would like to download Comma delimited Tab delimited Quicken or QuickBooks and click Download History The downloaded file will contain a record of all of your payments Instant Payment Notification IPN If you have Instant Payment Notification activated you will receive an IPN when a payment is first sent which will state the status of the payment Completed or Pending If the payment was Pending you will receive another IPN when the payment clears fails or is denied To learn more about IPN see Instant Payment Notification IPN on page 103 Merchant User Manual and Integration Guide May 2005 69 az Creating Shopping Cart Buttons Notifications You Receive 70 May 2005 Merchant User Manual and Integration Guide 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 a
122. led For more information about the PDT identity token see Getting and Using the Identity Token on page 100 For more information about the HTTP POST see Setting Up Payment Data Transfer on page 101 98 May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications Payment Data Transfer Step 7 The Widget Warehouse s Thank You page appears and displays the transaction information again informing Bob that his transaction has been completed and a receipt for the purchase has been emailed to him The page also displays payment details a link to PayPal that Bob can use to view more transaction details if necessary as well as links that he can use to continue shopping For example as shown in the following diagram Thank you for your payment Your transaction has been completed and a receipt for your purchase has been emailed to you You may log into your account at www paypal com to view details of this transaction Widget Warehouse Thank you for your payment Your transaction has been completed abuminum Vedas Item Widget ana Amount 162 50 Q alosta Email bdeboe merchant tv Ship to Bob Deboe 1234 Main Street Walnut Creek CA 95599 Please print this page for your records A receipt for your purchase has also been emailed to you Global Industries Inc Al rights reserved 2003 Step 8 Bob receives an email receipt for this transaction confirming his
123. link If you would still like to send out Buy Now links in emails you may try either sending an HTML email providing a link to the Buy Now Button with Option fields on your website or asking your user to include the optional information in the Note field Option Field Type Choose the type of option field drop down menu or text box If you choose drop down menu you will enter the different choices If you choose text box your customer will enter his choice Option Name Enter the name of your option There is a 60 character limit for the Option Name field Drop Down Menu Choices If you are using a drop down menu enter your menu choices There is a 30 character limit per choice with a maximum of 10 choices Use a carriage return press ENTER to separate each choice Step 6 Customize your payment pages Custom Payment Page Style Give your customers a seamless payment experience by customizing PayPal s payment pages to match the style of your website If you have already added Custom Payment Page Styles in your Profile they will be listed here Choose the page style you would like to appear when your customer clicks your Buy Now button To learn more about creating page styles see Chapter 8 Custom Payment Pages Step 7 Customize Your Buyer Experience Successful Payment URL Enter the URL for the page to which you want your customer redirected after he has completed his payment Unless you have enabled A
124. ll be funded and his shipping information He clicks Pay to complete the payment Payments by PayPal Global Industries Inc cD indus es Widget Warehouse Confirm Your Payment Check the following details and click the Pay button below to complete your payment Pay To Globe Industries Inc User Status Unverified Business Member 0 Payment For Widget Quantity 1 Currency U S Dollars E Amount 142 50 USD Shipping amp Handling 20 00 USD Total Amount 162 50 USD Source of Funds U S Dollar Balance 162 50 USD Shipping Information Ship to 1234 Main Street Walnut Creek CA 95599 zl Add Address C No shipping address required Pay Cancel Step 5 A payment confirmation page appears that informs Bob that his payment has been completed and that he is being redirected back to the Widget Warehouse website Payments by LEPARI gt Globe Global Industries Inc n 5 Indusfies Widget Warehouse You Made A Payment Your payment for 162 50 USD has been completed You are now being redirected to Widget Warehouse If you are not redirected within 10 seconds click here Step 6 A transaction token is passed to the return URL provided by the Widget Warehouse The Widget Warehouse fetches the transaction token and retrieves the transaction details from PayPal via an HTTP POST Included in the HTTP post is the identity token that was given to the Widget Warehouse when PDT was enab
125. me low fee schedule used as when you receive other PayPal payments e Sell with ease PayPal maintains detailed transaction records on the PayPal website e Improve buyer experience with customizable buttons and secure payments happy customers become repeat customers For more information about Buy Now and Donations Buttons see Chapter 5 Creating Buy Now and Donation Buttons Shopping Cart When you use PayPal s free Shopping Cart your customers can purchase multiple items with a single payment browse your entire selection and view a consolidated list of all their items before purchasing The PayPal Shopping Cart is a low cost way for you to accept credit card and bank account payments and can be fully integrated with your website in a few easy steps The PayPal Shopping Cart also offers customizable buttons and secure payments to help you improve your buyer experience so happy customers become repeat customers For more information about PayPal s Shopping Cart see Chapter 6 Creating Shopping Cart Buttons Custom Payment Pages With our Custom Payment Pages feature you can tailor PayPal s payment pages to the style of your website for a truly seamless payment experience Make PayPal s payment flow yours with custom page colors and your own images Custom Payment Pages can be used with all PayPal Website Payment buttons including Buy Now Donations Shopping Cart and Subscriptions For more informa
126. mediately clear For a complete list of PDT fields variables and sample code see IPN and PDT Variables on page 145 Preventing Fraud In order to prevent fraud PayPal recommends checking your script and verifying that the e txn idis nota duplicate to prevent someone from using reusing an old completed transaction e receiver email is an email address registered in your PayPal account to prevent the payment from being sent to a fraudulent account e Other transaction details such as the item number and price to confirm that the price has not been changed Code Samples PayPal has made available code samples that you can use to set up PDT These samples are available at https www paypal com us cgi bin webscr cmd p xcl rec pdt code There are code samples for the following development environments e ASP VBScript e ColdFusion e PERL e PHP May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications Instant Payment Notification IPN Instant Payment Notification IPN PayPal s Instant Payment Notification IPN allows you to integrate PayPal payments with your website s back end operations IPN provides immediate notification and confirmation of PayPal payments you receive allowing you to e Customize your website s response to customer purchases in real time e Track customers through the notification s pass through variables e Automate your fulfillmen
127. ment IPN includes the additional variable test_ipn with a value of 1 one The purpose of test _ipn is to provide testing programs a means to differentiate between Sandbox IPN and live IPN Merchant User Manual and Integration Guide May 2005 145 146 IPN and PDT Variables IPN Variables in All Posts IPN Variables in All Posts IPN Version notify_version The value of the notify version variable is the version number of Instant Payment Notification that makes the post The current version of IPN is 1 6 Security Information verify_sign The value of of verify_sign is an encrypted string used to validate the authenticity of the transaction Buyer Information TABLE 17 1 IPN and PDT Variables Buyer Information Variable Name Possible Values first name last_name payer business name address _ name address _ street address _ city address _ state address zip address _ country address _ confirmed status unconfirmed payer email payer id Description Customer s first name Customer s last name Customer s company name Name used with address Included when the customer provides a Gift Address Customer s street address City of customer s address State of customer s address Zip code of customer s address Country of customer s address Customer provided a confirmed address Customer provided an unconfirmed address Customer s primary email
128. mount 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 lt input type hidden name cmd value _xclick gt with lt input type
129. nabled your customer will be charged the amount or percentage defined in your Profile Merchant User Manual and Integration Guide May 2005 135 OA HTML Samples PayPal Buy Now and Donation Buttons HTML and Variables TABLE A 1 HTML and Hyperlink Variables for Buy Now and Donations Buttons Character Name Description Length tax Transaction based tax override variable Set this to a flat tax amount you would like to apply to the transaction regardless of the buyer s location If present this value overrides any tax settings that may be set in your Profile If omitted Profile tax settings if any will apply tax x The item tax amount 136 May 2005 Merchant User Manual and Integration Guide HTML Samples EEN PayPal Shopping Cart HTML and Variables PayPal Shopping Cart HTML and Variables PayPal Shopping Cart HTML Rather than creating a separate button for every single item you wish to sell with the PayPal Shopping Cart you can manipulate the Add to Cart HTML code to create different Add to Cart buttons Standard Add to Cart HTML The following HTML shows the output of a generic Add to Cart button several optional fields are shown IMPORTANT You can change the values for any of the variables with the exception of the first two lines lt form target paypal action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value _cart gt These lines are required and
130. naging Your PayPal Merchant Account Smart Logos or eBay Checkout Payments Selecting this option may help you manage your account because all of the PayPal payments you receive will be attached to a specific item or transaction that you previously defined If you choose not to block these payments you will accept all payments including those initiated via the Pay Anyone subtab of the Send Money tab Blocking Payments Funded By Credit Cards When Sender Has a Bank Account This preference allows you to force customers to pay you with a bank account or PayPal funds if they are able to do so However if they cannot pay you using a bank account or PayPal funds they will still have the option to pay with a credit card This preference can also help to reduce your risk of chargebacks Verified users are users who have confirmed their bank accounts with PayPal or have been otherwise verified by PayPal Because most Verified members have the option of paying with their bank accounts via eCheck or Instant Transfer choosing this preference will not prevent any users from being able to send you money When they pay you with PayPal s Instant Transfer you receive the payment instantly just as when they pay with a credit card Users who have not confirmed their bank accounts with PayPal can still send you money funded from credit cards Blocking Payments Funded By eChecks This preference allows you to block eCheck payments Because eCheck paym
131. ncy of your primary balance Step 2 Choose a payment button to put on your website If you are going to be receiving payments from your website choose the image for the button you would like your customers to click to make their purchase To display your own image enter the URL of the image s location in the URL field Norte PayPal recommends that you enter an image URL only if the image is stored on a secure https server Otherwise your customer s Web browser will display a message that the payment page contains insecure items If you are creating an email link skip to Step 4 Step 3 Security Settings PayPal offers the option to encrypt your button s HTML code Encryption ensures that an item s price and other details cannot be altered by a third party thus increasing the security of your transactions Select Yes to encrypt your code or No to leave it editable Note PayPal highly recommends encrypting your button code however doing so has three limitations The HTML code generated for an encrypted button is not editable so if you are accustomed to modifying your button code manually you might want to select No for this option You will not be able to encrypt your button if it has dynamically generated code from the Add More Options page such as drop down Options fields see step 5 If you need Option fields for your products then you will want to turn encryption off by selecting No Also you will not be able t
132. ng 2 00 Quantity 1 Item Product Name Herodotus The History Item Product Number HIS 0001 48 May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons E Buy Now and Donations Button Factory Step 9 Alice logs in to her PayPal account to check the payment or donation Bob has sent I Payment From Robert Smith May 14 2002 Completed Step 10 The funds from Bob s payment are now reflected in Alice s PayPal account balance She ships the book to Bob or sends him a tax receipt for a donation U S Business Account Overview Name Alice s Used Books Alice Jones Email alice mystore com Add email Status Verified 0 Balance 16 91 Currently earning 1 20 Note For more information about PayPal s fees please click the Fees link at the bottom of any PayPal Web page or visit https www paypal com fees Buy Now and Donations Button Factory One Buy Now button can be used to sell a single Mozart CD for 15 or if you choose it can allow your customer to purchase multiple copies of the same CD at once If however you would like to sell a Mozart CD and a Beethoven CD you will need to create separate Buy Now Buttons for each item or use PayPal s Shopping Cart Donations buttons can be used to collect a pre determined amount i e donations of 50 or you can allow your donors to choose the amounts of their donations Use the following steps to create your Buy No
133. ns Button NoTE If you want to remove the values for a variable for example to leave the amount blank for your customer to define you remove remove the entire variable not just the value For example you should remove this entire line lt input type hidden name amount value 5 95 gt May 2005 Merchant User Manual and Integration Guide HTML Samples EEN PayPal Buy Now and Donation Buttons HTML and Variables TABLE A 1 HTML and Hyperlink Variables for Buy Now and Donations Buttons Name Description Item Information amount item name item number on0 quantity undefined _ quantity onl os0 osl The price or amount of the purchase not including shipping handling or tax If omitted this value will be editable by the customer at the time of purchase Description of item If omitted customer will see a field in which they have the option of entering an item name Pass through variable for you to track purchases or donations It will get passed back to you at the completion of the payment If omitted no variable will be passed back to you First option field name If omitted no variable will be passed back to you Number of items The amount shipping and tax will be multiplied by the quantity to get the total payment amount If this is a shopping cart transaction we will append the number of the item e g quantityl quantity2 If included and set to 1 enables buyer to modify the
134. nter Contact Us User Agreement Developers Shops Gift Certificates Points PayPal an eBay company Copyright 1999 2004 PayPal All rights reserved Information about FDIC pass through insurance Merchant User Manual and Integration Guide May 2005 117 Language Encoding for Your Data Changing Your Language Encoding To change the language of data PayPal should expect from your website click the Your website s language drop down menu and select a different language as shown in the illustration Figure 14 3 Website Language Preference FIGURE 14 3Website Language Preference RayPal i Log Out Help Auction Tools Request Money Merchant Tools My Account Send Money Add Funds Withdraw History Resolution Center Overview Language Encoding Use the following drop down menu to select the language you use on your website The language on your website determines the encoding method that is used for the data sent to PayPal from the website payment buttons Your website s Western European Languages including English language Western European Languages including English Chinese Traditional Chinese Simplified Cancel Mobile Mass Pay Money Market ATM Debit Card BillPay Referrals About Us Accounts Fees Privacy Buyer Credit Security Center Contact Us User Agreement Developers Shops Gift Certificates Points P
135. ntinue to Step 8 If you have no further details to add to your Donations button click Create Button Now Otherwise click Add More Options Step 3 Customize Your Payment Pages Custom Payment Page Style Give your donors a seamless payment experience by customizing PayPal s payment pages to match the style of your website If you have already added Custom Payment Page Styles in your Profile they will be listed here Choose the page style you would like to appear when your donor clicks your Donate button To learn more about creating page styles Chapter 8 Custom Payment Pages Merchant User Manual and Integration Guide May 2005 53 Creating Buy Now and Donation Buttons Buy Now and Donations Button Factory Step 4 Customize Your Donors Experience Successful Payment URL Enter the URL where you would like to send your donors after they have completed payment Once your donor has completed his payment he will see a payment confirmation page From this page he will click Click to Continue and return to the successful payment URL you have specified If you do not enter a successful payment URL donors who click this link will be taken to a PayPal Web page Cancel Payment URL Enter the URL where you would like to send your donors if they cancel a payment at any point in the Donations payment flow If you do not enter a cancel payment URL donors who click this link will be taken to a PayPal Web page Step 5 Miscellaneo
136. o Return with Subscriptions which is a separate feature from Subscription Password Management For more information about Subscriptions see the Subscriptions and Recurring Payments Manual which is available on the PayPal website 94 May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications PayPal offers two payment notification methods for backend integration PayPal offers four payment notification methods for backend integration e Emails e Reports e Instant Payment Notification IPN e Payment Data Transfer PDT Emails You will receive an email notification in the following cases e Successful Payment e Pending Payment e Cancelled Payment If you do not want to receive payment notifications via email 1 Click the Profile subtab of the My Account tab 2 Click the Notifications link from the left hand menu 3 Find the Payment Notifications heading and clear the I receive PayPal Website Payments and Instant Purchase checkbox 4 Click Save Reporting PayPal s Reporting Tools provide you with the information you need to effectively measure and manage your business With PayPal s Reporting Tools you can e Analyze your revenue sources to better understand your customers buying behavior e Automate time consuming bookkeeping tasks e Accurately settle and reconcile transactions The available reports are e Monthly Account Statements View a summary of all credits and de
137. o create an email link if you choose to encrypt your button If you do not have additional details to add to your button such as sales tax shipping or your logo click Create Button Now and go to Step 11 Otherwise click Add More Options 50 May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons Buy Now and Donations Button Factory Step 4 Shipping and Sales Tax Shipping Cost Calculation If you have already specified shipping rates in your Profile they will be listed here To learn more about charging for shipping see Chapter 9 Calculating Shipping Handling and Tax Sales or Value Added Tax Calculation If you have already specified your tax rate from your Profile it will be listed here For more information about charging for tax see Chapter 9 Calculating Shipping Handling and Tax Step 5 Add Option fields to your button Let your customers specify information about their purchases by creating an option field You can use Option fields to specify things like color size or gift wrapping Options must not change the price of an item but let you collect additional information from your customer without extra email communication Each Buy Now Button may have up to two option fields and may you use a drop down menu or text box to collect the information Unfortunately Option fields and button encryption cannot currently be used if you are creating an email hyper
138. o refund Click Details to open the Transaction Details page Click the Refund Payment link on the Transaction Details page Enter the refund amount and click Submit ot Sy ee Te a Confirm the refund amount and click Submit To send a refund after 60 days of receiving payment May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications Processing Refunds 1 Log in to your PayPal account Click the Send Money tab Enter the required information Click Continue an A Ww N Review the information on the confirmation page and click Send Money to complete your transaction NoTE Fees assessed by Business or Premier Account receiving payments can only be reimbursed if the refund link on the Transaction Details page is used The original transaction fee will be credited back to you when you when you perform a refund If you perform a partial refund a portion of the transaction fee will be credited back to you Sending Partial Refunds You can send a partial refund to your buyer for 60 days after receiving payment by using the refund link on the Transaction Details page The partial refund will be deducted from your PayPal account balance or sent to the buyer in the form of an eCheck Note If the buyer denies your partial refund offer you may offer another refund Only one partial refund is allowed To send a partial refund 1 Log in to your PayPal account 2 Click the Hist
139. onal Amount of payment for trial period 2 for USD payments otherwise blank optional Amount of payment for regular subscription period for USD payments otherwise blank Amount of payment for trial period 1 regardless of currency optional May 2005 Merchant User Manual and Integration Guide IPN and PDT Variables Subscriptions Variables TABLE B 7 Subscriptions Variables Possible Variable Values mc_amount2 mc_amount3 mc currency See introduction recurring reattempt retry at recur times username password subscr_id Character Description Limit Amount of payment for trial period 2 regardless of currency optional Amount of payment for regular subscription period regardless of currency For non payment subscriptions IPNs i e txn type signup cancel failed eot or modify this is the currency of the subscription For payment IPNs it is the currency of the payment 1 e txn_ type subscr payment Indicates whether regular rate recurs 1 is yes blank is no Indicates whether reattempts should occur upon payment failures 1 is yes blank is no Date PayPal will retry a failed subscription payment The number of payment installments that will occur at the regular rate optional Username generated by PayPal and 64 given to subscriber to access the subscription optional Password generated by PayPal and given to subscriber to access the subscription
140. or the button you would like your customers to click when they check out and complete their purchases To display your own image enter the URL of the image s location in the URL field Step 6 Customize your payment pages Custom Payment Page Style Give your customers a seamless payment experience by customizing PayPal s payment pages to match the style of your website If you have already added Custom Payment Page Styles in your Profile they will be listed here Choose the page style you would like to appear when your customer clicks your Shopping Cart button For more information about adding selecting or changing custom page styles see Chapter 8 Custom Payment Pages Step 7 Customize your buyer s experience Successful Payment URL Enter the URL where you would like to send your customers after they have completed payment Once your customer has completed his payment he will see a payment confirmation page From this page he will click Continue and return to the Successful Payment URL you have specified If you do not enter a Successful Payment URL customers who click this link will be taken to a PayPal Web page Cancel Payment URL Enter the URL where you would like to send your customers if they cancel their payment at any point in the PayPal Shopping Cart payment flow If you do not enter a Cancel Payment URL customers who click this link will be taken to a PayPal Web page Step 8 Select other options
141. ord should be 8 characters minimum and is case sensitive Write it down Create PayPal Password Confirm PayPal Password Security Measure Enter the characters as they are shown in the box below This will further increase the security of your account and the PayPal network This is not your password Help META ae a MINO WD By clicking Continue I acknowledge that I have read and agree to PayPal s User Agreement Click Continue only once It will take an average of 60 seconds for your information to be submitted Continue Merchant User Manual and Integration Guide May 2005 45 46 Creating Buy Now and Donation Buttons How Buy Now and Donations Work Step 5 Bob is taken to a Payment Details page that contains the details of his purchase or donation Bob clicks Pay to complete his purchase or donation as shown in the following diagram For donations Bob would choose a shipping address before clicking Pay so Alice can send him a tax receipt The Shipping amount for this purchase 2 00 is automatically added to Bob s purchase because Alice has activated Profile based Shipping for all of her transactions To learn more about automatically calculating shipping for all of your transactions see Chapter 9 Calculating Shipping Handling and Tax Payments by PayPal E Payment Details Pay To Alice s Used Books User Status Verified Business Member 4 Payment For Herodotus The History Quanti
142. ory subtab 3 Find the payment you would like to refund 4 Click Details to open the Transaction Details page 5 Click the Refund Payment link on the Transaction Details page 6 Enter the partial refund amount and click Submit 7 Confirm the partial refund amount and click Process Refund Merchant User Manual and Integration Guide May 2005 109 Te Backend Integration Payment Notifications Processing Refunds 110 May 2005 Merchant User Manual and Integration Guide Using Multiple Currencies PayPal s Multiple Currencies feature gives you the ability to buy and sell globally Use your current PayPal account to make or accept payments in U S Dollars Canadian Dollars Euros Pounds Sterling and Yen Buyers e Pay for purchases in your selected currency e Payment is automatically converted to your desired currency e No need to hold a balance in another currency to send a payment Sellers Accept payments directly in your selected currency e No currency exchange costs when you withdraw funds to your local bank account e Manage multiple currency payments using your current PayPal account e Hold one currency balance and still accept payments in multiple currencies Receiving Money Receive payments in any of the currencies listed in Table 1 1 PayPal Supported Currencies Currency Codes and Maximum Transation Amounts on page 20 Premier and Business account holders have additional flexibility for mana
143. ou receive an error message about the background color the color is not allowed and you must choose a different color If a conflicting background color is passed through it will be considered invalid and PayPal will automatically default your background color to white Font Colors PayPal dynamically changes font colors from black to white depending on the background color To confirm that these font changes comply with your font color selections you should test your color settings on PayPal Image Storage PayPal recommends that you store your images on secure https servers If your images are not stored on secure servers your customers may be shown a browser warning indicating that you have insecure items on your page May 2005 Merchant User Manual and Integration Guide Calculating Shipping Handling and Tax You can set up your PayPal account to automatically calculate and charge shipping and sales tax also called value added tax Getting Started To view or modify your sales tax and shipping charges 1 Log in to your PayPal account at https www paypal com 2 Click the Profile subtab of the My Account tab 3 Click the Sales Tax or the Shipping Calculation link in the Selling Preferences column Sales or Value Added Tax Collection You can charge your customers tax by choosing a Country such as United Kingdom or State such as California from the Country and U S State drop down menus and
144. our password NeW For your security Confirm Step 3 Add Bank Account In order for PayPal to add funds to your bank account you must add it Before you add your bank account you will need a check or deposit slip for that bank account Log in to your PayPal account and click the Profile subtab of the My Account tab Click the Bank Accounts link in the Financial Information column On the Bank Accounts page click Add to reach the page shown in the following diagram Once you have added your bank account it will become your Primary bank account If you decide to add additional bank accounts to your PayPal account you can change any of them to be your primary account FIGURE 3 3 Adding a Bank Account Merchant Tools Auction Tools My Account Send Money Request Money Overview Add Funds Withdraw History Profile Add Bank Account The safety and security of your bank account information is protected by PayPal We protect against unauthorized withdrawals and will notify you by email whenever you deposit or withdraw funds from this bank account Bank Name U S Check Sample e Account Type Checking serssuwsg ooe seskaruearr Savings Routing Number ap A paaassuuaset 0012 14SL 7a0zI Is usually located between the w symbols on your check Account Number i Typically comes before the m symbol Its exact location and number of digits varies from bank to bank Retype Account w Number Add Bank Acco
145. password will be encrypted ID generated by PayPal for the subscriber 19 Merchant User Manual and Integration Guide May 2005 157 158 IPN and PDT Variables Subscriptions Variables Variables for Each Subscription Event The following table shows which variables are associated and can be included in IPN posts with each subscription event type About payment_status and txn_type with Subscription IPN Tn IPN messages posted by Subscription events the payment status variable is sent only when a payment occurs For all other events the pertiunent variable is txn_ type TABLE B 8 IPN Variables with Each Subscription Event Variable Signup Cancel Modify Basic Information business x X X receiver email X X X receiver id item name X X X item number X X X Advanced and Custom Information invoice X X X custom X X X option namel x x x option selecti X X X onl option name2 x x X option selecti xX X X on2 Transaction Information payment status pending reason reason code payment date txn id parent _txn id txn type subscr_ subscr_ subscr_ signup cancel modify Payment USD subscr_payment Payment Multi Currency Failed EOT X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X subscr _ subscr _ failed eot May 2005 Merchant User Manual and Integration Guide IPN and PDT Variables Boo Subscriptions Variables TABLE B 8 IPN Variables
146. ple items It s easy to set up and use just create a separate Add to Cart button for each item you sell and place the automatically generated HTML code for that button on your website next to the item Use the following steps to create your Shopping Cart buttons or if you are comfortable using HTML you can use the variables that are available in Appendix A to code your own buttons 64 May 2005 Merchant User Manual and Integration Guide Creating Shopping Cart Buttons CAE PayPal Shopping Cart Button Factory Note You also have the option of prepopulating your customer s signup information during the checkout flow For more information and a list of variables see Prepopulating Your Customer s PayPal Sign Up on page 141 Getting Started 1 Log in to your PayPal account at https www paypal com 2 Click the Merchant Tools tab 3 Select the PayPal Shopping Cart link under the Website Payments heading to get to the Button Factory Creating Your Shopping Cart Button Step 1 Enter the details for the item you wish to sell Item Name Service required Enter the name of the item or service you wish to sell Item ID Number If you have an ID or tracking number for your item enter it here This field will be displayed to your customers at the time of payment and will be shown in both the buyer s and seller s transaction details on the PayPal website Item Price required Enter the price of the
147. quantity Second option field name If omitted no variable will be passed back to you First set of option value s If this option is selected through a text box or radio button each value should be no more than 64 characters If this value is entered by the customer through a text box there is a 200 character limit If omitted no variable will be passed back to you onO must be defined for os0 to be recognized Second set of option value s If this option is selected through a text box or radio button each value should be no more than 64 characters If this value is entered by the customer through a text box there is a 200 character limit If omitted no variable will be passed back to you onl must be defined for os1 to be recognized Display Information cn cs image url Label that will appear above the note field This value is not saved and will not appear in any of your notifications If omitted no variable will be passed back to you Sets the background color of your payment pages If set to 1 the background color will be black If omitted or set to 0 the background color will be white The internet URL of the 150x50 pixel image you would like to use as your logo If omitted the customer will see your Business name if you have a Business account or your email address if you have premier account Character Length 127 127 64 64 64 200 see description 64 200 see description
148. r PayPal account at https www paypal com 2 Click the Profile subtab 3 Click the Website Payment Preferences link under the Selling Preferences column on the right Selling Preferences Auctions Sales Tax Shipping Calculations Shipping Preferences Payment Receiving Preferences Instant Payment Notification Preferences PayPal Shops Reputation Guarantee Preferences Seller Eligibility for PayPal Buyer Protection Website Payments scn 4 Under Auto Return for Website Payments click the On radio button to enable Auto Return Website Payment Preferences Back to Profile Summary Auto Return for Website Payments Auto Return for Website Payments brings your buyers back to your website immediately after payment completion Auto Return applies to PayPal Website Payments including Buy Now Donations Subscriptions and Shopping Cart Learn More Auto Return amp On off Return URL Enter the URL that will be used to redirect your customers upon payment completion This URL must meet the guidelines detailed below Learn More Return URL http Return URL Requirements The following items are required in order to set up Auto Return e Per the user agreement you must provide verbiage on the page displayed by the Return URL that will help the buyer understand that the payment has been made and that the transaction has been completed You must provide verbiage on the page displayed by t
149. r Payment Receiving Preferences are set to only accept payments from customers with Confirmed addresses then the buyer will skip over this Shipping Information screen and go directly to Billing Information in Step 4 Alice s Used Books Done Payments by PREPARA Welcome Shipping Billing Review Shipping Information Select a shipping preference and then click Continue Checkout below Shipping No shipping required online download payment for a service etc Shipping required book t shirt etc Please ship to the address I ve entered below Select the country for your billing and shipping addresses Both addresses must be in the same country Country United States y Select Country First Name Last Name Address 13 22 Address 2 optional City State y Zip Code 5 or 9 digits Country United States Billing Address Is the above address also your credit card billing address Yes C No If no we ll ask you for it later Continue Checkout Cancel Merchant User Manual and Integration Guide May 2005 37 38 PayPal Account Optional Your Customer s Experience Step 4 Bob is then prompted to fill in his billing information for the credit card he wishes to use for the purchase The purchase will be shipped to the shipping address he has provided Alice s Used Books Payments by PEARS welcome Shipping Billing Review Done Billing Information
150. r those wishing to implement SSL on their own Web servers General Information e SSL Review independent http sslreview com ssl certificate content ssl certificate html e Installing on Apache and Microsoft IIS Web servers http www thawte com guides e Windows Server 2003 http www microsoft com resources documentation windowsserv 2003 all deployguide en us iisdg_mea_nfmd asp e Apache http www apache ssl org and http modssl org SSL Certificate Providers e Verisign http www verisign com e GeoTrust http www geotrust com e Others http sslIreview com ssl certificate content ssl certificate html 130 May 2005 Merchant User Manual and Integration Guide HTML Samples PayPal Buy Now and Donation Buttons HTML and Variables By understanding how your Buy Now Button HTML code and hyperlinks work you can edit the attributes of your buttons or create appropriate Buy Now code on the fly for each payment This can be used to collect aggregated payments with your shopping cart Integrating Buy Now Buttons with your Shopping Cart To integrate Buy Now Buttons with your shopping cart your shopping cart will need to populate the necessary Buy Now fields when your customers proceed to checkout The following tables itemize the different parameters within the Buy Now Buttons HTML code and the Buy Now hyperlink Sample Buy Now Button HTML The HTML for a Buy Now Button looks s
151. s and should be investigated e Confirm that the payment status is Completed since IPNs are also sent for status types such as Pending or Failed e Check that the transaction ID is not a duplicate this prevents a fraudster from using an old completed transaction e Validate that the receiver email is truly your account this prevents the payment from being sent to a fraudster s account e Check other transaction details such as item number and price to confirm that the price hasn t been changed Checks are performed El payment_status Completed Your Server El txn_id not a duplicate O receiver_email me email com E Step 6 After successfully completing the checks you can update your database with the IPN data and process the purchase Your Server a A TRUE r Verified TRUE Process Order Now E Merchant User Manual and Integration Guide May 2005 105 106 Backend Integration Payment Notifications Instant Payment Notification IPN Setting Up IPN To set up IPN 1 Log in to your Business or Premier PayPal account 2 Click the Profile subtab 3 Click the Instant Payment Notification Preferences link in the Selling Preferences column 4 Click Edit 5 Click the checkbox and enter the URL at which you would like to receive your IPN Notifications 6 Click Save Alternatively you can activate IPN by including the notify url field in your PayPal
152. s USD payments For more information about IPN multi currency variables see Currency and Currency Exchange on page 152 Dispute Notification Buyers can register claims about payments such claims are called cases PayPal notifies merchants about new cases with email and with IPN There are two kinds of cases e Complaint A buyer has used the PayPal Resolution Center to register a claim about a payment to a merchant Note After notification about a complaint claim merchants must log in to PayPal to use the Resolution Center to respond to the case e Chargeback A buyer has filed a complaint with a credit card company that has resulted in a chargeback The credit card company notifies PayPal about the reason for the chargeback After investigating the case PayPal notifies the merchant of any action required IPN variables for cases include the type of case the reason and other information about the case For details about all variables and their possible values see Dispute Notification Variables on page 56 Processing Refunds You can send a refund to your buyer for 60 days after receiving payment by using the refund link on the Transaction Details page If it has been more than 60 days since you received the payment you should send the refund using Send Money To send a refund within 60 days of receiving payment 1 Log in to your PayPal account Click the History subtab Find the payment you would like t
153. s Used Books Contact Email help mystore com Contact Phone 988 898 8888 Click here to continue Step 3 At the time the payment is made PayPal will post a notification to your server at the URL you specified All of your customer s payment information and a piece of encrypted code will be included in this notification 0101010101101 Your Server 0001100001010 value HIS 001 value 17 00 value sales tax 0101010101101 gt Step 4 On receiving the notification your server will send the information including the encrypted code back to a secure PayPal URL PayPal will authenticate the transaction by checking the encrypted string This post back of the IPN data to PayPal prevents spoofing 104 May 2005 Merchant User Manual and Integration Guide Backend Integration Payment Notifications ea Instant Payment Notification IPN so you can be sure the IPN came from PayPal Upon verification PayPal will send your server a VERIFIED or INVALID response 0101010101101 Your Server 0001100001010 value HIS 001 value 17 00 value sales tax 0101010101101 E E ES Ea 444 4440 4440 4440 444 Q Verified Step 5 When you receive a VERIFIED response you need to perform several checks before fulfilling the order Note An INVALID response could be due to inaccurate or incomplete IPN data being posted back to PayPal However an INVALID response should be treated as suspiciou
154. s dl Amount 142 50 USD If you have never paid through PayPal _ Click Here PayPal Login Email Address pdeboe paypal cOM problems logging in PayPal Password Forget your password Continue Step 3 Bob enters his PayPal account information into the PayPal Login fields These pages are not included in this example Note At this point buyers that do not already have a PayPal account click the If you have never paid through PayPal Click Here button The Payment Details page then displays credit card email password and security fields that can be used to create a new PayPal account After the new account is created the the buyer clicks Continue to proceed to the next step in the payment process May 2005 Merchant User Manual and Integration Guide Auto Return How Auto Return Works Step 4 Bob is then taken to a confirmation page that displays the details of his selection information about how his automatic payments will be funded and his shipping information He clicks Pay to complete payment Payments by LEPAR gt Confirm Your Payment Check the following details and click the Pay button below to complete your payment Pay To Globe Industries Inc User Status Unverified Business Member 0 Payment For Widget Quantity 1 Currency U S Dollars E Amount 142 50 USD Shipping amp Handling 20 00 USD Total Amount 162 50 USD Source of Funds U S Dollar Balance 162 50 USD More Fund
155. s successful payment He is also given Alice s customer service email You Made A Payment Payment Information A payment of 17 00 has been sent to Alice s Used Books You will receive an email receipt for this transaction shortly For details on your transaction please contact Alice s Used Books Item Name Herodotus The History Add free gift wrap No How did you hear about us PayPal Shops Featured Shop Item Number HIS 0001 Shipping amp Handling 2 00 Amount 15 00 Quantity 1 Total Amount 17 00 Contact Information Business Name Alice s Used Books Contact Email help mystore com Contact Phone 988 888 8888 Click here to continue With Auto Return for Website Payments Bob would be redirected back to your site immediately after clicking the Pay button on the Payment Confirmation page To learn more about Auto Return see Chapter 11 Auto Return Step 8 Bob receives an email receipt for this transaction confirming payment and including a copy of the Payment details Receipt for your Payment Message Plain Text ioj x Eile Edit Yiew Insert Format Tools Actions Help From service paypal com Sent Tue 5 14 2002 6 22 PM This email confirms that you have paid Alice s Used Books 37 00 using PayPal SHOPPING CART CONTENTS 1 Item Name Homer The Illiad amp The Odyssey Item Number HIS 0125 Item Amount 20 00 Quantity 1 Total 20 00 Item Name Herodotus The
156. sages 2 a a 81 Chapter 9 Calculating Shipping Handling and Tax 83 Getting Started o cess cra A ee 83 Sales or Value Added Tax Collection 0 0 00 00 eee ee 83 Overriding Tax Setting Per Transaction 0 00002 83 shipping Calculation ge caca eee ra es Oe ak ee de e a a as 84 Flat AMOUNE oe eae es Ra a ad OAR AEE Boe OOS RES RR a 84 Percentage ms e id Poe ee be ee ae a da 84 Overriding Your Shipping Calculation o e 2 84 Chapter 10 Creating Customer Contact Telephone 87 How It WOKS i a o ee a we a ea ee ee eee A A Be a 87 What YOU Sep a oe a ah a ae sa ae ea a Ta ee hae da 87 What Your Customer Sees 000 eee ee 88 Getting Started cas ica bee a eR a ee ae le bok bee 88 Notifications You Receive ee 88 Chapter 11 Auto Return eee ee 2 8Y How Auto Return Works 89 Setting Up Auto Rem sg s s ues ro ee Be aa ee we ee Boe es eta 93 Subscription Password Management and Auto Return 94 Chapter 12 Backend Integration Payment Notifications 95 EmMa gece odo heh ed ee dd a da dil ee ae a ae Sea 95 IREPOMING fs A eee aa a Ge OSes A he a Pe See Pees 95 Instant Payment Notification IPN and Payment Data Transfer PDT 96 Payment Data Transfer 2 e 96 Merchant User Manual and Integration Guide May 2005 7 all Contents
157. se the rest of the body of the response will be the transaction details one per line in the format key value where key and value will both be URL encoded strings This response data needs to be parsed appropriately and then Web decoded Example successful response SUCCESS first_name Jane Doe last _name Smith payment status Completed payer email janedoesmith s40hotmail com payment gross 3 99 mc_currency USD Merchant User Manual and Integration Guide May 2005 101 102 Backend Integration Payment Notifications Payment Data Transfer custom For the purchasetof the rare book Green Eggs 526 Ham If the response is FAIL PayPal recommends making sure that the e Transaction token is not bad e ID token is not bad e Token or tokens has not expired When using Auto Return you must display verbiage on the page displayed by the Return URL that will help the buyer understand that the payment has been made and that the transaction has been completed as well as verbiage that explains that payment transaction details will be emailed to the buyer You may display to your customer whatever payment details you feel are appropriate however PayPal recommends including the e Item name e Amount paid e Payer email e Shipping address If you are using PDT to determine when to fulfill an order automatically confirm that the payment status is Completed since the buyer could use methods such as echecks that do not im
158. se Buyer claims that the received merchandise is unsatisfactory defective or damaged special Some other reason Usually special indicates a credit card processing error for which the merchant is not responsible and for which no debit to the merchant will result PayPal must review the documentation from the credit card company to determine the nature of the dispute and possibly contact the merchant to resolve it Merchant User Manual and Integration Guide May 2005 161 162 IPN and PDT Variables PDT Specific Variables PDT Specific Variables The following variables apply only to PDT TABLE B 10 PDT Specific Variables Variable Description The transaction ID PDT token tx st amt cc cm The transaction status Pending The amount of the transaction Currency code Custom message May 2005 Merchant User Manual and Integration Guide Country Codes ISO 3166 Standard Country Codes PayPal relies on two character country codes defined by International Standards Organization ISO 3166 TABLE C 1 ISO 3166 Two Character Country Codes Country Code Anguilla Al Argentina AR Australia AU Austria AT Belgium BE Brazil BR Canada CA Chile CL China CN Costa Rica CR Denmark DK Dominican Republic DO Ecuador EC Finland FI France FR Germany DE Greece GR Hong Kong HK Iceland IS India IN Ireland IE May 2005 163 Country Codes ISO 3166 Standard Country Codes TABL
159. set of values that correspond to each item that was purchased via your third party cart Append _x to the variable name where x is the item number starting with 1 and increasing by one for each item included in the shopping cart TABLE A 4 Variables for Individual Items in Third Party Shopping Carts Character Name Description Length item name X Required for item x Name of item x in the cart Must be 127 alphanumeric item number xX Pass through variable for you to track purchases or 127 donations It will get passed back to you at the completion of the payment If omitted no variable will be passed back to you amount xX Required for item x Price of the item x quantity x Required for item x Quantity of the item x shipping x The cost of shipping the first piece quantity of 1 of item FX Merchant User Manual and Integration Guide May 2005 139 OA HTML Samples PayPal Shopping Cart HTML and Variables TABLE A 4 Variables for Individual Items in Third Party Shopping Carts Character Name Description Length shipping2 x The cost of shipping each additional piece quantity of 2 or above of item x handling X The cost of handling for item x tax Xx The tax amount for item x on0 xX First option field name for item x 64 os0 xX First set of option value s for item x on0_x must be 200 defined for os0_x to be recognized onl x Second option field name for item x 64 osl x Second set of option value s for item
160. special characters and is NOT case sensitive User ID henry_jones Re enter User ID henry_jones Password es Re enter Password Pess Multi User Access Check the box next to each of the privileges for which this user has permission M Send Money FP withdraw Funds M Mass Payments M Cancel Payments M Request Money F View Balance I Add Funds E View Profile T Refunds E Edit Profile FP bill Pay _ Scheduled Downloadable Log You might want to establish a separate username and password for each employee who accesses your PayPal account and grant each user the minimum access necessary If an employee forgets or loses a password you can always log in and reset it Note Remember to revoke privileges of any employee that leaves the company 5 You can create additional logins edit an existing user s privileges or delete a login at anytime from your Profile Merchant User Manual and Integration Guide May 2005 129 Using Secure Socket Layer SSL Using Secure Socket Layer SSL If you have contracted with a third party hosting provider to operate your Web site PayPal recommends contacting your provider to find out if you already have SSL capabilities or if you need to have SSL installed Most hosting providers can activate SSL for your hosting account If you are operating your own Web server you will need to acquire and install your own SSL certificates The following information and resources may be useful fo
161. ssociated with the payment payment gross minus specific for payment fee will equal the amount deposited into the receiver email USD payments account Will be empty for non USD payments This is a legacy field replaced only by mc_ fee If this amount is negative it signifies a refund or reversal and either of those payment statuses can be for the full or partial amount of the original transaction fee Auctions TABLE B 5 IPN and PDT Variables Auctions Character Variable Name Possible Values Description Length for auction true This is an auction payment payments made using Pay for eBay Items or Smart Logos as well as Send Money Money Request payments with the type eBay items or Auction Goods non eBay auction This is the customer s auction ID 64 buyer id auction _ This is the auction s close date closing_ date Merchant User Manual and Integration Guide May 2005 153 154 IPN and PDT Variables Mass Payment TABLE B 5 IPN and PDT Variables Auctions Variable Name auction _ multi item Possible Values Character Description Length This is a counter used for multi item auction payments It allows you to cumstomize your script to only count the mc_gross or payment gross for the first IPN you receive from a multi item auction auction multi_item since each item from the auction will generate an Instant Payment Notification showing the amount for the entire auction Mass Payment
162. t Creek CA 95599 Please print this page for your records A receipt for your purchase has also been emailed to you Global Industnes Inc All nghts reserved 2003 Step 7 Bob receives an email receipt for this transaction confirming his purchase and including a copy of the payment details the Widget Warehouse s business information and his confirmed shipping address The way to send and LENA REL receive money online Protect Your Account Info Dear Bob Deboe Make sure you never provide your F password to fraudulent websites This email confirms that you Bob Deboe have paid Widget Warehouse 162 50 using PayPal To safely and securely access the PayPal website or your account open up a new web browser e g Internet Explorer or Netscape and type in the PayPal URL h https www paypal com to be Payment Details sure you are on the real PayPal site Amount 162 50 USD PayPal will never ask you to enter your ii password in an email Transaction ID 78H54514UY26 For more information on protecting yourself Quantity 1 from fraud please review our Security Tips Item Product Wi at Produet widget https www paypal com securitytips Protect Your Password You should never give your PayPal password to anyone including PayPal employees 92 May 2005 Merchant User Manual and Integration Guide Auto Return Setting Up Auto Return Setting Up Auto Return To set up Auto Return 1 Log in to you
163. t operations e Store transaction information in your own database To activate Instant Payment Notification you will need to go to your Profile to enter the URL at which you would like to receive notification posts Once you activate IPN you will receive an IPN when a payment is first sent which will state the status of the payment Completed or Pending If the payment was Pending you will receive another IPN when the payment clears fails or is denied IPN can be seamlessly integrated with each of the PayPal Website Payments solutions Buy Now Buttons PayPal Shopping Cart Subscriptions and Recurring Payments and Donations as well as with regular PayPal Send Money and Mass Pay payments and lets you focus on selling not on manually tracking your orders How It Works When a customer makes a payment to you or a payment is reversed or refunded PayPal will post a notification to your server at the URL you specified Included in this notification will be all of your customer s payment information e g customer name payment amount as well as a piece of encrypted code When your server receives a notification it will then post the information including the encrypted code back to a secure PayPal URL PayPal will authenticate the transaction and send confirmation of its validity back to your server After you have activated Instant Payment Notification your server will be sent a notification every time you receive a payment Th
164. ting 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 e Refunds A PayPal user providing a refund of money paid by another participant in a transaction e 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 PNSs 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 e 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 e 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 a
165. tion about Custom Payment Page see Chapter 8 Custom Payment Pages Calculating Shipping Handling and Tax You can set up your PayPal account to automatically calculate and charge shipping and sales or value added tax as well as specify a different tax rate for each of the 50 U S states and any of the countries listed In addition you can charge shipping costs as a fixed rate based on the amount of the total purchase or as a percentage of the purchase price You also have the option to assign shipping amounts to individual products May 2005 Merchant User Manual and Integration Guide PayPal Payments Overview EN Contact Telephone Number For more information about shipping and tax see Chapter 9 Calculating Shipping Handling and Tax Contact Telephone Number The Customer Contact Information Telephone field provides merchants with a contact telephone number for their buyer In accordance with our User Agreement merchants may only use this Contact Telephone Number to communicate with buyers about the related purchase This number may not be used for unsolicited commercial messages Auto Return Auto Return for Website Payments allows merchants to eliminate the Payment Receipt page in the Website Payments flow and automatically return or redirect buyers to their website upon payment completion For more information about Auto Return see Chapter 11 Auto Return Back end Integration Methods Th
166. transaction details to buyers who are redirected back to their site upon payment completion For more information about PDT see Payment Data Transfer on page 96 Payment Receiving Preferences Once you have set up your PayPal account you re ready to start receiving payments Your Payment Receiving Preferences let you manage the types of payments you receive For more information about Payment Receiving Preferences see Payment Receiving Preferences on page 31 Refunds You can automatically send a refund to your buyer for 60 days after receiving payment by using the refund link For more information about sending refunds see Processing Refunds on page 108 Multi User Access PayPal s Multi User Access feature allows you to set up multiple logins and access levels so your employees only have access to the parts of your Paypal account that they need to complete their jobs letting you run your business smoothly and securely For more information about Multi User Access see Multi User Access on page 128 Reports PayPal s Reporting Tools provide you with the information you need to effectively measure and manage your business With PayPal s Reporting Tools you can e Analyze your revenue sources to better understand your customers buying behavior e Automate time consuming bookkeeping tasks e Accurately settle and reconcile transactions May 2005 Merchant User Manual and Integration
167. ty 1 Amount 15 00 Shipping amp Handling 2 00 Total Amount 17 00 Source of Funds Credit Card 17 00 from MasterCard XXXX XXXxX XxXxXX 0439 More Funding Options Shipping Information Ship to 10245 SW Arborcrest Way Portland OR 97225 USA Confirmed y Add C No shipping address required Additional information Note Information entered in this box may be sent to the recipient in an unencrypted email e za Pay Cancel May 2005 Merchant User Manual and Integration Guide Creating Buy Now and Donation Buttons E How Buy Now and Donations Work Step 6 Bob is taken to a payment completion page where he sees the details of his transaction He is also given Alice s customer service email address He clicks the Continue link and is returned to a page on Alice s website which she specified when she created her payment or donation button Payments by PayPalf You Made A Payment Payment Information A payment of 17 00 has been sent to Alice s Used Books You will receive an email receipt for this transaction shortly For details on your transaction please contact Alice s Used Books Item Name Herodotus The History Item Number HIS 0001 Shipping amp Handling 2 00 Amount 15 00 Quantity 1 Total Amount 17 00 Contact Information Business Name Alice s Used Books Contact Email help mystore com Contact Phone 888 888 8888 With Auto Return for Website Payments Bob is redirected back to
168. ty Questions If you forget your password we will use the answers you provide to the security questions to verify your identity Please select 2 different questions Sacurtty Guestion a Echoossa questo E answerer security Guestian 2 choose Another eston Il answer By clicking Continue I acknowledge that I have read and agree to PayPal s User Agreement Save Information Cancel Step 8 Bob sees a page that confirms the creation of his account Alice s Used Books Payments by REPAR Your New PayPal Account Congratulations You have securely saved your payment information with PayPal You can use your new account to pay for auctions and other online purchases from PayPal merchants Check your email for more information about your new PayPal account Continue If he clicks Continue he will be redirected to either Alice s site or to PayPal depending on how she has set her return preferences for the button Merchant User Manual and Integration Guide May 2005 41 PayPal Account Optional Your Customer s Experience Step 9 Bob receives an email receipt for this transaction confirming his payment and including a copy of his Payment details From service paypal com Sent Tue 5 14 2002 6 21 PM This email confirms that you have paid Alice s Used Books 17 00 using PayPal Amount 17 00 Transaction ID 4KK313372N3534454 Total shipping 2 00 Quantity 1 Item Product Name Herodotus The History
169. ues txn typ new cas txn id Description A new case has been registered The merchant s original transaction identification number for the payment from the buyer against which the case was registered May 2005 Merchant User Manual and Integration Guide IPN and PDT Variables Dispute Notification Variables TABLE B 9 Dispute Notification Variables Possible Variable Values Description case id Case identification number Format PP nnn nnn nnn where n is any numeric character case type complaint e complaint A buyer has logged a complaint through the chargeback PayPal Resolution Center e chargeback A buyer has filed a chargeback with his credit card company who has notified PayPal of the reason for the chargeback case _ Transaction Date and time case was registered in specific Format HH mm ss mon DD YYYY TZ date i where TZ is a three character time zone reason code Depends on Reason for the case value of case_type reason_code Values for case_type complaint non receipt Buyer claims that he did not receive goods or service not_as_ Buyer claims that the goods or service received differ from described merchant s description of the goods or service reason_code Values for case_type chargeback unauthorized Buyer claims that he did not authorize transaction non receipt Buyer claims that he did not receive goods or service duplicate Buyer claims that a possible duplicate payment to merchant merchandi
170. unt Cancel In order for PayPal to confirm that you are the owner of the bank account PayPal will send two small deposits each of less than 1 00 to your bank account Check your bank statement in 3 4 business days or check online for the amounts of the two deposits After getting the deposit amounts log in to your PayPal account and click the Confirm Bank Account link in the Activate Account box on your Account Overview Enter the amounts of each of the deposits on the page and your bank account will be confirmed and you will become Verified Step 4 Add Credit Card optional Log in to your PayPal account and click the Profile subtab of the My Account tab as shown in the following diagram Click the Credit Cards link in the Financial Information column On the Credit Cards page click the Add button The credit card you added will become your primary credit card meaning it is the default May 2005 Merchant User Manual and Integration Guide Getting Started Managing Your PayPal Merchant Account credit card used on your PayPal account If you decide to add additional credit cards to your PayPal account you can select any of them as your primary card My Account Send Money Request Money Merchant Tools Auction Tools Overview Add Funds Withdraw History Profile In addition the credit card billing address you entered when you added your credit card is now a Confirmed Address Many sellers require that buyers
171. urn 20002 eee ee Back end Integration Methods Instant Payment Notification Payment DataTransfer Payment Receiving Preferences 4 Refunds cet eG Reed ale ee A a ee G a 3 Getting Started Managing Your PayPal Merchant Account Account Profile 20 00022 eee Payment Receiving Preferences Chapter 4 PayPal Account Optional Turning PayPal Account Optional On or Off Merchant User Manual and Integration Guide May 2005 15 19 20 20 21 21 21 22 22 22 23 23 23 23 24 24 24 24 24 25 26 27 29 29 31 35 all Contents Your Customers Experience ee 36 What Your Customer Sees o 36 Chapter 5 Creating Buy Now and Donation Buttons 43 How Buy Now and Donations Work 2 0 e e eo 43 What Your Customer Sees 0000 eee ee 44 What YOu See a bone bee k a eh Goan ea A ae Ra ed a 48 Buy Now and Donations Button Factory 2 0 0 0 ee ee 49 Getting Started ea 49 Creating a Buy Now Button e e 50 Creating a Donations Button 2 2 2 2 ee 53 How You Get YourMoney 2 2 a 55 Notifications You Receive 56 pe art ou pu eee ee Gece hee ee Bk ea O Ge ates Pe ee S 56 Fa dba eae Se eae a a a Be Popa ae Eee S amp S 56
172. us Shipping Address If you would like your customers to be prompted to provide a shipping address choose Yes If you choose No your customers will not be asked to provide a shipping address Step 6 Collect additional information from your customers Note Title If you are allowing your donors to include a note with their payment you may choose a title for the note field By including a title you can prompt your buyers to enter specific information such as a User ID or special instructions There is a 40 character limit on your note field title If you do not enter a title your customers will see Special Instructions optional as the note field title Note Select Yes if you would like your donors to be able to include a note to you with their payment If you select No your donors will not be given the opportunity to include a note Step 7 Choose an email address to receive payment If you have more than one confirmed email address attached to your PayPal account you can specify the address at which you would like to receive your email payment notifications when your donors pay you Step 8 Copy and Paste the Donations code When you have finished filling out the Donations Button Factory form click Create Button Now If your donors will be donating through your website 1 Copy the code from the For Web pages text box by highlighting all of the text and pressing Ctrl C or by highlighting all of the
173. use currency code is not item specific there is no need to append x to the currency code variable name If no currency code variable is posted we will assume that all monetary values are in U S Dollars To specify cart wide tax Use the tax_cart variable to specify a tax amount that applies to the entire purchase rather than to individual items The tax cart variable overrides any per item tax amount specified with tax x For a complete list of variables see the Passing Individual Items to PayPal section of Appendix A in this manual 72 May 2005 Merchant User Manual and Integration Guide Custom Payment Pages With our Custom Payment Pages feature you can tailor PayPal s payment pages to the style of your website for a truly seamless payment experience Make PayPal s payment flow yours with custom page colors and your own images Custom Payment Pages can be used with all PayPal Website Payment buttons including Buy Now Donations Shopping Cart and Subscriptions It is also compatible with the PayPal Account Optional feature and will apply your choices to the pages in that payment flow Examples of Custom Payment Pages The pictures in this section demonstrate the types of customization you can add to your PayPal Website Payment buttons Figure 8 1 Payment Page in Standard PayPal Page Style shows a payment page without any customization FIGURE 8 1 Payment Page in Standard PayPal Page Style Payments by FET P
174. use their Confirmed Address as their shipping address when they pay with PayPal You can use Confirmed Addresses as a positive indicator of a buyer s identity When you ship to a Confirmed Address you can qualify for protection under PayPal s Seller Protection Policy For more information about PayPal s Seller Protection Policy see the PayPal User Agreement which is available on the PayPal website Step 5 Start Receiving Payments Now that you ve set up everything in your PayPal account you re ready to start receiving payments Alice s Used Books Home Art Biography History Literature Mystery Crocodile on the Sandbank By Elizabeth Peters Join Amelia Peabody in her first Egyptian adventure This book has it all romance intrigue murder irritable archaeologists and lest we forget a bona fide mummy Even better after you ve read your first Amelia there are 14 more books in the series to keep you awake at night Price 4 95 52 400 ro cant Managing Your PayPal Merchant Account Account Profile The PayPal account Profile consolidates all of the different settings and preferences for your account You can use your Profile to manage all of the information in your PayPal account To go to your Profile log in to your PayPal account and click the Profile subtab of the My Account tab as shown in the following diagram Y our Profile is organized in three sections for managing your account
175. uto Return once your customer has completed his payment he will see a payment completion page From this page he will click Continue and return to the Successful Payment URL you have specified If you do not enter a Successful Payment URL customers who click this link will be taken to a PayPal Web page Cancel Payment URL Enter the URL where you would like to send your customers if they cancel their payments at any point in the Buy Now payment flow If you do not enter a Cancel Payment URL customers who click this link will be taken to a PayPal Web page Merchant User Manual and Integration Guide May 2005 51 52 Creating Buy Now and Donation Buttons Buy Now and Donations Button Factory Step 8 Miscellaneous Options Quantity If you would like to let your customers purchase more than one of your item or service choose Yes They will then be prompted to enter the quantity of the item they want to buy If you choose No the quantity will be set to 1 and your customers will only be able to purchase one item per payment Shipping Address If you would like your customers to be prompted to provide a shipping address choose Yes If you choose No for items such as digital goods your customers will not be asked to provide a shipping address Step 9 Collect additional information from your customers Note Select Yes if you would like your customers to be able to include a note to you with their payment If you select
176. w and Donations buttons Or if you are comfortable using HTML you can use the variables that are available in Appendix A to code your own buttons Getting Started 1 Log in to your PayPal account at https www paypal com 2 Click the Merchant Tools tab 3 Click the Buy Now Buttons or Donations link under the Website Payments heading to open the Button Factory Merchant User Manual and Integration Guide May 2005 49 Creating Buy Now and Donation Buttons Buy Now and Donations Button Factory Creating a Buy Now Button Step 1 Enter the details for your item all fields are optional Item Name Service Enter the name of the item or service you wish to sell If you do not enter anything in this field your customers will be able to complete it at the time of purchase PayPal recommends entering an Item Name to make it easier for you to ship the order Item ID Number If you have an ID or tracking number for your item enter it here This field will not be displayed to your customers at the time of payment but they will see it in their transaction details on the PayPal website Item Price Enter the price of the item you wish to sell If you do not enter anything in this field your customers will complete it PayPal recommends entering an Item Price to make it easier for you to collect the correct amount Currency Choose the currency in which you would like this payment to be denominated This field will default to the curre
177. with Each Subscription Event Payment Multi Payment Currency Variable Signup Cancel Modify USD Failed EOT Currency and Exchange information mc gross X X mc fee X X mc currency x x x x x x X settle amount X X exchange_rate X X payment gross X X x payment fee x Buyer Information first name X X X X X X X last_name X X X X X X X payer business X X X X X X _ name address_name X X X X X X address_street X X X X X X address_city X X X X X X address_state X X X X X X address_zip X X X X X x address countr X X X X X X Y payer email x x x x x X x payer id X X X X X X X payer status X X X X X X X payment type X x Subscription Information subscr date x x x subscr_ X effective periodl X X X Merchant User Manual and Integration Guide May 2005 159 160 IPN and PDT Variables Dispute Notification Variables TABLE B 8 IPN Variables with Each Subscription Event Payment Multi Payment Currency Variable Signup Cancel Modify USD Failed EOT period2 X X X period3 X X X amount1 X X X amount2 X X X amount3 X X X mc amount1 X X X mc_amount2 X X X recurring X X X reattempt X X X retry at X recur times X X X username X X X X X X X password X X X X X X X subscr id X X X X x x X Dispute Notification Variables Variables related to customer dispute cases are detailed in Table B 9 Dispute Notification Variables on page 160 TABLE B 9 Dispute Notification Variables Possible Variable Val
178. ws the details of the payment he is about to make He is prompted to log in to his PayPal account but he is not already a PayPal member so he clicks Continue Checkout Alice s Used Books Payments by PREPARED Welcome Shipping Billing Review Done Payment Details Pay To Alice s Used Books Payment For Herodotus The History Currency U S Dollars Ed Amount 15 00 USD Shipping amp Handling 2 00 USD Secure transaction hosted by PayPal Make a Payment Alice s Used Books uses PayPal to process credit card payments This credit card transaction will appear on your bill as PAYPAL ALICESUSEDB If you have a PayPal account lagin now If you don t have a PayPal account and want to pay with a credit card Email Address Continue Checkout PayPal Password Login Problems logging in Forget your password 36 May 2005 Merchant User Manual and Integration Guide PayPal Account Optional ES Your Customer s Experience Step 3 Bob is prompted to enter the shipping information for his purchase and to let Alice know if the shipping address he has entered is the same as the billing address on his credit card If it is he clicks Yes Bob is then taken to the Billing Information page as shown in Step 4 where the Billing and Shipping Address information has been prepopulated however Bob will still need to enter his credit card information email phone and security measure code Norte If you
179. yPal Buy Now Buttons HTML Code and Variables section of Appendix A TABLE A 2 Shopping Cart Variables Character Name Status Description Length handling _ Optional Single handling fee to be charged cart wide If cart handling cart is used in multiple Add to Cart buttons the handling cart value of the first item will be used Adding PayPal Checkout To Your Third Party Shopping Cart Required Variables The code for your PayPal post requires the following three hidden variables and an image as the form submit TABLE A 3 Third Party Shopping Cart Variables Name Description business Email address on your PayPal account item name Name of the item or a name for the Shopping Cart amount Price of the item the total price of all items in the Shopping Cart This means that the minimum required code for your post to PayPal will look like this lt form action https www stagelb paypal com cgi bin webscr method post gt lt input type hidden name cmd value _ cart gt lt input type hidden name upload value 1 gt lt input type hidden name business value franck reg paypal com gt lt input type hidden name item name 1 value Item Namel gt lt input type hidden name amount_1 value 1 00 gt lt input type hidden name item name 2 value Item Name2 gt lt input type hidden name amount_ 2 value 2 00 gt lt input type
180. you do not designate page style as Primary the default PayPal page style is used To make a page style Primary 1 Begin at the Custom Payment Page Styles page For more information see Getting Started on page 75 2 Click the radio button next to the page style you wish to make your Primary style 3 Click Make Primary 4 Click Make Primary to confirm your choice Removing a Page Style When you remove a page style the payment pages to which the style applied will no longer be customized with those specifications Instead your Primary page style will be applied to those pages If you remove your Primary page style the PayPal page style will become Primary To remove a page style 1 Begin at the Custom Payment Page Styles page For more information see Getting Started on page 75 2 Click the radio button next to the page style you wish to remove 3 Click Remove 4 Click Remove to confirm your choice Overriding Page Style Settings Y our Primary page style will automatically be applied to all of your payment pages unless you specify otherwise To apply a page style other than your Primary style select a different one when creating your button Just click Add More Options on the button creation page and select a page style from the Custom Payment Page Style menu Merchant User Manual and Integration Guide May 2005 79 az Custom Payment Pages Overriding Page Style Settings To change the page sty

Download Pdf Manuals

Related Search

Related Contents

WLAN Modem - UPC Cablecom  FLC-1500Hf 取扱説明書  neta participant test service user guide  User`s Guide  Samsung DVD-P171 manual de utilizador  Futrex Scale -5000/XL User's Manual  USER`S MANUAL - Mr Handsfree  CFW100 - CCAN - CANopen Communication Module User`s Manual  利用ガイドおよび重要事項説明書（PDF）  Forteo® Pen / Stylo Forteo®  

Copyright © All rights reserved. Failed to retrieve file