Integration Guide

PayPal Payments Pro Integration Guide April 2012 71
Integrating Recurring Payments
Modifying a Recurring Payments Profile
6
You can modify only the following specific information about an active or suspended profile:
 Subscriber name or address
 Past due or outstanding amount
 Whether to bill the outstanding amount with the next billing cycle
 Maximum number of failed payments allowed
 Profile description and reference
 Number of additional billing cycles
 Billing amount, tax amount, or shipping amount
NOTE: You cannot modify the billing frequency or billing period of a profile. You can
modify the number of billing cycles in the profile.
You can modify the following profile information during the trial period or regular payment
period.
 Billing amount
 Number of billing cycles
NOTE: For recurring payments with the Express Checkout API, PayPal does not allow certain
updates, such as billing amount, within 3 days of the scheduled billing date.
The profile changes take effect with the next payment after the call to update the profile. Say,
for example, the buyer has made 1 trial payment out of a total of 3. You call
UpdateRecurringPaymentsProfile to increase the number of billing cycles to 5. This
provides the buyer with 4 additional trial payments. If you call
UpdateRecurringPaymentsProfile during the regular payment period, the changes take
effect with the buyer’s next scheduled regular payment.
For complete details, see the Name-Value Pair Developer Guide and Reference or the SOAP
API Reference.
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.