Integration Guide

PayPal Payments Standard Integration Guide June 2012 5
Contents
The Basic Steps for Using the Tool With Donate Buttons . . . . . . . . . . . . . . . . 89
Saving Donate Buttons in Your PayPal Account. . . . . . . . . . . . . . . . . . . . . 90
Adding Advanced Features to Donate Buttons With HTML Variables. . . . . . . . . . 90
Generating Code for Payment Buttons and Email Payment Links . . . . . . . . . . . 91
Protecting HTML Code for Payment Buttons . . . . . . . . . . . . . . . . . . . . . . 91
Step 1 – Specifying Basic Features of Your Donate Button . . . . . . . . . . . . . . . 91
Step 2 – Saving Your Donate Button in Your PayPal Account. . . . . . . . . . . . . . 94
Step 3 – Adding Advanced Features to Your Donate Button . . . . . . . . . . . . . . 95
Copying and Pasting the Donate Code . . . . . . . . . . . . . . . . . . . . . . . . . 97
Avoiding Problems With Pasted HTML Code . . . . . . . . . . . . . . . . . . . . . . 98
Sample HTML Code for Donate Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Sample HTML Code for a Basic Donate Button . . . . . . . . . . . . . . . . . . . . . 99
Sample HTML Code for a Donate Button With a Fixed Contribution Amount . . . . . .100
Creating Donate Buttons with JavaScript Disabled . . . . . . . . . . . . . . . . . . . . .101
Getting Started with Donate Button With JavaScript Disabled. . . . . . . . . . . . . .101
Creating Advanced Donate Buttons With JavaScript Disabled . . . . . . . . . . . . .102
Limitations When Creating Payment Buttons With JavaScript Disabled . . . . . . . .109
Enabling JavaScript in Your Browser . . . . . . . . . . . . . . . . . . . . . . . . . .109
Chapter 3 Recurring Payments – Subscribe Buttons . . . . . . . . 113
Getting Started with Subscribe Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . .113
Creating a Basic Subscribe Button on the PayPal Website . . . . . . . . . . . . . . .114
Creating Subscribe Buttons Before You Create Your PayPal Account . . . . . . . . .115
The Checkout Experience with Subscribe Buttons . . . . . . . . . . . . . . . . . . . . .117
Checkout Starts on Your Website . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
Buyers Choose a Way to Pay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
Buyers Review Their Payment Details . . . . . . . . . . . . . . . . . . . . . . . . .120
Buyers View and Print Payment Confirmations . . . . . . . . . . . . . . . . . . . . .121
Enhancing the Checkout Experience with Subscribe Buttons. . . . . . . . . . . . . .122
Managing Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
Tracking Subscription Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . .124
How Billing Cycles and Recurring Payments Work . . . . . . . . . . . . . . . . . . .127
Downloading Subscriber Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
Canceling Individual Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . .130
Canceling Multiple Subscriptions at One Time . . . . . . . . . . . . . . . . . . . . .131
Suspending Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
Editing a Subscription Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
End-of-Term Messages Sent Through Instant Payment Notification . . . . . . . . . .135
Advanced Features of Subscribe Buttons . . . . . . . . . . . . . . . . . . . . . . . . . .136