Home

PayPal Website Payments Standard Checkout

1. 4 RRETUAGS saxo be tot ld a te eek Bod Se ih ane de te S 3 Getting Started Account Profile a aia oi A eee he A es ae ewe do Account Information 2 Financial Information 2 Selling Preferences 0 000004 2 eae Payment Receiving Preferences Blocking Payments 000002 eee 4 Account Optional Turning PayPal Account Optional On or Off 2 2 Website Payments Standard Checkout Integration Guide May 2005 13 15 15 16 17 17 17 18 18 18 19 19 19 19 19 20 20 21 23 24 25 25 26 27 28 31 all Contents Your Customers Experience a a a a a 32 What Your Customer Sees aoao a a a a a 32 Chapter 5 Creating Buy Now and Donation Buttons 39 How Buy Now and Donations Work a aaa a a 39 What Your Customer Sees a 40 What YOU SeS so aad o a ah i da eee eh dik ee A ee Ae iie G o ed 44 Buy Now and Donations Button Factory oaoa a 45 Getting Started a aoaaa 45 Creating a Buy Now Button aa aaa a 46 Creating a Donations Button o e 2 eo 49 How You Get YourMoney 2 2 a 51 Notifications You Receive o 51 Emails aa aa a a Gos ee A AAA A Se 51 HISO o eea a a a a a we a 52 Downloadable Logs rrr etae sa Keenen 52 Chapter 6 Creating Shopping Cart Buttons 55 How EWOTK
2. 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 you 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 Website Payments Standard Checkout 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 Profi
3. Accept this payment convert if to 47 339 0 5 Dollars and transfer if to ma U S Dolar Balance Accapt this payment in Euros and create a Euro Balance in my PayPal account O Deny this payment You can also set up your Payment Receiving Preferences to indicate how you would like to handle incoming currency payments 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 A 8 IPN Variables with Each Subscription Event on page 52 for more information about Multiple Currencies variables May 2005 Website Payments Standard Checkout Integration Guide Using Multiple Currencies Managing Currency Balances Managing Currency Balances You can manage your currency balances in the Currency Balances section of your Profile 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 Website Payments Standard Checkout Integration Guide May 2005 101 Pe Using Multiple Currenc
4. 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 multiple 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 60 May 2005 Website Payments Standard Checkout Integration Guide Creating Shopping Cart Buttons PayPal Shopping Cart Button Factory Norte 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 Prepop
5. a ee ee 21 Business Account Signup 1 ee ee ee ee eee 23 Confirming Your Email Address 4 24 Merchant Profile Page 2 22 2244 25 Payment Receiving Preferences 5 6444 27 Payment Page in Standard PayPal Page Style 75 Payment Page with Custom Style Header Image and Header Border 76 Payment Page with Custom Style Header Image Image Border and Background Color 77 Editing Page Style Settings 4 4 80 Example of Unallowed Background Color 83 Example of Allowable Background Color 84 Profile Seller Preferences for Language Encoding 104 Language Encoding Settings Basic Choices 105 Website Language Preference 106 More Language Encoding Options 107 Website Payments Standard Checkout Integration Guide May 2005 11 a List of Figures 12 May 2005 Website Payments Standard Checkout Integration Guide Preface This Document This document the PayPal Website Payments Standard Checkout 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 characteristic
6. 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 HTML for Websites 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 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 selecting 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 change the co
7. Card Type Select Credit Card Number Expiration Date 1 y 2004 y 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 Code 5 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 Website Payments Standard Checkout Integration Guide Account Optional Your Customer s Experience 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
8. is automatically added to Bob s purchase He clicks Complete Checkout to complete his purchase Nore For more information about setting Shipping preferences see Chapter 10 Calculating Shipping Handling and Tax Alice s Used Books Payments by PREPARI 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 7147 Make Changes Complete Checkout Cancel Website Payments Standard Checkout Integration Guide May 2005 35 36 Account Optional Your Customer s Experience Step 6 Bob is taken to a payment comp
9. see Chapter 12 Auto Return Website Payments Standard Checkout Integration Guide May 2005 43 Creating Buy Now and Donation Buttons How Buy Now and Donations Work Step 7 Bob receives an email receipt for this transaction that confirms his payment and includes 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 TESE Ele 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 shipping 2 00 Quantity 1 Item Product Name Herodotus The History Item Product Number HIS 0001 44 May 2005 Website Payments Standard Checkout Integration Guide Creating Buy Now and D
10. your customers who are new to PayPal can make credit card payments without signing up for a PayPal account This setting is available in the Profile of Premier and Business accounts PayPal Account Optional is turned on by default for all U S Premier and Business accounts Your 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 Scroll down to the PayPal Account Optional section of the page Ak wo o Select On to turn PayPal Account optional on or Off to turn it off and continue using the existing Website Payments flow for all of your customers 6 Click Save to save your preference The setting
11. 2005 Website Payments Standard Checkout 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 nine separate logins to your account For each 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 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 Bal
12. Alphanumeric Numeric Numeric Numeric Character Limit 128 128 128 128 128 132 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 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 gt lt input type hidden name business value amyrowelkx com gt lt input type hidden name item name value hat gt lt input type hidden name item number value 123 gt lt input type hidden name amount value 15 00 gt lt input type hidden name first name value John gt lt input type hidden name last_ name value Doe gt lt input type hidden name address1 value 9 Elm Street gt lt input type hidden name address2 value Apt 5 gt lt input type hidden name city value Berwyn gt lt input type hidd
13. Arborcrest Way Portland OR 97225 USA Confirmed y Add 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 Website Payments Standard Checkout Integration Guide Creating Buy Now and Donation Buttons po 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 Alice s website 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
14. Checkout 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 Funding 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 is complete and that he is being automatically redirected back to the Widget Warehouse sebsite The page also displays a success URL that the user can click manually if the redirect fails Payments by EPAR TE 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 Website Payments Standard Checkout Integration Guide May 2005 95 Auto Return How Auto Return Works
15. Contact Telephone 208 721 5404 Payment Type Instant Tracking Information Provide your buyer with tracking and order status information Learn More 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 order Privacy Contact Telephone j 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 Ak wo oN Select the option you prefer On Optional Field On Required Field or Off Recommended A Complete the rest of the selections on the page 7 Click Save 90 May 2005 Website Payments Standard Checkout Integration Guide Creating Customer Contact Telephone o Notifications You Receive Notifications You Receive You receive an email notification when a buyer makes a purchase Website Payments Standard Checkout Integration Guide May 2005 91 Creating Customer Contact Telephone Notifications You Receive 92 May 2005 Website Payments Standard Checkout Integration Guide Auto Return With Auto Return for Website Payments merchants can eliminate th
16. May 2005 Website Payments Standard Checkout 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 10 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 10 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 These options you allow customers to choose 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 can have up to two option fields and you canuse a drop down menu or text box to collect the information Unfortunately Option fields and button encryption cannot be used if you are creating an email hyperlink 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
17. 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 9 3 Payment Page with Custom Style Header Image Image Border and Background Color Globe Getting Started pu 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 Website Payments Standard Checkout Integration Guide May 2005 77 ES 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 underscores 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 reduced to this size The image must be in a valid graphics format such
18. 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 Website Payments Standard Checkout Integration Guide May 2005 131 HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up TABLE A 8 Prepopulation Variables for Account Signup Variable business address1 business address2 business city usiness _ tate no usiness _ ip N O usiness _ ountry ao business _ cs email business cs phone_a business cs phone b business cs phone c usiness _ rl Go business night phone a business night phone b business night phone e Value The area code for U S phone numbers or the country code for non U S phone numbers This will prepopulate the buyer s home phone number The 3 digit prefix for U S phone numbers or the entire phone number for non U S phone numbers excluding country code This will prepopulate the buyer s home phone number The 4 digit phone number for U S phone numbers This will prepopulate the buyer s home phone number Requirements Alphanumeric Alphanumeric Alphanumeric Alphanumeric Numeric Alphabetic Alphanumeric Numeric Numeric Numeric
19. Website Payments Standard Checkout Integration Guide Introduction The PayPal Website Payments Standard Checkout 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 Website Payments Standard Checkout Integration Guide to e Quickly and easily set up e commerce functionality with PayPal For example learn how to integrate PayPal into your website in minutes with the PayPal Shopping Cart or Buy Now buttons e Learn more advanced techniques and tools to get the most out of the PayPal products e 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 account using the PayPal Account Optional feature e View various product flows to better visualize your end product e Review recommended solutions and best practices The PayPal Website Payments Standard Checkout Integration Guide includes information about and instructions for using the following features e Buy Now Buttons e Donations Buttons e Shopping Cart Buttons e PayPal Account Optional e Custom Payment Pages e Multi User Access e Shipping Handling and Tax e Auto Return PayPal Supported Currencies The following currencies are supported by PayPal TABLE 1 1 PayPal Supported Currencies Currency Codes and Maximum Transaction Amounts Maximum Transaction Code
20. add any items listed in other currencies to that Cart To change the currency buyers must either check out 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 Steps 3 through 12 Step 3 Calculate shipping and tax If you have specified shipping rates in your Profile they will be listed under Shipping Cost Calculation For more information about calculating shipping see Chapter 10 Calculating Shipping Handling and Tax Website Payments Standard Checkout Integration Guide May 2005 61 az Creating Shopping Cart Buttons PayPal Shopping Cart Button Factory If you have specified your tax rate from your Profile it will be listed under Sales Tax Calculation For more information about calculating tax see Chapter 10 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 let you collect additional information from your cu
21. and tax see Chapter 10 Calculating Shipping Handling and Tax May 2005 Website Payments Standard Checkout Integration Guide PayPal Payments Overview aa Contact Telephone Number 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 12 Auto Return Payment Receiving Preferences Once you have set up your PayPal account you re ready to receive 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 27 Refunds You can automatically send a refund to your buyer with 60 days after receiving payment For more information about sending refunds see Chapter 16 Processing Refunds Multi User Access PayPal s Multi User Access feature allows you to set up multiple logins and access levels Your emp
22. as gif jpg png and swf The image will appear at the top left of the payment page NoTE 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 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 two 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
23. 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 Encoding at PayPal Signup 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 signup For example if your postal address indicates France by default your Selling Preferences language encoding is set to a Western language character set Website Payments Standard Checkout Integration Guide May 2005 103 104 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 Merchant Tools To edit your Profile information please click on a link below Account Information Financial Email Informat
24. 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 1 Encrypted button HTML is not editable If you want tp modify your button code manually select No for this option 2 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 select No to turn encryption off 3 If you choose to encrypt your button you will not be able to create an email link 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 46
25. 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 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 all monetary values default to 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 74 May 2005 Website Payments Standard Checkout 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 t
26. in Step 4 Alice s Used Books Payments by PREPARA Welcome Shipping Billing Review Done 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 TSS Address 1 Address 2 optional City State y ZipCode S 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 Website Payments Standard Checkout Integration Guide May 2005 33 34 Account Optional Your Customer s Experience Step 4 Bob is prompted to fill in his billing information for the credit card he wishes to use for the purchase The items will be shipped to the shipping address he has provided Alice s Used Books Payments by PEARS welcome Shipping Billing Review Done Billing Information 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
27. input type hidden name cmd value _xclick gt lt input type hidden name business value jsmith paypal com gt lt input type hidden name return value http w yoursite com thankyou htm gt lt input type hidden name undefined quantity value 1 gt lt input type hidden name item name value Baseball Hat gt lt input type hidden name item number value 123 gt lt input type hidden name amount value 5 95 gt lt input type hidden name custom value merchant custom value gt lt input type hidden name invoice value merchant_invoice 12345 gt lt input type hidden name no shipping value 1 gt lt input type hidden name image url value https www yoursite com logo gif gt 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 Website Payments Standard Checkout Integration Guide May 2005 121 122 HTML Samples and Buy Now and Shoppping Cart Variables PayPal Buy Now and Donation Buttons HTML and Variables 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
28. 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 _Save Preview 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 PayPal an eBay company Copyright 1999 2004 PayPal All rights reserved Information about FDIC pass through insurance May 2005 Website Payments Standard Checkout Integration Guide Custom Payment Pages cm Previewing a Page Style 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 77 2 Click the radi
29. of his cart and clicks Checkout Payments by FEAR Alice s Used Books COTA NN Qty Remove 15 00 Herodotus The History f D enis 0001 20 00 fi O Homer The Illiad amp The Odyssey HIS 0125 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 that shows the items 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 instructions at the top of the screen PayPal Login Email Address Problems logging in PayPal Password Forget your password May 2005 Website Payments Standard Checkout Integration Guide 56 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 Ex
30. 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 Reporting Tools menu You have two ways of selecting data 1 Click the Custom Date Range radio button and 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 History 2 Click the Last Download to Present radio button to see all payments since you last downloaded your history The downloaded file containx a record of all payments that match your criteria May 2005 Website Payments Standard Checkout Integration Guide Creating Buy Now and Donation Buttons E Notifications You Receive Website Payments Standard Checkout Integration Guide May 2005 53 Creating Buy Now and Donation Buttons Notifications You Receive 54 May 2005 Website Payments Standard Checkout 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
31. the right hand menu an Bb Ow N Select On next to Block Non encrypted Website Payments Creating Encrypted Website Payment Button Code with the PayPal SDK The general process for creating EWP code is as follows 1 Create HTML name value pairs that represent the parameters of the HTML FORM to post to PayPal when a customer clicks a button on your website to buy your goods or service 2 Encrypt those button parameters with PayPal s public key 3 Sign the encrypted data with your private key 4 Publish the signed encrypted FORM to your website with the PayPal button The PayPal Software Development Kit SDK includes the console thathas commands to simplify the creation of Encrypted Website Payments button code It also has program methods for Java and Microsoft NET to encrypt button code For more information see the Generating EWP Code with the Console chapter in the PayPal SDK Guide Website Payments Standard Integration Guide May 2005 71 Encrypted Website Payments Creating Encrypted Website Payment Button Code with the PayPal SDK 72 May 2005 Website Payments Standard Integration Guide Adding PayPal to Your Third party Shopping Cart Some web developers want to integrate PayPal payment processing with their own third party shopping cart instead of the standard PayPal Shopping Cart The instructions and variables in this chapter allow your buyers to pay with PayPal when they are ready to check out afte
32. 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 information about Custom Payment Page see Chapter 9 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 For more information about shipping
33. 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 drop down menu is based on the country of origin you specified at signup 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 108 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 Website Payments Standard Checkout Integration Guide May 2005 107 108 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 W
34. 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 three to four business days Adding the Credit Card Statement Name This preference allows you to specify the name that appears on your customers credit card statements When a buyer pays you by credit card your Credit Card Statement Name appears with the word PAYPAL next to the charge on the statement for example PAY PAL MYCCNAME The Credit Card Statement Name can be up to 11 English or German characters in length including spaces and cannot contain special characters e g amp _ etc This name is converted to all capital letters and may be truncated by some credit card processors The Credit Card Statement Name should accurately reflect your business or legal name Website Payments Standard Checkout Integration Guide May 2005 29 El Getting Started Payment Receiving Preferences 30 May 2005 Website Payments Standard Checkout Integration Guide Account Optional With PayPal Account Optional turned on
35. 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 Amount 15 00 USD Shipping 8 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 login now If you don t have a PayPal accoun and want to pay with a credit card mall lAdures s MER PayPal Password Login Problems logging in Forget your password 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 32 May 2005 Website Payments Standard Checkout Integration Guide Account Optional Your Customer s Experience 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 your Payment Receiving Preferences are set to accept payments onlyfrom customers with Confirmed addresses then the buyer will skip over this Shipping Information screen and go directly to Billing Information
36. Certificate Providers e Verisign http www verisign com e GeoTrust http www geotrust com 120 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables 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 similar 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 These lines are required and 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 _xclick gt The following lines can be changed lt form action https www paypal com cgi bin webscr method post gt lt
37. Currency Amount AUD Australian Dollar 12 500 AUD Website Payments Standard Checkout Integration Guide May 2005 15 Introduction Additional Information TABLE 1 1 PayPal Supported Currencies Currency Codes and Maximum Transaction Amounts Maximum Transaction Code Currency Amount 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 NOTE In most cases you mu st log in to PayPal to see this additional information TABLE 1 2 Additional Information Information Fees Online Security User Agreement and Policies Online Help Customer Service URL https www paypal com fees https www paypal com security https www paypal com cgi bin webscr cmd p gen ua ua outside https www paypal com fees help https www paypal com wf 16 May 2005 Website Payments Standard Checkout 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 can make credit card and debit card payments without signing up for a PayPal account This setting is available from your Profile and is available to Premier and Business
38. ENTE PayPal Website Payments Standard Checkout Integration Guide For Professional Use Only Currently only available in English A usage Professional Uniquement Disponible en Anglais uniquement pour l instant Last Updated May 2005 PayPal Website Payments Standard Checkout 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 PayPal Europe Ltd is authorised and regulated by the Financial Services Authority in the United Kingdom as an electronic money institution PayPal FSA Register Number 226056 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 Preface Chapter Chapter Chapter Chapter Contents 1 Introduction PayPal Supported Currencies o Additional Information 2 PayPal Payments Overview PayPal Account Optional Buy Now and Donations Buttons Shopping Cart 222022000 Custom Payment Pages 0 000000 Calculating Shipping Handling and Tax Contact Telephone Number 200084 Auto Return 2 0002 eee ee ee ee Payment Receiving Preferences
39. PayPal a 73 Chapter 9 Custom Payment Pages 2 828244 275 Examples of Custom Payment Pages aaa aaa aa a e 75 Getting Startled a se s doa a ee ee eee 77 Adding a Page Sle iosop ae a karl eee Gg ae a A at 78 Editing a Page Style aaau a 79 Previewing a Page Style a 81 Making a Page Style Primary 2 2 a 81 Removing a Page Style a 81 Overriding Page Style Settings o oaa a a 82 Background Colors and Error Messages 2 0 eee 83 Chapter 10 Calculating Shipping Handling and Tax 85 Getting Started ee 85 Sales or Value Added Tax Collection o o oaa a a a 85 Overriding Tax Setting Per Transaction oa oaoa aa a 85 Shipping Calculation a 86 Flat Amount ss god ae hee ae a a a a ae a RI Y 86 Percentage 2c ae we a a e a a a aa Bh Ba et 86 Overriding Your Shipping Calculation ooa a aa a 86 Chapter 11 Creating Customer Contact Telephone 89 How It WOTKS ec gicas ra A a a Ee a a a 89 What You See ee 89 What Your Customer Sees 000 eee 90 Getting Started insect e star ke eo ee eo Bie ed ieee a eee de Ae Boa ws 90 Notifications You Receive 2 2 00 91 Chapter 12 Auto Return 2 ee 2G Website Payments Standard Checkout Integration Guide May 2005 5 all Contents How Auto Return WorkS 93 Setting Up Aut
40. S a uona ee he RR a a A a wa ee AA 55 What Your Customer Sees ee 55 What You Seb o ce s cca oo 60 PayPal Shopping Cart Button Factory a aooaa a 60 Getting Started M rra Da RP da E S E la Bee E Pac 61 Creating Your Shopping Cart Button aaa a 61 How You Get Your Money a 64 Notifications You Receive a a a 64 Emails 2 ae esai eae eA AA RA ARA 64 PISTON s i e caia e A ad a Pee a g a 65 Downloadable Logs o lt a co soe da suce a ea ae E a n a E a E A 65 Instant Payment Notification IPN 2 a 65 Chapter 7 Encrypted Website Payments a aaa aaa aa 67 How lt Works ee 67 Prerequisites to Using EWP aaa a 68 Keys and Certificates lt a assau erare a a a a a 68 Creating Your Public Certificate oa oo o 0 68 Uploading Your Public Certificate o e 69 Downloading PayPal s Public Certificate 2 220 70 4 May 2005 Website Payments Standard Checkout Integration Guide Contents HEN Removing Your Public Certificate o e 2 2 70 Allowing Only Encrypted Website Payments 2 70 Creating Encrypted Website Payment Button Code with the PayPal SDK 71 Chapter 8 Adding PayPal to Your Third party Shopping Cart 73 Passing the Aggregate Shopping Cart Amount to PayPal 73 Passing Individual Items to
41. 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 by credit cards Blocking Payments Funded By eChecks This preference allows you to block eCheck payments Because eCheck payments take three to four business days to clear you may not want to accept them for
42. Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 139 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 140 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 141 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 142 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 143 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 144 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 145 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 146 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign U
43. 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 Rubber Widgets Aluminum Widgets Steel Widgets ndoor Widgets Automotive Widgets lastic Widget Titanium Widgets Widget Warehouse Thank you for your payment Your transaction has been completed Payment Details item Widget Amount 162 50 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 All rights reserved 2003 Step 7 Bob receives an email receipt for this transaction that confirms the purchase and includes a copy of the payment details the Widget Warehouse s business information and his confirmed shipping address The way to send and P ay P da plete de money online Dear Bob Deboe This email confirms that you Bob Deboe have paid Widget Warehouse 162 50 using PayPal Payment Details Amount 162 50 USD Transaction ID 78H54514UY26 Quantity 1 Item Product Widget Name 96 Protect Your Account Info Make sure you never provide your password to fraudulent websites To safely and securely access th
44. Y N Confirm the refund amount and click Submit Refunding After 60 Days To send a refund 60 or more days after receiving payment 1 Log in to your PayPal account Click the Send Money tab 2 3 Enter the required information 4 Click Continue 5 Review the information on the confirmation page and click Send Money to complete your transaction The original transaction fee will be credited back to you when you perform a refund If you perform a partial refund a portion of the transaction fee will be credited back to you May 2005 115 Processing Refunds Sending Partial Refunds 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 Norte If the buyer denies your partial refund offer you can offer another refund Only one partial refund is allowed To send a partial refund 1 Log in to your PayPal account Click the History subtab Find the payment you would like to refund Click the Refund Payment link on the Transaction Details page 2 3 4 Click Details to open the Transaction Details page 5 6 Enter the partial refund amount and click Submit 7 Confirm the partial refund amount and click Process Refund 116 May 2005 1 Security Notification Validatio
45. 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 creating and publishing test prototype web pages and other content to which only paying members will have access For more information see the PayPal Subscriptions and Recurring Payments Integration Guide available on the PayPal website e Refunds A PayPal user providing a refund of money paid by another participant in a transaction e Simulated transactions Test 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 account will allow you to create multiple PayPal accounts such as Seller and multiple Buyer accounts to simulate different scenarios unconfirmed verified international and so on 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 PayPal saves user information in a browser cookie you will see your own PayPal username Your customers
46. 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 Your 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 Account Optional Buy Now and Donations Buttons PayPal makes it easy to accept donations and payments for single items through your 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 financi
47. ackground color for the header using HTML hex code The color code must be six digits long and should not contain the symbol Ifthe 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 Click Preview to preview your page style or click Save to save it Website Payments Standard Checkout Integration Guide May 2005 79 80 Custom Payment Pages Editing a Page Style FIGURE 9 4 Editing Page Style Settings RayPal y Log Out Help My Account Merchant Tools Auction Tools 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 Header Image URL Please specify an image that
48. action 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 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 Nore You can use Auto 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 98 May 2005 Website Payments Standard Checkout 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 any of the PayPal supported currencies 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 e Accept payments directly in your selected currency e Manage multiple currency
49. ail 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 The minimum required code for your post to PayPal 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 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 For more information on the additional variables see Table A 3 Buy Now and Donations Buttons HTML Variables Transaction Information on page 126 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 abo
50. al 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 offers both encrypted and unencrypted button options The flexibility of our Buy Now buttons keeps 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 Benefits of Buy Now and Donations Buttons include Website Payments Standard Checkout Integration Guide May 2005 17 18 PayPal Payments Overview Shopping Cart e Easy to implement no CGI scripting 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 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
51. ally 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 86 May 2005 Website Payments Standard Checkout Integration Guide Calculating Shipping Handling and Tax Shipping Calculation handling cart variables For more information and a complete list of the Buy Now button variables see Sample Buy Now Button HTML on page 121 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 Website Payments Standard Checkout Integration Guide May 2005 87 MX Calculating Shipping Handling and Tax Shipping Calculation 88 May 2005 Website Payments Standard Checkout 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 IMPORTANT n accordance with PayPal s User Agree
52. 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 51 and the Order Management Integration Guide Notifications You Receive You can be notified of payments in these three ways email history transaction log and downloadable history transaction log Email 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 Website Payments Standard Checkout Integration Guide May 2005 51 52 Creating Buy Now and Donation Buttons Notifications You Receive 1 Click the Profile subtab of the My Account tab 2 Click the Notifications under the Account Information heading 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 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
53. ance 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 Website Payments Standard Checkout Integration Guide May 2005 119 Using Secure Socket Layer SSL Using Secure Socket Layer SSL If you have contracted with a third party hosting provider to operate your website 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 run your own web server you will need to acquire and install your own SSL certificates The following information and resources are useful for implementing SSL General Information 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
54. 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 Be sure to remember the email address and password you choose in the future you will use them to login to your PayPal account FIGURE 3 1 Business Account Signup 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 Contact 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 s
55. ariable 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 return The URL to which the customer s browser is 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 rm Return URL behavior return method after payment completion If omitted or 0 the GET method is used for all Shopping Cart transactions in which IPN is not enabled and the POST method for all others If 1 and if return is set the customer s browser is returned to the return URL by the GET method and no transaction variables are submitted If 2 andif return is set the customer s browser is returned to the return URL by the POST method to which all available transaction variables are also posted Website Payments Standard Checkout Integration Guide May 2005 125 OA HTML Samples and Buy Now and Shoppping Cart Variables PayPal Shopping Cart HTML and Variables TABLE A 3 Buy Now and Donations Buttons HTML Variables Transaction Information Character Name Description Length currency _ The currency of the payment Defines the currency in which the monetary code variables amount shipping shipping2 handling tax are denoted If omitted all monetary fields are interpreted as U S D
56. 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 10 1Flat Amount Shipping Calculation Your 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 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 by 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 10 2Percentage 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 by 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 especi
57. automotive widget It slices dices and it will even make bread Titanium Widgets A Sale Price 142 50 Global Industries Inc All rights reserved 2003 Website Payments Standard Checkout Integration Guide May 2005 94 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 AJAR Gi Global Industries Inc obe i Widget Warehouse Payment Details Secure Transaction Ej PayPal is the secure payment processor for your seller To continue PRIVACY please enter the required information below j BBBOnLine Pay To Widget Warehouse Payment For Widget Currency U S Dollars dl Amount 142 50 USD If you have never paid through PayPal _ Click Here PayPal Login Email Address ndeboe 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 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 buyers create a new account they click Continue to proceed to the next step in the payment process May 2005 Website Payments Standard
58. by either pressing Ctrl V or by right clicking on your mouse and choosing Paste Norte 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 130 How You Get Your Money After your customer makes a 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 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 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 May 2005 Website Payments Standard Checkout Integration Guide Creating Shopping Cart Buttons CAEN Notifications You Receive 4 Click Save History Your transaction history log Histor
59. ccepts 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 can choose to accept or deny transaction by transaction a payment in a currency you do not currently hold 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 May 2005 Website Payments Standard Checkout Integration Guide Getting Started Payment Receiving Preferences Winning Buyer Notification Mass Payments Money Requests Post Sale Manager Invoices Smart Logos or eBay Checkout Payments
60. ctly 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 Website Payments Standard Checkout Integration Guide Creating Buy Now and Donation Buttons E Buy Now and Donations Button Factory If you will be sending your customers the payment link via email Copy the code from the Link 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 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 o
61. curity Guestian 2 chorsa Another Question 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 REAR 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 website or to PayPal depending on how she has set her return preferences for the button Website Payments Standard Checkout Integration Guide May 2005 37 38 Account Optional Your Customer s Experience Step 9 Bob receives an email receipt for this transaction that confirms his payment and includes a copy of the 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 Item Product Number HIS 0001 How did you hear about us PayPal Shops Featured Shop Buyer Robert Smith May 2005 Website Payments Standard Checkout Integration Guide Creating Buy Now and Donat
62. d 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 126 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables EE PayPal Shopping Cart HTML and Variables 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 These lines are required and 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 The following lines can 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 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 selec
63. de 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 website you need to include the View Cart buttons so your customers can quickly proceed to checkout when they are ready Website Payments Standard Checkout Integration Guide May 2005 63 64 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
64. e Done page in the Website Payments flow and automatically return or redirect buyers to their website upon payment completion By decreasing the Website Payments purchasing process by 1 3 and automatically bringing buyers back to their website 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 Donations 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 j A Global Industries Inc Widget Warehouse Wooden Widgets Rubber Widgets Widget 019983763 Aluminum Widgets The surprisingly compact Widget gt 019983763 is a powerful Steel Widgets no compromise solution for Outdoor Widgets widget professionals who are Indoor Widgets on e road and Eo Soa M e office but who never want to be Automotive widgets without the speed and power of Plastic Widgets an
65. e 118 Getting Haned ia a a a a da Ma E 119 Using Secure Socket Layer SSL aa a 120 General Information aooaa 2 0 00 eee ee 120 SSL Certificate Providers 00 0002 eee ee eee 120 6 May 2005 Website Payments Standard Checkout Integration Guide Contents Appendix A HTML Samples and Buy Now and Shoppping Cart Variables 121 PayPal Buy Now and Donation Buttons HTML and Variables 121 Integrating Buy Now Buttons with your Shopping Cart 121 Sample Buy Now Button HTML e o 121 Sample Buy Now Hyperlink 0 e o 122 Buy Now and Donations HTML and Hyperlink Variables 122 PayPal Shopping Cart HTML and Variables 2 224 126 PayPal Shopping Cat HTML o 126 Standard Add to Cart HTML a saesson estara o 127 Shopping Cart Variables ooa oaa ee 127 Adding PayPal Checkout To Your Third Party Shopping Cart 128 Passing Individual Items to PayPal oaa aaa a 128 Prepopulating Your Customer s PayPal Sign Up aoaaa 130 Prepopulation for Account Signup aa ee 131 Sample HTML 02 02 2 ee 133 Appendix B Country Codes 2 56 28 244 4 153 ISO 3166 Standard Country Codes Website Payments Standard Checkout Integration Guide May 2005 7 fon Contents 8 May 2005 Website Payments Standard Checkout Integration Guide Table 1 1 Table 1 2 Tabl
66. e 7 1 Table 9 1 Table 14 1 Table A 1 Table A 2 Table A 3 Table A 4 Table A 5 Table A 6 Table A 7 Table A 8 Table B 1 List of Tables PayPal Supported Currencies Currency Codes and Maximum Transaction Amounts 15 Additional Information o e 16 How Encrypted Website Payments Work 67 Order of Customization Variables 0 o 82 Character Sets and Encodings Supported by PayPal 108 Buy Now and Donations Buttons HTML Variables Item Information 123 Buy Now and Donations Buttons HTML Variables Display Information 124 Buy Now and Donations Buttons HTML Variables Transaction Information 126 Shopping Cart Variables 0 e 127 Third Party Shopping Cart Variables 128 Variables for Individual Items in Third Party Shopping Carts 129 Prepopulation Variables for Website Payments 130 Prepopulation Variables for Account Signup 131 ISO 3166 Two Character Country Codes 153 Website Payments Standard Checkout Integration Guide May 2005 a List of Tables 10 May 2005 Website Payments Standard Checkout Integration Guide Figure 2 1 Figure 3 1 Figure 3 2 Figure 3 3 Figure 3 4 Figure 9 1 Figure 9 2 Figure 9 3 Figure 9 4 Figure 9 5 Figure 9 6 Figure 14 1 Figure 14 2 Figure 14 3 Figure 14 4 List of Figures PayPal Payment Flows
67. e Generate a public certificate e Upload your public certificate to the PayPal website at https www paypal com us cgi bin webscr cmd _profile website cert e Download PayPal s public certificate from https www paypal com us cgi bin webscr cmd _profile website cert Keys and Certificates This section describes how to create your private and public keys for EWP upload your public key to PayPal and download a copy of PayPal s public key Public Key Encryption Background Public key encryption asymmetric encryption improves security and convenience by allowing senders and receivers to have separate public and private encryption keys e The public key The public key is the portion of an asymmetric cryptographic key that recelvers give senders who want to send information Information is encrypted using the receiver s public key so only the receiver can decrypt it The receiver can use the sender s public key to decrypt information that was encrypted with the sender s private key This encryption process is used with digital signatures which are signed using the sender s private key and later decrypted with the sender s public key by the receiver to verify the origin of information e The private key The private key is the portion of an asymmetric cryptographic key the receiver keeps secret and is not sent to anyone It is used by the receiver to decrypt information encrypted by senders Private keys are also u
68. e PayPal website or your account open up a new web browser e g Internet Explorer or Netscape and type in the PayPal URL https www paypal com to be sure you are on the real PayPal site PayPal will never ask you to enter your Password in an email For more information on protecting yourself from fraud please review our Security Tips at https wwwpaypal com securitytips Protect Your Password You should never give your PayPal password to anyone including PayPal employees May 2005 Website Payments Standard Checkout Integration Guide Auto Return Setting Up Auto Return Setting Up Auto Return To set up Auto Return 1 Log in to your 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 R
69. e and click the Refund Payment link at the bottom of the page The refund reverses the entire payment including transaction fees 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 110 May 2005 Website Payments Standard Checkout 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 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 ww 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 s
70. e is not already a PayPal member So next to If you have never paid through PayPal he clicks Click Here as shown in the following diagram PayPal Login Email Address Po Problems logging in PayPal Password Pp 7 Forget your password 40 May 2005 Website Payments Standard Checkout 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 password 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 s
71. e private key is stored in the file my prvkey pem openssl genrsa out my prvkey pem 1024 Creating Your Public Certificate Using OpenSSL To create your certificate enter the following openssl command which generates a public certificate in the file my pubcert pem openssl req new key my prvkey pem x509 days 365 out my pubcert pem Uploading Your Public Certificate To upload your public certificates to the PayPal website 1 Log in to your Business or Premier PayPal account Click the Profile subtab Click the Encrypted Payment Settings link from the right handed menu Click Add Ae wo oN Click Browse and select the public certificate you want to upload The public certificate must be in PEM format If your public certificate is successfully uploaded it will appear on the next screen under Your Public Certificates Your Public Certificates PayPal will use your public certificate to decipher the encrypted content of your website buttons You may add up to 6 different certificates e ress Cert ID Certifying Authority o Jul 22 C US ST NEBRASKA L OMAHA O TESTING OU IT CN PAU Email your 2005 email 20 43 24 PDT Y MGHIRXHNMXZSL Website Payments Standard Integration Guide May 2005 69 Encrypted Website Payments Keys and Certificates After you have successfully uploaded your certificate PayPal assigns a corresponding certificate ID Store the certificate ID in a safe place you need it to make Encrypted W
72. ebsite Payments Downloading PayPal s Public Certificate To download PayPal s public certificate 1 Log in to your Business or Premier PayPal account Click the Profile subtab 2 3 Click the Encrypted Payment Settings link from the right hand menu 4 Click the Download button under the PayPal Public Certificate section Removing Your Public Certificate NoTE If you remove your public certificate the certificate ID associated with it will not be valid to encrypt buttons and any buttons generated by your website with that certificate ID will not function correctly To remove one or more of your public certificates 1 Log in to your Business or Premier PayPal account Click the Profile subtab Click the Encrypted Payment Settings link from the right hand menu Select one of the listed certificates and click Remove an Bb Ww N On the next screen click Remove again to remove the selected public certificate Allowing Only Encrypted Website Payments To prevent someone from creating a spoof version of your Website Payment Buttons you can block unencrypted website payments 1 To allow only Encrypted Website Payments 70 May 2005 Website Payments Standard Integration Guide Encrypted Website Payments Creating Encrypted Website Payment Button Code with the PayPal SDK Log in to your Business or Premier PayPal account Click the Profile subtab Click the Website Payment Preferences link from
73. ecurity 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 Website Payments Standard Checkout Integration Guide May 2005 41 42 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 10 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 Quantity 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
74. en name state value PA gt lt input type hidden name zip value 19312 gt lt input type hidden name night phone a value 610 gt lt input type hidden name night phone b value 555 gt lt input type hidden name night phone c value 1234 gt lt input type image SRC http images paypal com images x click but01 gif border 0 name submit alt Make payments with PayPal it s fast free and secure gt lt form gt Website Payments Standard Checkout Integration Guide May 2005 133 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 134 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 135 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 136 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 137 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 138 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and
75. ence customizable buttons and secure payments make happy 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 Account Optional Website Payments Standard Checkout Integration Guide May 2005 39 ES 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 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 h
76. es ISO 3166 Standard Country Codes TABLE B 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 154 June 2005
77. estern 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 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 Website Payments Standard Checkout Integration Guide Testing Website Payments 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
78. ete their jobs For example use Multi User Access 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 Merchant Tools History Auction Tools Profile 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 combination 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
79. eturn applies to PayPal Website Payments including Buy Now Donations Subscriptions and Shopping Cart Learn More Auto Return On Ror 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 hte o 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 the 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 Cancel Website Payments Standard Checkout Integration Guide May 2005 97 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 trans
80. he 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 hidden name cmd value _cart gt Website Payments Standard Checkout Integration Guide May 2005 73 az Adding PayPal to Your Third party Shopping Cart Passing the Aggregate Shopping Cart Amount to PayPal 3 Add the upload variable 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 with 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 _x values must increment by one continuously in order to be recognized If you skip
81. here can also be specified with HTML lt FORM gt input variables passed through at a transaction level For more information see Table A 4 Shopping Cart Variables on page 127 78 May 2005 Website Payments Standard Checkout Integration Guide Custom Payment Pages Editing a Page Style Editing a Page Style To edit a page style 1 Begin at the Custom Payment Page Styles page For more information see Getting Started on page 77 Click the radio button next to the page style you wish to edit Click Edit 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 underscores 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 reduced 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 NoTE PayPal recommends that you enter an image URL only if the image is stored on a 5 secure https server Otherwise your customer s web browser will display a message that the payment page contains insecure items Header Background Color optional Enter the b
82. 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 input shown in Sample Buy Now Button HTML on page 121 generates the following hyperlink This example includes several optional fields and the text is URL encoded https www paypal com xclick business jsmaith 40paypal comeundefined quantity 18item _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 uss3F 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 Donations button Norte If you want to remove the values for a variable for example to leave the amount blank for your customer to define you 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 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables PayPal Buy Now and Donation Buttons HTML and Variab
83. his section demonstrate the types of customization you can add to your PayPal Website Payment buttons Figure 9 1 Payment Page in Standard PayPal Page Style shows a payment page without any customization FIGURE 9 1 Payment Page in Standard PayPal Page Style Payments by PAM Payment 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 Website Payments Standard Checkout Integration Guide May 2005 75 E Custom Payment Pages Examples of Custom Payment Pages Figure 9 2 Payment Page with Custom Style Header Image and Header Border shows a custom header image and header border color FIGURE 9 2 Payment Page with Custom Style Header Image and Header Border Payments by PERAR Globe Payment Details Secure Transaction Ej PayPal is the authorized payment processor for Globe Industries 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 76 May 2005 Website Payments Standard Checkout Integration Guide Custom Payment Pages EN Getting Started Figure 9 3
84. hopping 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 58 May 2005 Website Payments Standard Checkout Integration Guide Creating Shopping Cart Buttons How It Works Step 7 Bob is taken to a confirmation page where he sees the details of his 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 Pay
85. hown 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 Website Payments Standard Checkout Integration Guide May 2005 23 24 Getting Started Account Profile 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 your password NEW For your security Confirm Step 3 Add Bank Account You must add a bank account In order for PayPal to add funds to it 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 After you add your bank account it becomes your Primary bank account and default payment method If you decide to add additional bank accounts to your PayPal account you can change any of them to be your primary account 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 Clic
86. iable will be passed back to you cpp header Sets the image you choose to appear at the top left of the payment page The image 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 Chapter 9 Custom Payment Pages cpp Sets the background color for the header of the payment page Valid character set is headerback_ 6 character HTML Hex code in ASCII This variable is not case sensitive color cpp_ Sets the border color around the header of the payment page The border is a 2 headerborde pixel perimeter around the header space which has a maximum size of 750 pixels r color wide by 90 pixels high Valid character set is 6 character HTML Hex code in cpp payflow _color cs image url no_note ASCII This variable is not case sensitive Sets the background color for the payment page below the header Valid 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 9 Custom Payment Pages Sets the background color of your payment pages If set to 1 the background color will be black If omitted or se
87. ic information such as 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 added more than one confirmed email address 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 HTML for Websites text box by highlighting all of the text and pressing Ctrl C or by highlighting all of the text right clicking your mouse and selecting 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 option 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 exa
88. ies Managing Currency Balances 102 May 2005 Website Payments Standard Checkout 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 of the world 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 one of the most widely implemented Chinese character sets 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
89. 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 must enter the different choices If you choose text box your customers enter their 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 9 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 Auto Return after customers complete their payments they see a payment completion page From this page they click Continue and return to the Successful Payment URL you have specified If you do not enter a Succe
90. ing on your mouse and selecting Paste If you will be sending your donors the Donations link via email 1 Copy the code from the Link 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 50 May 2005 Website Payments Standard Checkout Integration Guide Creating Buy Now and Donation Buttons Notifications You Receive 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 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 makes a payment 1 You will receive
91. ion Buttons PayPal makes it easy to accept payments for single items through your website Buy Now and Donations buttons scan 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 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 make 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 scripting 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 experi
92. ion Street Address Credit Cards Phone Bank Accounts Password Currency Balances Notifications BillPa Time Zone Redeem Gift Certificates AAN and Points Multi User Access Monthly Account silactezs Statements Business Information Merchant Initiated Close Account Payments May 2005 Log Out Help Auction Tools Resolution Center 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 Website Payments Standard Checkout 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
93. k the Credit Cards link in the Financial Information column On the Credit Cards page click the Add button The credit card you add will become your primary credit card meaning it is the default 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 Auction Tools Merchant Tools My Account Send Money Request Money Profile Add Funds Withdraw History Overview 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 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 May 2005 Website Payments Standard Checkout Integration Guide Getting Started Account Profile go to your Profile log in to your PayPal acco
94. le 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 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 and Buy Now and Shoppping Cart Variables Website Payments Standard Checkout Integration Guide May 2005 85 MX Calculating Shipping Handling and Tax Shipping Calculation Shipping Calculation Determine whether you would like to charge your customers for shipping
95. les TABLE A 1 Buy Now and Donations Buttons HTML Variables Item Information Name amount item name item number on0 quantity undefined _ quantity onl os0 osl Description 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 passed back to you at payment completion 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 set to 1 enables buyer to modify the 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 osO to be recognized Second set of option value s If this option is selected thr
96. letion 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 PREPARE 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 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 informatio
97. line payments merchants can create Encrypted Website Payment EWP button code using standard public key encryption With public and private keys merchants can dynamically encrypt payment information before it is sent to PayPal NoTE The PayPal Software Development Kit includes commands to create private keys and public certificates for EWP and to generate EWP code For more information see the PayPal SDK Guide How It Works Encrypted Website Payments works in the following way TABLE 7 1 How Encrypted Website Payments Work Merchant Buyer PayPal Creates HTML name value pairs that represent the parameters of the HTML FORM to post to PayPal when a customer clicks a button on his website Encrypts those button parameters with PayPal s public key Signs the encrypted data with his own private key Publishes the signed encrypted Clicks Pay button which Checks the authenticity of the data by FORM to his website with a Pay posts the signed encrypted using the merchant s uploaded public button FORM data to PayPal s key URL Decrypts the data with PayPal s private key Directs the buyer s browser to the PayPal payment flow specified in the button parameters Website Payments Standard Integration Guide May 2005 67 68 Encrypted Website Payments Prerequisites to Using EWP Prerequisites to Using EWP Before you can use Encrypted Website Payments you must e Generate a private key
98. loyees 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 118 Website Payments Standard Checkout Integration Guide May 2005 19 PayPal Payments Overview Reports Reports PayPal s Reporting Tools provide you with the information you need to effectively measure and manage your business e Analyze your revenue sources to better understand your customers buying behavior e Automate time consuming bookkeeping tasks e Accurately settle and reconcile transactions 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 with which you can 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 20 May 2005 Website Payments Standard Checkout Integration Guide PayPal Payme
99. ment 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 Number optional or required or turn it off altogether Off is 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 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 Off PayPal recommends this option Website Payments Standard Checkout Integration Guide May 2005 89 on Creating Customer Contact Telephone Getting Started Step 2 On the Transaction Details page you will see the buyer s contact telephone number
100. ments Bob would be redirected back to your website immediately after clicking the Pay button on the Payment Confirmation page To learn more about Auto Return see Chapter 12 Auto Return Step 8 Bob receives an email receipt for this transaction that confirms the payment and includes a copy of the Payment details Receipt for your Payment Message Plain Text lol xj 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 History Item Number HIS 0001 Item Amount 15 00 Quantity 1 Total 15 00 Website Payments Standard Checkout Integration Guide May 2005 59 e 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
101. n Notification validation is the process you use to validate your data For more information about Notification Validation see the Order Management Integration Guide 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 NoTE PayPal highly recommends encrypting your button code however doing so has three limitations 1 Encrypted button HTML is not editable If you want tp modify your button code manually select No for this option 2 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 select No to turn encryption off 3 If you choose to encrypt your button you will not be able to create an email link Website Payments Standard Checkout Integration Guide May 2005 117 118 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 have access onlyto the parts of your Paypal account that they need to compl
102. n Bob has already entered to complete the transaction is carried 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 Website Payments Standard Checkout Integration Guide Account Optional Your Customer s Experience Step 7 If Bob clicked Save My Info he is taken to a page where he can complete signing up 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 Security 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 answer se
103. ncluding 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 PayPal 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 106 May 2005 Website Payments Standard Checkout 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 107 The More Encoding Options page allows you to specify the character encoding PayPal 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
104. ntegration Guide Custom Payment Pages aa 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 payment page is not allowed The color makes the fields the customer must complete difficult to read FIGURE 9 5 Example of Unallowed Background Color Website Payments Standard Checkout Integration Guide May 2005 83 84 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 9 6 Example of Allowable Background Color Shipping Information Salect a shrppng preferanse and then cbc Continua Checkout bakra Shipping No stepping required onbre download payment for a service afc E Gripping requerad book t shirt atc Pesse ship to the address we entered below Soloct the country for your baling and stepping addrasses Both addresses must bo in ihi cae 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
105. nts Overview PORN 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 iii PayPal Account Merchant site PayPal Account Optional on Buy button Optional off PayPal page PayPal Interstitial PayPal cookie shown for few seconds before redirecting 4 Le d PayPal Account Website Payment Website Payment Optional i i ignu Login or Continue Login gnup Continue Logged in is in v v PayPal Account J Website Payment Optional Payment Signed up Shipping Confirmation Pavinent com lete Auto Return yment comp turned on PayPal Account 4 Optional Website Payment aa Payment Receipt Billing v v PayPal Account Auto Return Optional interstitial Review Payment complete Payment complete User clicks Continue v optional PayPal Account signup Optional Done Redirect v PayPal Account Optional User clicks Continue Save info PayPal Account i Optional Merchant site New PayPal Thank You Account Website Payments Standard Checkout Integration Guide May 2005 21 PayPal Payments Overview Payment Flow Overview 22 May 2005 Website Payments Standard Checkout 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
106. o Profile Summary Note You are currently 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 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 I Have non U S PayPal accounts M 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 7 URL optional htp 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 al CES USED a Name lt cara Website Payments Standard Checkout Integration Guide May 2005 27 28 Getting Started Payment Receiving Preferences Blocking Payments Blocking Payments From U S Users Without a Confirmed Address This preference allows you to better manage your risk by filtering payments where the buyer chooses not to share his Confirmed Address with you PayPal provides Confirmed Addresses to help you make informed deci
107. o Return o 97 Subscription Password Management and Auto Return 98 Chapter 13 Using Multiple Currencies 4 99 Receiving Money s essas daadaa ria Sa aa aeaa a 99 Accepting Payments a 99 Managing Currency Balances aoaaa a 101 Chapter 14 Language Encoding for Your Data 103 Background Information oa aa a a 103 Changing Your Language Encoding 0 00 103 Your Default Language Encoding at PayPal Signup 103 Navigating Your Profile Language Encoding a 104 Changing Your Website Language ee ee ee 105 More Encoding Options o s seo a e a o e o 107 Setting Language in Website Payments charset a 108 Chapter 15 Testing ee 109 Website Payments a 109 Your PayPal Button a a e a a a E 109 Testing MMPS ook ld ea o da Ge Bae hes eee E ARS 111 Chapter 16 Processing Refunds 2 ee 115 Refunding Within 60 Days of Payment 2 2 2 e a 115 Refunding After 60 DayS lt e o sacd e ea a a e a e 115 Sending Partial Refunds aaaea 116 Chapter 17 Security ee 117 Notification Validation o e 117 Button Encryption Tea a nA aa a aaia e a a a aa a E 117 Multi User Access 2 e
108. o button next to the page style you wish to preview 3 Click Preview 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 9 Custom Payment Pages NoTE If you do not designate a 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 77 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 applies 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 77 2 Click the radio button next to the page style you wish to remove 3 Click Remove 4 Click Remove to confirm your choice Website Payments Standard Checkout Integration Guide May 2005 81 ES Custom Payment Pages Overriding Page Style Settings Overriding Page Style Settings Your Primary page
109. ollars custom Pass through variable never be presented to your customer If omitted no 256 variable is 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 checkbox 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 enabled your customer will be charged the amount or percentage defined in your Profile 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 PayPal Shopping Cart HTML an
110. onation 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 D 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 Now 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
111. ough 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 Character Length 127 127 64 64 64 or 200 See description 64 or 200 See description Website Payments Standard Checkout Integration Guide May 2005 123 HTML Samples and Buy Now and Shoppping Cart Variables PayPal Buy Now and Donation Buttons HTML and Variables 124 TABLE A 2 Buy Now and Donations Buttons HTML Variables Display Information Character Name Description Length address _ If set to 1 the address passed in via prepopulation fields will override the user s override 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 cancel _ A URL to which the customer s browser is returned if payment is cancelled for return example a URL on your website which hosts a Payment Cancelled page If omitted users will be taken to the PayPal website cbt Sets the text for the Continue button on the PayPal Payment Complete page Requires return url cn Label above the note field This value is not saved and will not appear in any of 40 your notifications If omitted no var
112. ount X 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 x 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 X The tax amount for item x on0 x 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 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 Website Payments Standard Checkout Integration Guide May 2005 129 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 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 monetar
113. p Website Payments Standard Checkout Integration Guide May 2005 147 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 148 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 149 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 150 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Saal Prepopulating Your Customer s PayPal Sign Up Website Payments Standard Checkout Integration Guide May 2005 151 OA HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up 152 May 2005 Website Payments Standard Checkout Integration Guide Country Codes ISO 3166 Standard Country Codes PayPal relies on two character country codes defined by International Standards Organization ISO 3166 TABLE B 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 June 2005 153 B Country Cod
114. 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 Transaction Amounts on page 15 Premier and Business account holders have additional flexibility for managing Multiple Currencies payments Accepting Payments You choose which 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 currency you do not hold you will be asked to Accept or Deny the payment 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 Website Payments Standard Checkout Integration Guide May 2005 99 100 Using Multiple Currencies Receiving Money Recent Activity AY 4ctroty Hy Auciipns naa File Type TofFrom HamefEmall Amount Date Stats Do Payment From Hedo Ware EUR 50 00 Sep 29 2002 Urlair _File Selected Itori rito aut Send Money Marchant Tools Auctlon Tools My Account Request Money Accept or Deny a Payment You have received a payment of 50 00 Euros from NedoWare Verified Business Member 051 What would you like to do with this payment
115. piration 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 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 Website Payments Standard Checkout Integration Guide May 2005 57 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 S
116. r adding all of their items to your third party shopping cart There are two ways to integrate your third party shopping cart with the PayPal payment flow The first is to pass the aggregate amount of the total Cart payment rather than the individual items The second is to pass details of the items that have been selected to PayPal instead of an aggregated amount for the entire Cart For a complete list of variables see HTML Samples and Buy Now and Shoppping Cart Variables on page 121 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 can aggregate your entire shopping cart and pass the total amount with 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 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 transactions and notifications To include information about t
117. r the name of your organization charity here If you do not enter anything in this field your donors can 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 can enter it in the Donation Amount field If you would like your donors to choose their donation amounts do not enter a price in this field Users will be prompted to enter a donation amount when they make payment 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 payment 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 continue to Step 8 If you have no further details to add to your Donations button click Create Button Now Otherwise click Add More Options IMPORTANT f you are creating an email link be sure to click No for the encrypt button option Step 3 Customize Your Payment Pages Custom Payment Page Style Give your donors a seamless payment experience by cus
118. rst name First name Alphabetic 32 last_name Last name Alphabetic 64 address1 Street 1 of 2 fields Alphanumeric 100 address2 Street 2 of 2 fields Alphanumeric 100 city City Alphanumeric 40 state State Must be two character official 32 abbreviation zip Zip Numeric 32 country Sets shipping and billing country See Alphabetic 2 Appendix C for allowable country codes 130 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables Prepopulating Your Customer s PayPal Sign Up TABLE A 7 Prepopulation Variables for Website Payments Character Variable Value Requirements Limit le Defines the buyer s checkout flow Alphabetic 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 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 8 Prepopulation Variables for Account Signup Character Variable Value
119. rted Account Profile Selling Preferences Use the Selling Preferences column to organize the way you sell with your PayPal account including editing your Payment Receiving Preferences tax and shipping 26 May 2005 Website Payments Standard Checkout Integration Guide Getting Started Payment Receiving Preferences 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 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 4 Payment Receiving Preferences My Account Send Money Request Money Merchant Tools Auction Tools Overview Add Funds Withdraw History Profile Payment Receiving Preferences Back t
120. s of text These typefaces and the characteristics they imply are described below Typeface How Used serif italics A document title A term being discussed or defined For example A file is a readable or writable stream of characters Boolean values not keywords For example The function returns true if it encounters an error monospaced Pathnames or file names that appear in body text frames Code related names that appear in body text frames Such names are used for functions callbacks arguments data structures and fields For example AbstractResponseType is the SOAP response type definition on which all PayPal API response methods are based Components of Internet protocol requests and responses such as HTTPS and FORM variables For example The PayPal system uses a method POST request to return IPN status variables related to subscriptions such as txn_type Serif bold User interface names such as window names or menu selections For example On the Profile page click Email to confirm your email address Website Payments Standard Checkout Integration Guide May 2005 13 a Preface 14 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
121. sed to create digital signatures which prove the authenticity of a sender e The public certificate The public certificate consists of the the public key and identity information such as a person s name all of which could be signed by a certificate authority CA The CA guarantees that the public key belongs to the named entity Creating Your Public Certificate For EWP PayPal requires that you upload your public certificate to its website so that the authenticity ofthe encrypted code can be verified PayPal accepts only X 509 public certificates not public keys The difference between a key and a certificate is that a certificate includes the public key along with information about the key such as when the key expires and who the key belongs to PayPal accepts public May 2005 Website Payments Standard Integration Guide Encrypted Website Payments Keys and Certificates certificates in OpenSSL PEM format from any established certificate authority such as Verisign You can also create your own private key and public certificate using open source software such as OpenSSL http www openssl org which is detailed in the following section NoTE The PayPal Software Development Kit includes commands to create private keys and public certificates for EWP Creating Your Private Key with OpenSSL Using the openss1 program enter the following command to create your private key The command generates a 1024 bit RSA private key Th
122. sions when shipping goods To be eligible for PayPal s Seller Protection 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 can 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 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 There are three choices for this preference e Yes A
123. ssful Payment URL customers who click this link are 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 are taken to a PayPal web page Website Payments Standard Checkout Integration Guide May 2005 47 48 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 item or service choose Yes They will 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 be able to purchase only 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 No your customers cannot 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 specif
124. stomer without extra email communication Each Shopping Cart Button may have up to two option fields and you can 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 button image 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 9 Custom Payment Pages Step 7 Customi
125. 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 To change the page style 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 Custom Payment Page variables are passed at a transaction level they override any page styles set in profile settings or page_settings Customization variables are applied in the following order TABLE 9 1 Order of Customization Variables Custom Option Description 1 Custom Payment Pages See Table A 4 Shopping Cart Variables on page 127 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 82 May 2005 Website Payments Standard Checkout I
126. t 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 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 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 see Table A 3 Buy Now and Donations Buttons HTML Variables Transaction Information on page 126 TABLE A 4 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 Website Payments Standard Checkout Integration Guide May 2005 127 128 HTML Samples and Buy Now and Shoppping Cart Variables PayPal Shopping Cart HTML and Variables Adding PayPal Checkout To Your Third Party Shopping Cart The code for your PayPal POST requires an image as the FORM submit button and the following three hidden variables TABLE A 5 Third Party Shopping Cart Variables Name Description business Em
127. t to 0 the background color will be white The URL of the 150x50 pixel image you would like to use as your logo If omitted the customer sees your business name if you have a Business account or your email address if you have Premier account 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 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables EE PayPal Buy Now and Donation Buttons HTML and Variables TABLE A 2 Buy Now and Donations Buttons HTML Variables Display Information Character Name Description Length no shipping The buyer s shipping address Omitted or set to 0 customer is prompted to include a shipping address 1 customer is not asked for a shipping address 2 customer is required to provide a shipping address page style 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 v
128. tatements 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 Website Payments Standard Checkout Integration Guide May 2005 111 Your PayPal Button 112 May 2005 Website Payments Standard Checkout Integration Guide Website Payments Standard Checkout Integration Guide May 2005 113 114 May 2005 Website Payments Standard Checkout Integration Guide 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 NOTE Fees assessed by Business or Premier Account receiving payments can be reimbursed only if the refund link on the Transaction Details page is used If it has been more than 60 days since you received the payment you should send the refund using Send Money Refunding Within 60 Days of Payment To send a refund within 60 days of receiving payment Log in to your PayPal account Click the History subtab Find the payment you would like to 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 NY A a A Y
129. 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 Goto https www paypal com Click Help in the upper left corner of the page Click Contact Us in the lower left of the page Chose Help by Email a E YY 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
130. tomizing 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 9 Custom Payment Pages Step 4 Customize Your Donors Experience Website Payments Standard Checkout Integration Guide May 2005 49 Creating Buy Now and Donation Buttons Buy Now and Donations Button Factory Successful Payment URL Enter the URL where you would like to send your donors after they have completed payment Once donors complete their payments they see a payment confirmation page From this page they 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 are 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 Miscellaneous Shipping Address If you would like to prompt customers to provide a shipping address choose Yes If you choose No donors are not asked to provide a shipping address Step 6 Collect additional information from your customers Note Title If you are allo
131. ulating Your Customer s PayPal Sign Up on page 130 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 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 a buyer adds one item to a Cart the buyer is not allowed to
132. unt and click the Profile subtab of the My Account tab as shown in the following diagram Your Profile is organized in three sections for managing your account information as shown in the following diagram FIGURE 3 3 Merchant Profile Page Send Money Request Money Merchant Tools Auction Tools My Account Withdraw Add Funds History Overview Profile Summary To edit your Profile information click on a link below Account Information Financial Information Selling Preferences Email Credit Cards Auctions Street Address Bank Accounts Sales Tax Phone Currency Balances Shipping Calculations Password BillPay Shipping Preferences Notifications Redemption Codes Payment Receiving Multi User Access Monthly Statements Preferences Business Information Instant Pa ment Notification Preferences Close Account PayPal Shops Reputation Account Information 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 maintaining your Multiple Currency Balances and viewing your Monthly Account Statements Website Payments Standard Checkout Integration Guide May 2005 25 E Getting Sta
133. ut 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 May 2005 Website Payments Standard Checkout Integration Guide HTML Samples and Buy Now and Shoppping Cart Variables PayPal Shopping Cart HTML and Variables 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 _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 6 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 passed back to you at payment completion If omitted no variable will be passed back to you am
134. will not see your username 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 signup 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 Website Payments Standard Checkout Integration Guide May 2005 109 Your PayPal Button 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 that your Business Premier account is Verified This is your seller account 3 Go to your web browser and click the button you 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 5 Log in to your seller account and refund the payment To refund a payment go to the Transaction Details pag
135. wing 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 I or special instructions There is a 40 character limit on your note field title If you do not enter a title donors 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 cannot include a note Step 7 Choose an email address to receive payment If you have added more than one confirmed email address 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 HTML for Websites text box by highlighting all of the text and pressing Ctrl C or by highlighting all of the text right clicking your mouse and clicking Copy 2 In your website files open the code for the web page from which you wish to collect payment 3 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 click
136. y 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 Reporting Tools menu Choose the Custom Date Rangeradio button and 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 History The downloaded file contains 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 the Order Management Integration Guide Website Payments Standard Checkout Integration Guide May 2005 65 az Creating Shopping Cart Buttons Notifications You Receive 66 May 2005 Website Payments Standard Checkout Integration Guide Encrypted Website Payments To add security to on
137. y 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 Prepopulating Your Customer s PayPal 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 the redirect cmd variable whose value should be _xclick TABLE A 7 Prepopulation Variables for Website Payments Character Variable Value Requirements Limit email Customer s email address Alphanumeric 127 fi
138. 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 Website Payments Standard Checkout Integration Guide May 2005 31 az Account Optional Your Customer s Experience Your Customer s Experience If you turn PayPal Account Optional off the customer is required to sign up for a PayPal account to complete the payment and then returns 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 The Hi Herodotus The History Herodotus Translated by David Grene fr 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 He is prompted to log in to his PayPal account but he is not already a PayPal member so he clicks Continue Checkout
139. 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 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 Website Payments Standard Checkout Integration Guide May 2005 105 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 i
140. 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 Website Payments Standard Checkout Integration Guide May 2005 45 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 currency of your primary balance Step 2 Choose a payment button to put on your website If you are going to receive payments from your website choose the image
141. 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 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 12 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 Website Payments Standard Checkout Integration Guide May 2005 55 az Creating Shopping Cart Buttons How It Works Step 2 Bob looks at the contents
142. ze your buyer s experience Successful Payment URL Enter the URL where you would like to send your customers after they have completed payment Once customer has completes the payment he sees 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 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 62 May 2005 Website Payments Standard Checkout 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 payments 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

PayPal Website Payments Standard Checkout

Contents

Download Pdf Manuals

Related Search

Related Contents