Integration Guide
Table Of Contents
- Digital Goods Integration Guide - EC Edition
- Contents
- Preface
- Introducing Digital Goods for Express Checkout
- Integrating Digital Goods for Express Checkout
- Issuing Refunds
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Options for Creating a Recurring Payments Profile
- Recurring Payments With the Express Checkout API
- Recurring Payments Profile Status
- Getting Recurring Payments Profile Information
- Modifying a Recurring Payments Profile
- Billing the Outstanding Amount of a Profile
- Recurring Payments Notifications
- Options For Closing the Lightbox or Mini-browser
- Methods For Integrating Digital Goods Into Flash
- Express Checkout API Fields Supported By Digital Goods
- Revision History
Handling Recurring Payments
Billing the Outstanding Amount of a Profile
4
46 January 2012 Digital Goods Integration Guide - EC Edition
Updating Addresses
When you update the subscriber shipping address, you must enter all of address fields, not just
those that are changing:
To update the subscriber’s street address, for example, specify all the address fields listed in
the Name-Value Pair Developer Guide and Reference or SOAP API Reference. Do not specify
only the street address field.
Updating the Billing Amount
For profiles created using Express Checkout, you can increase the recurring payment total
amount by 20% maximum in a fixed 180-day interval after profile creation. The 20%
maximum is based on the total amount of the profile at the beginning of the 180-day interval,
including any shipping or tax amount.
If, for example, you create a profile on March 10 with a total amount of $100, during the 180-
day interval from March 10 to September 6, you can increase the amount to a maximum of
$120 (120% of $100).
Suppose that during the first 180-day interval, you increased the payment amount to $110.
During the next 180-day interval (starting September 7), you can only increase the amount of
the payment to a maximum of $132 (120% of $110).
Billing the Outstanding Amount of a Profile
Use the BillOutstandingAmount API to immediately bill the buyer for the current past
due or outstanding amount for a recurring payments profile.
NOTE: You can also bill the buyer for the current past due or outstanding amount for a
recurring payments profile from the PayPal website.
To bill the outstanding amount:
The profile status must be active or suspended.
NOTE: The BillOutstandingAmount API does not reactivate a suspended profile. You
need to call ManageRecurringProfileStatus to do this.
The profile must have a non-zero outstanding balance.
The amount of the payment cannot exceed the outstanding amount for the profile.
The BillOutstandingAmount call cannot be within 24 hours of a regularly scheduled
payment for this profile.
NOTE: An error occurs when another outstanding balance payment is already queued.
PayPal informs you by IPN about the success or failure of the outstanding payment. For
profiles created using Express Checkout, the buyer receives an email notification of the
payment.