Integration Guide
Table Of Contents
- Express Checkout Integration Guide
- Contents
- Preface
- Introducing Express Checkout
- Express Checkout Button and Logo Image Integration
- PayPal Name-Value Pair API Basics
- Implementing the Simplest Express Checkout Integration
- Testing an Express Checkout Integration
- Customizing Express Checkout
- Implementing the Instant Update API
- Immediate Payment
- Handling Payment Settlements
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Recurring Payments With Express Checkout
- Options for Creating a Recurring Payments Profile
- Recurring Payments Profile Status
- Getting Recurring Payments Profile Information
- Modifying a Recurring Payments Profile
- Billing the Outstanding Amount of a Profile
- Recurring Payments Notifications
- Using Other PayPal API Operations
- Integrating giropay with Express Checkout
Express Checkout Integration Guide October 2009 101
Handling Recurring Payments
Recurring Payments Notifications
10
z The profile must have a non-zero outstanding balance.
z The amount of the payment cannot exceed the outstanding amount for the profile.
z The BillOutstandingAmount call cannot be within 24 hours of a regularly scheduled
payment for this profile.
NOTE: If another outstanding balance payment is already queued, an API error is returned.
You will be informed by IPN about the success or failure of the outstanding payment. For
profiles created using Express Checkout, the buyer will receive an email notification of the
payment.
Recurring Payments Notifications
Merchants are notified of recurring payments events through IPN and email.
Merchants are notified of certain events through IPN. For recurring payments profiles created
using Express Checkout, buyers are also notified of specific events by email. The following
table indicates when IPN and emails are generated.
Recurring payments instant payment notifications and email
NOTE: API transactions such as ManangeRecurringPaymentsProfileStatus do not
trigger IPN notification because the success or failure of the call is immediately
provided by the API response.
Event IPN Buyer Email
Profile successfully created Yes Yes
Profile creation failed Yes Yes
Profile canceled from paypal.com interface Yes Yes
Profile status changed using API No Yes
Profile update using API No Yes
Initial payment either succeeded or failed Yes Yes
Payment either succeeded or failed (during either trial
period or regular payment period)
Yes Yes
Outstanding payment either succeeded or failed Yes Yes
Maximum number of failed payments reached Yes No