0

I am setting up Recurly for our monthly subscriptions. Due to legal restrictions, we cannot prorate refunds or credits. Its "all or nothing". So all subscriptions start on the 1st of every month and refunds always for the whole month (even if they cancel on the 30th day).

On the flip side, if they want to upgrade (or downgrade) mid-month they have to pay (or get credited) the FULL monthly difference. How can I turn off prorated features in Recurly? Or alternatively how can I specify amounts for credits/billing via the API?

I am developing in PHP using the PHP API and hosted pages for new purchases.

3
  • Should I terminate the old plan with the API and create a new plan in its place? If so how do I specify the amount of the refund for the termination via the API?
    – srt8driver
    Nov 3, 2015 at 4:33
  • 2
    i'm curious what jurisdiction you're in that has these restrictions
    – drewish
    Nov 3, 2015 at 16:18
  • 1
    Its not the jurisdiction its the type of subscription. The product is often packaged with other regulated products. So we are stuck following their rules (30 day refund / 1st of month start). Not every state is 30 day refund, but some are so (above my pay grade) they decided to make it the same for everyone. Requiring the Start date to be the 1st of the month only is (IMHO a lazy) decision because it was easy for those (above my pay grade) to understand and it mirrors the other stuff we often get packaged with. Weird I know, but I just have to write the software.
    – srt8driver
    Nov 5, 2015 at 16:33

1 Answer 1

1

Prorating is done automatically whenever a subscription change is issued with a timeframe of "immediately". This functionality cannot be bypassed, however there may be some workarounds:

So all subscriptions start on the 1st of every month

One question here - must the subscription always start on the 1st of the month or just renew? If it's the former, do you need to wait for the 1st of the month for the subscription to start, or do you want it activated immediately?

  • Starting on the first of the month: pass the starts_at parameter in the API (note, you cannot then note use the hosted pages for signup, since they do not support this parameter)
  • Renewing on the first of the month: After the subscription starts, use the postpone API call to adjust the next renewal date to the 1st.

and refunds always for the whole month (even if they cancel on the 30th day). In this case, you'll always want to issue a FULL refund, or just specify the full subscription price when issuing a refund.

On the flip side, if they want to upgrade (or downgrade) mid-month they have to pay (or get credited) the FULL monthly difference. How can I turn off prorated features in Recurly? Or alternatively how can I specify amounts for credits/billing via the API?

  • If the changes need to take effect immediately you would need to terminate the existing subscription (issue any refunds if you want) and then resubscribe the customer at their new terms. Once again you'd need to use the postpone API call if you wish to align their bill cycle date with the first of the month
  • If the changes can take place at renewal issue a subscription change to occur at renewal. It will wait until the 1st of the month and then bill the full price of the new plan.
1
  • 2
    Thanks. To clarify they can start immediately (technically the 1st of the current month) OR postpone until the 1st of the next month. For simplicity I think I will still use the hosted pages to start, then use the postpone API call to re-align the renewal date to the correct month. Then use terminate (no refund) and open refund to handle any refunds.
    – srt8driver
    Nov 5, 2015 at 16:28

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.