|
The Website Payments Standard Integration Guide describes how to integrate your website
with PayPal by using HTML buttons and forms.
Website Payments Standard lets you accept payments for:
- Single-item purchases with Buy Now buttons – Sell from websites that offer single or mutually exclusive products.
- Contribution payments with Donate buttons – Raise financial support for any cause.
- Recurring bills with Subscribe buttons – Collect membership dues, set up installment plans, and offer other subscription services.
- Multiple-item purchases with Add to Cart and View Cart buttons – Sell from online stores with catalogs and shopping carts.
This guide is for:
- Merchants and developers who want to understand:
– The checkout experiences that people go through when they make payments with Website Payments Standard payment buttons
– How account profile settings affect the way that Website Payments Standard works
- Developers who want to learn how to implement Website Payments Standard
Download PayPal Website Payments Standard Integration Guide
PDF format, 4.2MB, 384Pages.
© 2008 PayPal, Inc.
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Where to Go for More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Chapter 1 Single-Item Payments – Buy Now Buttons . . . . . . . . .17
Getting Started With Buy Now Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Using the Button Creation Tool for a Basic Buy Now Button . . . . . . . . . . . . . . 18
Creating Basic Buy Now Buttons With JavaScript Disabled . . . . . . . . . . . . . . . 19
Creating Buy Now Buttons Before You Create Your PayPal Account . . . . . . . . . . 22
The Checkout Experience With Buy Now Buttons . . . . . . . . . . . . . . . . . . . . . . 25
Begin – Buyers are Ready to Purchase Your Item on Your Website . . . . . . . . . . 26
1 – Buyers Enter Their Billing Information or They Log In to PayPal . . . . . . . . . . 27
2 – Buyers Confirm Their Transaction Details Before Paying . . . . . . . . . . . . . . 29
3 – Buyers View and Print Their PayPal Payment Confirmations . . . . . . . . . . . . 30
End – Buyers Receive Payment Authorization Notices by Email . . . . . . . . . . . . 31
Enhancing the Checkout Experience With Buy Now Buttons . . . . . . . . . . . . . . 32
Managing Buy Now Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Using Email Notices to Track Buy Now Transactions . . . . . . . . . . . . . . . . . . 34
Using Recent Activity to Track Buy Now Transactions . . . . . . . . . . . . . . . . . 35
Using Transaction History to Track Buy Now Transactions . . . . . . . . . . . . . . . 35
Using Downloadable History Logs to Track Buy Now Transactions . . . . . . . . . . . 35
Using Instant Payment Notification to Track Buy Now Transactions . . . . . . . . . . 36
Advanced Features of Buy Now Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Offering Product Options With Buy Now Buttons . . . . . . . . . . . . . . . . . . . . 36
Prompting for Item Quantities With Buy Now Buttons . . . . . . . . . . . . . . . . . . 37
Creating Advanced Buy Now Buttons on the PayPal Website . . . . . . . . . . . . . . . . 37
Generating Code for Payment Buttons and Email Payment Links . . . . . . . . . . . 37
Protecting HTML Code for Payment Buttons . . . . . . . . . . . . . . . . . . . . . . 38
Using the Button Creation Tool for Advanced Buy Now Buttons . . . . . . . . . . . . 38
Creating Advanced Buy Now Buttons With JavaScript Disabled . . . . . . . . . . . . 52
Avoiding Problems With Pasted HTML Code . . . . . . . . . . . . . . . . . . . . . . 61
Sample HTML Code for Buy Now Buttons . . . . . . . . . . . . . . . . . . . . . . . . . 61
Sample HTML Code for a Basic Buy Now Button . . . . . . . . . . . . . . . . . . . . 61
Sample HTML Code for Buy Now Buttons With Product Options . . . . . . . . . . . . 62
Sample HTML Code for a Buy Now Button that Prompts for Quantities. . . . . . . . . 66
Sample URL Code for a Buy Now Email Payment Link . . . . . . . . . . . . . . . . . . . 67
Chapter 2 Contribution Payments – Donate Buttons . . . . . . . . . .69
Getting Started With Donate Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Using the Button Creation Tool for a Basic Donate Button . . . . . . . . . . . . . . . 70
Creating Basic Donate Buttons With JavaScript Disabled. . . . . . . . . . . . . . . . 71
Creating Donate Buttons Before You Create Your PayPal Account . . . . . . . . . . . 74
The Checkout Experience With Donate Buttons . . . . . . . . . . . . . . . . . . . . . . . 76
Begin – Donors are Ready to Contribute on Your Website . . . . . . . . . . . . . . . 77
1 – Donors Enter Their Billing Information or They Log In to PayPal . . . . . . . . . . 78
2 – Donors Confirm Their Contribution Details Before Paying. . . . . . . . . . . . . . 80
3 – Donors View and Print Their PayPal Contribution Confirmations . . . . . . . . . . 81
End – Donors Receive Contribution Authorization Notices by Email . . . . . . . . . . 82
Enhancing the Checkout Experience With Donate Buttons . . . . . . . . . . . . . . . 83
Managing Contributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Using Email Notices to Track Donate Transactions . . . . . . . . . . . . . . . . . . . 85
Using Recent Activity to Track Donate Transactions . . . . . . . . . . . . . . . . . . 85
Using Transaction History to Track Donate Transactions . . . . . . . . . . . . . . . . 86
Using Downloadable History Logs to Track Donate Transactions . . . . . . . . . . . . 86
Using Instant Payment Notification to Track Donate Transactions . . . . . . . . . . . 86
Creating Advanced Donate Buttons on the PayPal Website. . . . . . . . . . . . . . . . . 87
Generating Code for Payment Buttons and Email Payment Links . . . . . . . . . . . 87
Protecting HTML Code for Payment Buttons . . . . . . . . . . . . . . . . . . . . . . 87
Using the Button Creation Tool for Advanced Donate Buttons . . . . . . . . . . . . . 87
Creating Advanced Donate Buttons With JavaScript Disabled . . . . . . . . . . . . . 97
Avoiding Problems With Pasted HTML Code . . . . . . . . . . . . . . . . . . . . . .104
Sample HTML Code for Donate Buttons . . . . . . . . . . . . . . . . . . . . . . . . . .104
Sample HTML Code for a Basic Donate Button . . . . . . . . . . . . . . . . . . . . .105
Sample HTML Code for a Donate Button With a Fixed Contribution Amount . . . . . .105
Chapter 3 Recurring Payments – Subscribe Buttons . . . . . . . . 107
Getting Started With Subscribe Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . .108
Using the Button Creation Tool for a Basic Subscribe Button . . . . . . . . . . . . . .108
Creating Basic Subscribe Buttons With JavaScript Disabled . . . . . . . . . . . . . .109
Creating Subscribe Buttons Before You Create Your PayPal Account . . . . . . . . .112
The Checkout Experience With Subscribe Buttons . . . . . . . . . . . . . . . . . . . . .115
Begin – Subscribers Are Ready to Sign Up on Your Website . . . . . . . . . . . . . .116
1 – Subscribers Enter Their Billing Information or They Log In to PayPal . . . . . . . .116
2 – Subscribers Confirm Their Subscription Details Before Signing Up . . . . . . . . .119
3 – Subscribers View and Print Their Subscription Confirmations. . . . . . . . . . . .120
End – Subscribers Receive Subscription Authorization Notices by Email . . . . . . . .121
Enhancing the Checkout Experience With Subscribe Buttons . . . . . . . . . . . . .122
Managing Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
Tracking Subscription Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . .124
How Billing Cycles and Recurring Payments Work . . . . . . . . . . . . . . . . . . .126
Downloading Subscriber Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
Canceling Individual Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . .128
Canceling Multiple Subscriptions at One Time . . . . . . . . . . . . . . . . . . . . .129
End of Term Messages Sent Through Instant Payment Notification. . . . . . . . . . .131
Advanced Features of Subscribe Buttons . . . . . . . . . . . . . . . . . . . . . . . . . .132
Offering Trial Periods and Introductory Rates With Subscribe Buttons . . . . . . . . .132
Limiting the Number of Billing Cycles With Subscribe Buttons . . . . . . . . . . . . .133
Offering Product Options With Subscribe Buttons . . . . . . . . . . . . . . . . . . . .134
Working With Modify Subscription Buttons . . . . . . . . . . . . . . . . . . . . . . .134
Working With Unsubscribe Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . .137
Generating Usernames and Passwords With Subscribe Buttons . . . . . . . . . . . .139
Reattempting Failed Recurring Payments With Subscribe Buttons . . . . . . . . . . .141
Creating Advanced Subscribe Buttons on the PayPal Website . . . . . . . . . . . . . . .142
Generating Code for Payment Buttons and Email Payment Links . . . . . . . . . . .142
Protecting HTML Code for Payment Buttons . . . . . . . . . . . . . . . . . . . . . .142
Using the Button Creation Tool for Advanced Subscribe Buttons . . . . . . . . . . . .142
Creating Advanced Subscribe Buttons With JavaScript Disabled . . . . . . . . . . . .155
Avoiding Problems With Pasted HTML Code . . . . . . . . . . . . . . . . . . . . . .165
Sample HTML Code for Subscribe Buttons . . . . . . . . . . . . . . . . . . . . . . . . .165
Sample HTML Code for a Basic Subscribe Button . . . . . . . . . . . . . . . . . . .165
Sample HTML Code for a Subscribe Button With Trial Periods . . . . . . . . . . . . .166
Sample HTML Code for a Subscribe Button With Limits on Billing Cycles . . . . . . .167
Sample HTML Code for Subscribe Buttons With Product Options . . . . . . . . . . .168
Sample HTML Code for a Modify Subscription Button . . . . . . . . . . . . . . . . .170
Sample HTML Code for an Unsubscribe Button. . . . . . . . . . . . . . . . . . . . .171
Sample HTML Code for a Subscribe Button With Password Management . . . . . . .172
Sample HTML Code for a Subscribe Button That Reattempts Payments . . . . . . . .172
Sample URL Code for Subscribe Email Payment Links . . . . . . . . . . . . . . . . . . .173
Chapter 4 The PayPal Shopping Cart – Add to Cart and View Cart
Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Getting Started With The PayPal Shopping Cart. . . . . . . . . . . . . . . . . . . . . . .176
Getting Started With Add To Cart Buttons . . . . . . . . . . . . . . . . . . . . . . . .176
Getting Started With View Cart Buttons . . . . . . . . . . . . . . . . . . . . . . . . .183
The Checkout Experience With the PayPal Shopping Cart . . . . . . . . . . . . . . . . .191
Begin – Buyers Add Your Items to the PayPal Shopping Cart. . . . . . . . . . . . . .193
1 – Buyers Enter Their Billing Information or They Log In To PayPal . . . . . . . . . .194
2 – Buyers Confirm Their Transaction Details Before Paying . . . . . . . . . . . . . .196
3 – Buyers View and Print Their PayPal Payment Confirmations . . . . . . . . . . . .197
End – Buyers Receive Payment Authorization Notices by Email . . . . . . . . . . . .198
Enhancing the Checkout Experience With Add to Cart Buttons . . . . . . . . . . . . .200
Managing PayPal Shopping Cart Transactions . . . . . . . . . . . . . . . . . . . . . . .201
Using Email Notices to Track PayPal Shopping Cart Transactions . . . . . . . . . . .201
Using Recent Activity to Track PayPal Shopping Cart Transactions . . . . . . . . . .202
Using Transaction History to Track PayPal Shopping Cart Transactions . . . . . . . .202
Using Downloadable History Logs to Track PayPal Shopping Cart Transactions . . . .203
Using Instant Payment Notification to Track PayPal Shopping Cart Transactions . . .203
Advanced Features of Add to Cart Buttons . . . . . . . . . . . . . . . . . . . . . . . . .203
Offering Product Options With Add to Cart Buttons . . . . . . . . . . . . . . . . . . .203
Creating Advanced PayPal Shopping Cart Buttons on the PayPal Website. . . . . . . . .204
Generating Code for Payment Buttons and Email Payment Links . . . . . . . . . . .204
Protecting HTML Code for Payment Buttons . . . . . . . . . . . . . . . . . . . . . .204
Pricing Items in Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . .205
Working with View Cart Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
Using the Button Creation Tool for Advanced Add to Cart Buttons . . . . . . . . . . .205
Creating Advanced Add to Cart Buttons With JavaScript Disabled . . . . . . . . . . .220
Avoiding Problems With Pasted HTML Code . . . . . . . . . . . . . . . . . . . . . .228
Sample HTML Code for Add to Cart Buttons . . . . . . . . . . . . . . . . . . . . . . . .228
Sample HTML Code for a Basic Add to Cart Button. . . . . . . . . . . . . . . . . . .229
Sample HTML Code for Add to Cart Buttons With Product Options. . . . . . . . . . .229
Sample HTML Code for Add to Cart Buttons that Open the Shopping Cart in the Merchant
Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
Sample HTML Code for Add to Cart Buttons that Continue Shopping on the Current
Merchant Webpage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
Sample HTML Code for View Cart Buttons . . . . . . . . . . . . . . . . . . . . . . . . .238
Sample HTML Code for a View Cart Button . . . . . . . . . . . . . . . . . . . . . . .239
Sample HTML Code for a View Cart Button That Opens the Shopping Cart in the Merchant
Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
Sample HTML Code for View Cart Buttons that Continue Shopping on the Current
Merchant Webpage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .240
Chapter 5 Third-Party Shopping Carts – The Cart Upload Command 243
How A Third Party Shopping Cart Works . . . . . . . . . . . . . . . . . . . . . . . . . .243
What The Buyer Sees With Third Party Shopping Carts . . . . . . . . . . . . . . . .243
What Merchants See . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248
Integrating PayPal with Third Party Shopping Carts . . . . . . . . . . . . . . . . . . . . .249
Required Third Party Shopping Cart Variables . . . . . . . . . . . . . . . . . . . . .249
Passing Individual Item Details to PayPal . . . . . . . . . . . . . . . . . . . . . . . .249
Setting the Tax for the Entire Cart . . . . . . . . . . . . . . . . . . . . . . . . . . . .251
Setting the Shipping Charge for the Entire Cart . . . . . . . . . . . . . . . . . . . . .251
Setting the Weight for the Entire Cart . . . . . . . . . . . . . . . . . . . . . . . . . .251
Passing the Aggregate Shopping Cart Amount to PayPal. . . . . . . . . . . . . . . .251
Securing Your Shopping Cart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251
Chapter 6 Securing Your Website Payments Standard Buttons . . . 253
Creating Protected Payment Buttons on the PayPal Website . . . . . . . . . . . . . . . .254
How Protected Payment Buttons Help Prevent Fraudulent Payments . . . . . . . . .254
Using the Button Creation Tool to Create a Protected Payment Button . . . . . . . . .254
Creating a Protected Payment Button with JavaScript Disabled . . . . . . . . . . . .255
Saving Payment Buttons in Your PayPal Account . . . . . . . . . . . . . . . . . . . . . .256
Reconciling Payments Manually Through Transaction History . . . . . . . . . . . . . . .257
Reconciling Payments Through Instant Payment Notification . . . . . . . . . . . . . . . .258
Protecting Payment Buttons by Using Encrypted Website Payments . . . . . . . . . . . .258
How Encrypted Website Payments Helps Prevent Fraudulent Payments . . . . . . . .258
Public Key Encryption Used by Encrypted Website Payments . . . . . . . . . . . . .259
Setting Up Certificates Before Using Encrypted Website Payments . . . . . . . . . .260
Using Encrypted Website Payments to Protect Your Payment Buttons . . . . . . . . .262
Blocking Unprotected and Non-encrypted Website Payments. . . . . . . . . . . . . . . .264
Chapter 7 Using Your PayPal Account Profile . . . . . . . . . . . . 265
The Account Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
Account Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
Financial Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
Selling Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .266
Correspondence Between Profile Settings and HTML Variables . . . . . . . . . . . .266
Co-Branding the PayPal Checkout Pages . . . . . . . . . . . . . . . . . . . . . . . . . .267
Working With Custom Payment Pages . . . . . . . . . . . . . . . . . . . . . . . . .268
Adding or Editing a Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269
Making a Page Style Primary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270
Overriding Page Styles On Individual Payment Buttons. . . . . . . . . . . . . . . . .270
Overriding Co-Branding Options on Individual Payment Buttons . . . . . . . . . . . .271
Tailoring the Checkout Experience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
Auto Return . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
Getting Contact Telephone Numbers . . . . . . . . . . . . . . . . . . . . . . . . . .274
PayPal Account Optional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .276
Automatic Calculation of Sales Tax . . . . . . . . . . . . . . . . . . . . . . . . . . . . .285
Displaying the Sales Tax that PayPal Calculates During Checkout . . . . . . . . . . .286
Accessing Your Sales Tax Rates in Your Account Profile . . . . . . . . . . . . . . . .286
Setting Up Domestic Sales Tax Rates . . . . . . . . . . . . . . . . . . . . . . . . . .287
Setting Up International Sales Tax Rates . . . . . . . . . . . . . . . . . . . . . . . .289
Resolving Overlapping Sales Tax Rates. . . . . . . . . . . . . . . . . . . . . . . . .289
Editing or Deleting Sales Tax Rates . . . . . . . . . . . . . . . . . . . . . . . . . . .290
Overriding Sales Tax Calculations on Individual Transactions . . . . . . . . . . . . .290
Automatic Calculation of Shipping Charges (U.S. Merchants Only) . . . . . . . . . . . .290
Displaying the Shipping Charges that PayPal Calculates During Checkout. . . . . . .291
Shipping Regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .293
Shipping Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294
Shipping Rate Bases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294
Shipping Rate Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294
Shipping Rates and Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295
Adding Shipping Rates for the First Time . . . . . . . . . . . . . . . . . . . . . . . .295
Adding Shipping Methods by Using a Wizard . . . . . . . . . . . . . . . . . . . . . .296
Viewing, Editing, and Adding Shipping Rates . . . . . . . . . . . . . . . . . . . . . .298
Viewing the Configuration of an Existing Shipping Method . . . . . . . . . . . . . . .300
Editing the Configuration Settings of an Existing Shipping Method . . . . . . . . . . .300
Deleting Shipping Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301
Examples of Rate Bases and Shipping Calculations . . . . . . . . . . . . . . . . . .302
Overriding Shipping Calculations on Individual Transactions . . . . . . . . . . . . . .303
Automatic Calculation of Shipping Charges (non-U.S. Merchants Only) . . . . . . . . . .304
Examples of Cost Methods and Shipping Calculations . . . . . . . . . . . . . . . . .305
Overriding Shipping Calculation on Individual Transactions. . . . . . . . . . . . . . .306
Blocking Certain Kinds of Payments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
Accessing Your Payment Receiving Preferences to Block Payments . . . . . . . . . .307
Blocking Payments From U.S. Payers Without a Confirmed Address. . . . . . . . . .308
Blocking Payments in Currencies That You Do Not Hold . . . . . . . . . . . . . . . .309
Blocking Payments from Payers With Non-U.S. PayPal Accounts . . . . . . . . . . .309
Blocking Payments Initiated Through the Pay Anyone Subtab . . . . . . . . . . . . .310
Blocking Payments by Credit Card Instead of Bank Account . . . . . . . . . . . . . .310
Blocking Payments Funded With eChecks . . . . . . . . . . . . . . . . . . . . . . .310
Adding Your Credit Card Statement Name. . . . . . . . . . . . . . . . . . . . . . . . . .310
Allowing Multiple Users to Access Your PayPal Account . . . . . . . . . . . . . . . . . .312
Adding a User Login to Your Account . . . . . . . . . . . . . . . . . . . . . . . . . .312
Changing the Privileges for a User Login . . . . . . . . . . . . . . . . . . . . . . . .313
Resetting the Password for a User Login . . . . . . . . . . . . . . . . . . . . . . . .314
Removing a User Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315
Handling Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315
Managing Currency Balances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316
Accepting or Denying Cross-Currency Payments . . . . . . . . . . . . . . . . . . . .317
Language Encoding Your Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
About Language Encoding for Exchanging Data With PayPal . . . . . . . . . . . . .318
Changing Your Default Language Encoding. . . . . . . . . . . . . . . . . . . . . . .318
Chapter 8 Using Authorization & Capture . . . . . . . . . . . . . . 321
Basic Authorization Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321
Honor Period and Authorization Period . . . . . . . . . . . . . . . . . . . . . . . . .321
Basic Authorization & Capture Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . .322
Capturing A Single Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
Batch Capturing Multiple Authorizations . . . . . . . . . . . . . . . . . . . . . . . . .323
Voiding an Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
Capture Within 3 Days. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
Capture From 4 - 29 Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
One Authorization, Multiple Captures, and a Refund . . . . . . . . . . . . . . . . . .326
Lower Capture Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
Capture Up to 115% . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
Authorization Expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
Void . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
Reattempted Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331
Recommendations for Best Use of Authorization & Capture . . . . . . . . . . . . . . . .332
Capturing Funds on Basic Authorizations . . . . . . . . . . . . . . . . . . . . . . . .332
Buyer Approval for Basic Authorizations. . . . . . . . . . . . . . . . . . . . . . . . .332
Voiding Basic Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .332
Chapter 9 Issuing Refunds . . . . . . . . . . . . . . . . . . . . . . 333
Refunding Within 60 Days of Payment. . . . . . . . . . . . . . . . . . . . . . . . . . . .333
Refunding After 60 Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333
Chapter 10 Testing Payment Buttons in the PayPal Sandbox . . . . . 335
Chapter 11 HTML Form Basics for Website Payments Standard . . . 337
Form Attributes – ACTION and METHOD . . . . . . . . . . . . . . . . . . . . . . . . . .337
Hidden Input Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337
Specifying the Kind of Payment Button – cmd . . . . . . . . . . . . . . . . . . . . . . . .338
Variations on Basic Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338
Record Keeping with Passthrough Variables . . . . . . . . . . . . . . . . . . . . . .338
Setting the Character Set – charset . . . . . . . . . . . . . . . . . . . . . . . . . . .339
Setting The Return URL on Individual Transactions. . . . . . . . . . . . . . . . . . .339
Desired Currency on Individual Transactions . . . . . . . . . . . . . . . . . . . . . .340
Using HTML Variables With Saved Payment Buttons . . . . . . . . . . . . . . . . . . . .340
Prepopulating FORMs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341
Sample HTML for FORM Prepopulation . . . . . . . . . . . . . . . . . . . . . . . . .341
Overriding Addresses Stored With PayPal. . . . . . . . . . . . . . . . . . . . . . . . . .342
Sample HTML for Overriding Addresses Stored With PayPal . . . . . . . . . . . . . .342
Instant Payment Notification – notify_url . . . . . . . . . . . . . . . . . . . . . . . . . . .343
Visit PayPal, Inc. Website
PayPal is the safer, easier way to pay and get paid online. The service allows anyone to pay in any way they prefer, including through credit cards, bank accounts, buyer credit or account balances, without sharing financial information.
PayPal has quickly become a global leader in online payment solutions with more than 153 million accounts worldwide. Available in 190 markets and 18 currencies around the world, PayPal enables global ecommerce by making payments possible across different locations, currencies, and languages.
PayPal has received more than 20 awards for excellence from the internet industry and the business community -most recently the 2006 Webby Award for Best Financial Services Site and the 2006 Webby People's Voice Award for Best Financial Services Site.
Located in San Jose, California, PayPal was founded in 1998 and was acquired by eBay in 2002.
|