Changing the Amount of a PayPal Subscription

cambo picture cambo · Oct 3, 2011 · Viewed 14.4k times · Source

We are using PayPal subscriptions to automatically make ongoing monthly donations. The user initially creates a subscription with some pre-determined monthly donation amount (e.g., say $50/month). This creates a recurring subscription which we process by way of IPN. All good there. But, our interface allows the user to come in and change their monthly donation amount, say from $50/month to $100/month. I am wondering how I can change the PayPal subscription to reflect this new amount?

There is a method in PayPal's NVP API called "UpdateRecurringPaymentsProfile" which says I can update the subscription amount, but unfortunately it says:

For recurring payments with Express Checkout, the payment amount can be increased by no more than 20% every 180 days (starting when the profile is created).

(reference: https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_r_UpdateRecurringPaymentsProfile)

To be honest, PayPal's API's are quite confusing so I'm not sure if I am using the Express Checkout or not. (We are creating Subscription buttons using the simple Website Payment Standard API).

Will this work? If not, is there an alternative to achieve what we need?

Thanks!

Answer

SgtPooki picture SgtPooki · Aug 31, 2012

I'm not sure if I am using the Express Checkout or not. (We are creating Subscription buttons using the simple Website Payment Standard API).

I hope rereading the above, you will realize that you answered your own question: You are using Website Payments Standard (WPS) not Express Checkout (EC).

With WPS, you can create a subscription modify button but this is super inflexible and I would not recommend it.

With EC, you can modify subscriptions as well (page 99):

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:

  • 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.

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:

  • Billing amount (excluding tax and shipping)
  • Number of billing cycles

With that information out of the way... For the most flexibility:

Look at creating Billing Agreement IDs through Express Checkout. You will need to get Reference Transactions enabled on your PayPal account (talk to merchant support to get this done).

With a BAID, you control when your customers are charged, how much they are charged, and pretty much anything else having to do with the transaction. The drawback is the same as the benefit.. you (see 'have to') control it all.