User's Manual
Table Of Contents
- Preface
- Introduction
- PayPal Payments Overview
- Getting Started
- PayPal Account Optional
- Creating Buy Now and Donation Buttons
- Creating Shopping Cart Buttons
- Adding PayPal to Your Third- party Shopping Cart
- Custom Payment Pages
- Calculating Shipping, Handling, and Tax
- Creating Customer Contact Telephone
- Auto Return
- Backend Integration - Payment Notifications
- Using Multiple Currencies
- Language Encoding for Your Data
- Testing
- Processing eChecks
- Security
- HTML Samples
- IPN and PDT Variables
- About These Tables of Variables
- test_ipn Variable in Sandbox
- IPN Variables in All Posts
- Buyer Information
- Basic Information
- Advanced and Custom Information
- Shopping Cart Information
- Currency and Currency Exchange
- Auctions
- Mass Payment
- Subscriptions Variables
- Dispute Notification Variables
- PDT-Specific Variables
- Country Codes
Merchant User Manual and Integration Guide May, 2005 9
Contents
Notification Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
Button Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
Multi-User Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
Using Secure Socket Layer (SSL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
SSL Certificate Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
Appendix A HTML Samples. . . . . . . . . . . . . . . . . . . . . . . 131
PayPal Buy Now and Donation Buttons HTML and Variables . . . . . . . . . . . . . . . .131
Integrating Buy Now Buttons with your Shopping Cart . . . . . . . . . . . . . . . . .131
Sample Buy Now Button HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
Sample Buy Now Hyperlink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
Buy Now and Donations HTML and Hyperlink Variables . . . . . . . . . . . . . . . .132
PayPal Shopping Cart HTML and Variables . . . . . . . . . . . . . . . . . . . . . . . . .137
PayPal Shopping Cart HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
Standard Add to Cart HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
Shopping Cart Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
Adding PayPal Checkout To Your Third-Party Shopping Cart. . . . . . . . . . . . . .138
Passing Individual Items to PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . .139
Prepopulating Your Customer’s PayPal Sign-Up . . . . . . . . . . . . . . . . . . . . . .141
Prepopulation for Website Payments Buttons . . . . . . . . . . . . . . . . . . . . . .141
Prepopulation for Account Signup . . . . . . . . . . . . . . . . . . . . . . . . . . . .142
Sample HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
Appendix B IPN and PDT Variables . . . . . . . . . . . . . . . . . . 145
About These Tables of Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
test_ipn Variable in Sandbox. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
IPN Variables in All Posts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
Buyer Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
Basic Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
Advanced and Custom Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148
Shopping Cart Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148
Currency and Currency Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152
Auctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
Mass Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154
Subscriptions Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156