What's
New
Doll
Makers
Room
Makers
Puzzle
Makers
Roiworld Stardoll Smilies Links
    Index



PayPals Payment Overview
PayPal Payment Flow

Getting Started
Managing Account

Creating Buy Now Buttons
Creating Shopping Cart Buttons



Creating PayPals Shopping Cart Buttons

Introduction
How it Works
PayPal Shopping Cart Button Factory
How You Get Your Money
Adding PayPal Checkout to Your Third-Party Shopping Cart



Introduction

When you use PayPal’s free Shopping Cart, your customers can purchase multiple items with a single payment, browse your entire selection, and view a consolidated list of all their items before purchasing. The PayPal Shopping Cart is a low-cost way for you to accept credit card and bank account payments, and can be fully integrated with your website in a few easy steps.
Save time and money with PayPal’s hassle-free Shopping Cart:
  • Easy to implement — html scripting
  • No signup costs — the same low fee schedule for all payments
  • Sell with ease — PayPal keeps detailed transaction records on their website
The PayPal Shopping Cart also offers customizable buttons and secure payments to help you improve your buyer experience.



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, please refer to the PayPal Account Optional section of this manual.

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.

Step 2: Bob looks at the contents of his cart and clicks Checkout.

Step 3: Bob is taken to a PayPal Payment Details page which shows the items he has added to his Cart.

Step 4: Bob is prompted to login to his PayPal account, but he is not already a PayPal member, so he follows the instructions at the top of the screen.

Note: PayPal users will log in to their account and skip Step 5.

Step 5: Bob is then prompted to enter his credit card information, email address, and password, creating his new PayPal account.

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.

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.

With Auto Return for Website Payments, Bob would be redirected back to your site immediately after clicking the Pay button on the Payment Confirmation page. To learn more about Auto Return, please refer to the Auto Return section of this manual.

Step 8: Bob receives an email receipt for this transaction, confirming payment and including a copy of the Payment details.

Step 9: Alice receives an email notification of Bob’s payment.

Step 10: Alice logs into her PayPal account to check the payment Bob has sent.

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.



PayPal Shopping Cart Button Factory

With the PayPal Shopping Cart, your buyers can make a single payment when they purchase multiple items.

And 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.


Note: You also have the option of prepopulating your customer's signup information during the checkout flow. For more information and a list of variables, please refer to the Prepopulating Your Customer's PayPal Signup section of Appendix A in this manual.



Getting Started

  1. Log in to your PayPal account at www.paypal.com.
  2. Click the Merchant Tools tab.
  3. Click the PayPal Shopping Cart link under the Website Payments heading to get to the Button Factory.

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.

Creating Your Shopping Cart Button

Step 1: Enter the details for your 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

Note: All items added to a PayPal Shopping Cart must be denominated in a single currency, which is determined by the currency specified for the first item added to the Cart. Once one item is added to a Cart, buyers will not be allowed to add any items listed in other currencies to that Cart.

To change the currency, buyers must either Checkout and purchase the items in the first currency, or remove all existing items from the Cart and add the items of the second currency. The best option is to list all of your items in the same currency.



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: 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 do not have additional details to add to your button (such as sales tax, shipping, or your logo), click Create Button Now and go to Step 12. Otherwise, click Add More Options to see the fields listed in Step 3 -12.



Step 3: Calculate shipping and tax.

If you have already specified shipping rates in your Profile, they will be listed under Shipping Cost Calculation. For more information about calculating shipping, please refer to the Calculating Shipping, Handling, and Tax section of this manual.

If you have already specified your tax rate from your Profile, it will be listed under Sales Tax Calculation. For more information about calculating tax, please refer to the Calculating Shipping, Handling, and Tax section of this manual.



Step 4: Add option fields to your button.

Let your customers specify information about their purchases by creating an option field. You can use option fields to specify information such as color, size, or gift wrapping. Options must not change the price of an item, but will let you collect additional information from your customer without extra email communication. Each Shopping Cart Button may have up to two option fields, and you may use a drop-down menu or a text box to collect the information.

  • Option Field Type: Choose the type of option field: drop-down menu or text box. If you choose drop-down menu, you will enter the different choices. If you choose text box, your customer will enter his choice.
  • Option Name: Enter the name of your option. There is a 60-character limit on option names.
  • Drop-Down Menu Choices: If you are using a drop-down menu, enter your menu choices. There is a 30-character limit per choice, with a maximum of 10 choices. Use a carriage return (press Enter) to separate each choice.



Step 5: Select a View Cart button.

If you are going to be receiving payments from your website, choose the image for the button you would like your customers to click when they check out and complete their purchases. To display your own image, enter the URL of the image’s location in the URL field.



Step 6: Customize your payment pages.

Custom Payment Page Style

Give your customers a seamless payment experience by customizing PayPal's payment pages to match the style of your website. If you have already added Custom Payment Page Styles in your Profile, they will be listed here. Choose the page style you would like to appear when your customer clicks your Shopping Cart button. For more information about adding, selecting, or changing custom page styles, please refer to the Custom Payment Pages section of this manual.



Step 7: Customize your buyer’s 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, once your customer has completed his payment he will see a payment completion page. From this page, he will click Continue and return to the Successful Payment URL you have specified. If you do not enter a Successful Payment URL, customers who click this link will be taken to a PayPal Web page.

Cancel Payment URL: Enter the URL where you would like to send your customers if they cancel their payments at any point in the Buy Now payment flow. If you do not enter a Cancel Payment URL, customers who click this link will be taken to a PayPal Web page.



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.



Step 9: Collect additional information from your customers

Note: Select Yes if you would like your customers to be able to include a note to you with their payment. If you select No, your customers will not be given the opportunity to include a note.

Note Title: If you are allowing your customers to include a note with their payments, you may choose a title for the note field. By including a title, you can prompt your buyers to enter specific information (like a User ID) or special instructions. There is a 40-character limit on your note field title. If you do not enter a title, your customers will see Special Instructions (optional) as the note field title.

Step 10: Choose an email address to receive payment

If you have more than one confirmed email address added to your PayPal account, you can specify the address at which you would like to receive your email payment notifications when your customers pay you.

Step 11: Copy and paste the PayPal Shopping Cart code

  1. When you have finished filling out the PayPal Shopping Cart Button Factory form, click Continue.
  2. Copy the code from the For Web pages text box by highlighting all of the text and pressing Ctrl+C, or by highlighting all of the text, right-clicking your mouse, and choosing Copy.
  3. Open the Web page file into which you’d like to add your Shopping Cart Button.
  4. Paste the code you just copied into your Web page file wherever you would like the button to appear (typically, next to the description of the item or service) by either pressing Ctrl+V or by right-clicking on your mouse and choosing Paste.

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 code on your Web page to exactly match the code you copied.

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 on 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 will need to include the “View Cart” buttons so your customers may quickly proceed to Checkout when they are ready.

  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, rightclicking on your mouse, and choosing Copy.
  2. Open each Web page from which you would like your customers to be able to get to their PayPal Shopping Carts.
  3. Paste the code you just copied into your Web page file where you would like your “View Cart” button to appear, by either pressing Ctrl+V or by rightclicking on your mouse and choosing Paste.

Note: You also have the option of prepopulating your customer's information. For more information and a list of variables, please refer to the Prepopulating Your Customer's PayPal Signup section of Appendix A in this manual.



How You Get Your Money

After your customer has made his payment:
  1. You will receive an email notification of the payment.
  2. Your customer will receive an email receipt for the payment.
  3. Your PayPal account will reflect the payment. You can view this information from your Account History or download it as part of your History transaction log.


Notifications You Will Receive

You can be notified of payments in these four ways: email, history transaction log, downloadable history transaction log, and, if you have activated it, Instant Payment Notification (IPN).

Email

You will receive an email notification in the following cases:
  • Successful Payment
  • Pending Payment
  • Cancelled Payment
If you do not want to receive payment notifications via email:
  1. Click the Profile subtab of the My Account tab.
  2. Click the Notifications link from the left-hand menu.
  3. Find the Payment Notifications heading and clear the I receive PayPal Website Payments and Instant Purchase checkbox.
  4. Click Save.


History

Your transaction history log (“History”) contains information about your payments. Each payment will have one of these options as its status:
  • Completed: The transaction was successful and the money was credited to your account.
  • Cleared: The eCheck payment has cleared the sender’s account and has been credited to your account.
  • Uncleared: The eCheck payment has not cleared the sender’s account yet.


Downloadable Logs

Log in to your PayPal account, go to the History subtab of the My Account tab and choose the Download My History link in the “Quick Links” menu. Choose the All Activity radio button or enter the dates of the entries you want to download, choose the type of file you would like to download (Comma delimited, Tab delimited, Quicken, or QuickBooks), and click Download History. The downloaded file will contain a record of all of your payments.


Instant Payment Notification (IPN)

If you have Instant Payment Notification activated, you will receive an IPN when a payment is first sent, which will state the status of the payment (Completed or Pending). If the payment was “Pending,” you will receive another IPN when the payment clears, fails, or is denied.

To learn more about IPN, please refer to the Instant Payment Notification section of this manual.



Adding PayPal Checkout to Your Third-Party Shopping Cart

Some Web developers may wish to integrate PayPal payment processing with their own third-party shopping cart instead of the standard PayPal Shopping Cart. Please use the following instructions and variables to allow your buyers to pay with PayPal when they are ready to check out after adding all of their items to your third-party shopping cart.

There are now two ways to integrate your third-party shopping cart with the PayPal payment flow. The first is to pass in the aggregate amount of the Cart payment, rather than of the individual items. The second is to pass details of the items that have been selected to PayPal, instead of an aggregated amount for the entire Cart.

For a complete list of variables, please refer to the Adding PayPal Checkout To Your Third-Party Shopping section of Appendix A in this manual.

Note: Posting the necessary variables to PayPal as described in the following instructions will probably require you to implement some scripting on your website.


Passing the Aggregate Shopping Cart Amount to PayPal

If you wish, you may aggregate your entire shopping cart and pass the total amount into PayPal’s Buy Now code. In other words, you will need to post a single name for the entire cart and the total price of the cart’s contents as though it were a purchase of a single item.

One drawback of this method is that your buyers will not be able to see the individual items appearing in their carts. In addition, you cannot change our variable names, nor can you add your own variable names.


Passing Individual Items to PayPal

If your third-party shopping cart can be configured to pass individual items to PayPal, information about the items will be included in the buyer’s and seller’s History logs and notifications. To include information about the items, you will post HTML form elements to a new version of PayPal’s Shopping Cart flow. This process is much like the one described in Passing Aggregate Shopping Cart Amount to PayPal, with the following exceptions:

  1. Set the cmd variable to _cart.
  2. Replace this required HTML line:
    <input type="hidden" name="cmd" value="_xclick">
    with
    <input type="hidden" name="cmd" value="_cart">
  3. Add a new variable called upload by adding the following line between the <form> and </form> tags:
    <input type="hidden" name="upload" value="1">
  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 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, such as 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 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) will be interpreted in the currency designated by the currency_ code variable that is posted with the payment. Since it is not item-specific, there is no need to append a “_x” to the variable name. If no currency_code variable is posted, we will assume that all monetary values are in U.S. Dollars.

For a complete list of variables, please refer to the Passing Individual Items to PayPal section of Appendix A in this manual.


References:
Paypal's Developer Reference Guide (pdf)




About     Privacy Policy     Hosting by Web Hosting Canada

Except where otherwise noted, this site is licensed under a Creative Commons License



contact us: elouai@gmail.com
©2003-2008 eLouai.com, All rights reserved