Integration Guide

November 20053
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Chapter 1 How Website Payments Standard Works . . . . . . . . . .15
Example of the Basic Page Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
How You Get Your Money . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Notifications You Receive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Transaction History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Downloadable History Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Instant Payment Notification (IPN). . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
How To Use This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Other Standard Products and Features . . . . . . . . . . . . . . . . . . . . . . . . . 23
Website Payments Pro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Authorization & Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Related Online Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Complementary Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Chapter 2 Using Your Merchant Account Profile and Tools . . . . . .27
The Account Profile Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Account Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Financial Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Selling Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Correspondence Between Profile Settings and HTML Variables . . . . . . . . . . . . 28
Branding PayPal’s Payment Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Working with Custom Payment Pages. . . . . . . . . . . . . . . . . . . . . . . . . . 31
Adding or Editing a Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Making a Page Style Primary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Overriding Page Style Settings On Individual Transactions . . . . . . . . . . . . . . . 33
Streamlining Purchases with Website Payment Preferences . . . . . . . . . . . . . . . . 34
Account Optional or Website Payments Express . . . . . . . . . . . . . . . . . . . . 35
Auto Return . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Automatic Calculation of Shipping and Handling Cost and Tax . . . . . . . . . . . . . 45
Blocking Certain Kinds of Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47