Integration Guide

Contents
10 September 2008 Website Payments Standard Integration Guide
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
Appendix A HTML Variables for Website Payments Standard . . . . . 345
Technical HTML Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
HTML Variables for Individual Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
HTML Variables for Payment Transactions . . . . . . . . . . . . . . . . . . . . . . . . .351
HTML Variables for Shopping Carts . . . . . . . . . . . . . . . . . . . . . . . . . . . . .353
HTML Variables for Subscribe Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . .356
HTML Variables for Displaying PayPal Checkout Pages . . . . . . . . . . . . . . . . . .358
HTML Variables for Prepopulating PayPal Checkout Pages. . . . . . . . . . . . . . . . .361