Integration Guide

Table Of Contents
Express Checkout Integration Guide May 2010 123
Handling Recurring Payments
Modifying a Recurring Payments Profile
11
z Total number of failed billing cycles
z Date of the last successful payment received
z Amount of the last successful payment received
Modifying a Recurring Payments Profile
Use the UpdateRecurringPaymentsProfile API to modify a recurring payments profile.
NOTE: You can also modify recurring payments profiles from the PayPal website.
You can only modify the following specific information about an active or suspended profile:
z Subscriber name or address
z Past due or outstanding amount
z Whether to bill the outstanding amount with the next billing cycle
z Maximum number of failed payments allowed
z Profile description and reference
z Number of additional billing cycles
z 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.
NOTE: For recurring payments with Express Checkout, certain updates, such as billing
amount, are not allowed within 3 days of the scheduled billing date, and an error is
returned.
You can modify the following profile information during the trial period or regular payment
period.
z Billing amount
z Number of billing cycles
The profile changes take effect with the next payment after the call to update the profile. Say,
for example, the buyer has made one trial payment out of a total of three.
UpdateRecurringPaymentsProfile is called to increase the number of billing cycles to
five. As a result, the buyer will have four additional trial payments to make. If the call to
UpdateRecurringPaymentsProfile is made during the regular payment period, the
changes take effect with the buyers next scheduled regular payment.
For complete details, see the Name-Value Pair Developer Guide and Reference or the SOAP
API Reference.