Integration Guide
Table Of Contents
- Website Payments Standard Integration Guide
- Contents
- Preface
- Single-Item Payments - Buy Now Buttons
- Getting Started With Buy Now Buttons
- The Checkout Experience With Buy Now Buttons
- Begin - Buyers are Ready to Purchase Your Item on Your Website
- 1 - Buyers Enter Their Billing Information or They Log In to PayPal
- 2 - Buyers Confirm Their Transaction Details Before Paying
- 3 - Buyers View and Print Their PayPal Payment Confirmations
- End - Buyers Receive Payment Authorization Notices by Email
- Enhancing the Checkout Experience With Buy Now Buttons
- Managing Buy Now Transactions
- Advanced Features of Buy Now Buttons
- Creating Advanced Buy Now Buttons on the PayPal Website
- Sample HTML Code for Buy Now Buttons
- Sample URL Code for a Buy Now Email Payment Link
- Contribution Payments - Donate Buttons
- Getting Started With Donate Buttons
- The Checkout Experience With Donate Buttons
- Begin - Donors are Ready to Contribute on Your Website
- 1 - Donors Enter Their Billing Information or They Log In to PayPal
- 2 - Donors Confirm Their Contribution Details Before Paying
- 3 - Donors View and Print Their PayPal Contribution Confirmations
- End - Donors Receive Contribution Authorization Notices by Email
- Enhancing the Checkout Experience With Donate Buttons
- Managing Contributions
- Creating Advanced Donate Buttons on the PayPal Website
- Sample HTML Code for Donate Buttons
- Recurring Payments - Subscribe Buttons
- Getting Started With Subscribe Buttons
- The Checkout Experience With Subscribe Buttons
- Begin - Subscribers Are Ready to Sign Up on Your Website
- 1 - Subscribers Enter Their Billing Information or They Log In to PayPal
- 2 - Subscribers Confirm Their Subscription Details Before Signing Up
- 3 - Subscribers View and Print Their Subscription Confirmations
- End - Subscribers Receive Subscription Authorization Notices by Email
- Enhancing the Checkout Experience With Subscribe Buttons
- Managing Subscriptions
- Advanced Features of Subscribe Buttons
- Offering Trial Periods and Introductory Rates With Subscribe Buttons
- Limiting the Number of Billing Cycles With Subscribe Buttons
- Offering Product Options With Subscribe Buttons
- Working With Modify Subscription Buttons
- Working With Unsubscribe Buttons
- Generating Usernames and Passwords With Subscribe Buttons
- Reattempting Failed Recurring Payments With Subscribe Buttons
- Creating Advanced Subscribe Buttons on the PayPal Website
- Sample HTML Code for Subscribe Buttons
- Sample HTML Code for a Basic Subscribe Button
- Sample HTML Code for a Subscribe Button With Trial Periods
- Sample HTML Code for a Subscribe Button With Limits on Billing Cycles
- Sample HTML Code for Subscribe Buttons With Product Options
- Sample HTML Code for a Modify Subscription Button
- Sample HTML Code for an Unsubscribe Button
- Sample HTML Code for a Subscribe Button With Password Management
- Sample HTML Code for a Subscribe Button That Reattempts Payments
- Sample URL Code for Subscribe Email Payment Links
- The PayPal Shopping Cart - Add to Cart and View Cart Buttons
- Getting Started With The PayPal Shopping Cart
- The Checkout Experience With the PayPal Shopping Cart
- Begin - Buyers Add Your Items to the PayPal Shopping Cart
- 1 - Buyers Enter Their Billing Information or They Log In To PayPal
- 2 - Buyers Confirm Their Transaction Details Before Paying
- 3 - Buyers View and Print Their PayPal Payment Confirmations
- End - Buyers Receive Payment Authorization Notices by Email
- Enhancing the Checkout Experience With Add to Cart Buttons
- Managing PayPal Shopping Cart Transactions
- Using Email Notices to Track PayPal Shopping Cart Transactions
- Using Recent Activity to Track PayPal Shopping Cart Transactions
- Using Transaction History to Track PayPal Shopping Cart Transactions
- Using Downloadable History Logs to Track PayPal Shopping Cart Transactions
- Using Instant Payment Notification to Track PayPal Shopping Cart Transactions
- Advanced Features of Add to Cart Buttons
- Creating Advanced PayPal Shopping Cart Buttons on the PayPal Website
- Generating Code for Payment Buttons and Email Payment Links
- Protecting HTML Code for Payment Buttons
- Pricing Items in Multiple Currencies
- Working with View Cart Buttons
- Using the Button Creation Tool for Advanced Add to Cart Buttons
- Creating Advanced Add to Cart Buttons With JavaScript Disabled
- Avoiding Problems With Pasted HTML Code
- Sample HTML Code for Add to Cart Buttons
- Sample HTML Code for View Cart Buttons
- Third-Party Shopping Carts - The Cart Upload Command
- Securing Your Website Payments Standard Buttons
- Creating Protected Payment Buttons on the PayPal Website
- Saving Payment Buttons in Your PayPal Account
- Reconciling Payments Manually Through Transaction History
- Reconciling Payments Through Instant Payment Notification
- Protecting Payment Buttons by Using Encrypted Website Payments
- Blocking Unprotected and Non-encrypted Website Payments
- Using Your PayPal Account Profile
- The Account Profile
- Co-Branding the PayPal Checkout Pages
- Tailoring the Checkout Experience
- Automatic Calculation of Sales Tax
- Displaying the Sales Tax that PayPal Calculates During Checkout
- Accessing Your Sales Tax Rates in Your Account Profile
- Setting Up Domestic Sales Tax Rates
- Setting Up International Sales Tax Rates
- Resolving Overlapping Sales Tax Rates
- Editing or Deleting Sales Tax Rates
- Overriding Sales Tax Calculations on Individual Transactions
- Automatic Calculation of Shipping Charges (U.S. Merchants Only)
- Displaying the Shipping Charges that PayPal Calculates During Checkout
- Shipping Regions
- Shipping Methods
- Shipping Rate Bases
- Shipping Rate Tables
- Shipping Rates and Currencies
- Adding Shipping Rates for the First Time
- Adding Shipping Methods by Using a Wizard
- Viewing, Editing, and Adding Shipping Rates
- Viewing the Configuration of an Existing Shipping Method
- Editing the Configuration Settings of an Existing Shipping Method
- Deleting Shipping Methods
- Examples of Rate Bases and Shipping Calculations
- Overriding Shipping Calculations on Individual Transactions
- Automatic Calculation of Shipping Charges (non-U.S. Merchants Only)
- Blocking Certain Kinds of Payments
- Accessing Your Payment Receiving Preferences to Block Payments
- Blocking Payments From U.S. Payers Without a Confirmed Address
- Blocking Payments in Currencies That You Do Not Hold
- Blocking Payments from Payers With Non-U.S. PayPal Accounts
- Blocking Payments Initiated Through the Pay Anyone Subtab
- Blocking Payments by Credit Card Instead of Bank Account
- Blocking Payments Funded With eChecks
- Adding Your Credit Card Statement Name
- Allowing Multiple Users to Access Your PayPal Account
- Handling Multiple Currencies
- Language Encoding Your Data
- Using Authorization & Capture
- Issuing Refunds
- Testing Payment Buttons in the PayPal Sandbox
- HTML Form Basics for Website Payments Standard
- HTML Variables for Website Payments Standard
- Address Handling (U.S. Merchants Only)
- Country Codes
- Index
Website Payments Standard Integration Guide September 2008 139
Recurring Payments – Subscribe Buttons
Advanced Features of Subscribe Buttons
3
z PayPal collects no more recurring payments from Bob.
Creating Unsubscribe Buttons
Do one of following to add Unsubscribe buttons to your website:
z Create an Unsubscribe button as an optional step when you create your Subscribe button by
using the creation tool on the PayPal website
See one of the following:
– “Using the Button Creation Tool for an Unsubscribe Button” on page 154
– Step 2 of “Page 2 – Specifying Advanced Features of Your Subscribe Button” on
page 159
z Write the HTML code for Cancel Subscription buttons manually.
See “Sample HTML Code for an Unsubscribe Button” on page 171.
Generating Usernames and Passwords With Subscribe Buttons
Let PayPal generate unique usernames and passwords for your subscribers when they sign up
for subscription memberships to your website. Use PayPal Subscriptions Password
Management to enable access to members only content on your website automatically.
IMPORTANT: Subscriptions Password Management and Auto Return are incompatible.
Turn Auto Return off if you want PayPal to manage subscription passwords.
For more information, see “Auto Return” on page 271.
How Subscriptions Password Management Works
After subscribers sign up for your subscription, PayPal generates their usernames and
passwords automatically. PayPal displays the generated values to subscribers on the PayPal
payment confirmation page and in the PayPal confirmation email. In addition, PayPal displays
generated usernames and initial passwords to subscribers from their PayPal accounts.
Your website uses the generated usernames and initial passwords to set up new accounts so
that your subscribers can log in. Your website receives new subscription messages through
Instant Payment Notification, which requires advanced programming skills to implement.
After you implement Instant Payment Notification on your website, you write additional
programming code that captures the generated usernames and initial passwords for new
subscriptions. You should also write code to capture cancellation and end-of-term notices, so
that you can update your member database to turn off access to members only content.
For more information about Instant Payment Notification, see the Order Management
Integration Guide.
Downloading the Subscriptions Password Management Perl Script
PayPal provides a Perl script that you can use to help automate access to members only
content for new subscribers, provided your website uses “Basic Authentication” with an
Apache web server that runs on Linux. The Perl script interacts with Instant Payment
Notification to automatically activate and deactivate subscriber accounts on your website.