How do I implement Gift Plans?

Implementing Gift Plans

Gift Plans are separate plans in Recurly that you can have gifters purchase on a separate gift checkout on your website or in your application. Traditionally, gift plans are setup to not recur, but there are gifting use cases where a gifter may want to pay for an on going subscription, like a parent purchasing a subscription for their child.


Non-Recurring Plans

To create a non-recurring gift plan, create a new plan with "1" billing cycle and set the recurring cycle to the length of the gift. For example, if you want to create 1 Month, 6 Month and 1 Year as your options, you would create three different plans all with 1 billing cycle and varying cycle lengths.


Recurring Plans

To create a recurring gift plan, you can either use your regular plans, or create a separate plan that is set to "Auto renew until canceled". The benefit of having a separate plan in this case is the ability to track when the plan was purchased "as a gift".


Gift Delivery

Unlike Gift Cards, Recurly does not support the collection of gift recipient information or a custom gift message, or email communications with the gift recipient. You will need to collect this information in your gift checkout and setup automated emails in a system external to Recurly.


End of Gift

If the gift plan is non-recurring, it will come to an end after a specific amount of time. The only email Recurly sends at the end of a gift plan is the Subscription Expired email, and this goes to the account's email address. While this email template can be configured to send based on the plan, it is the same template for all plans, so it will be hard to have gift specific messaging in this email if it is being shared with non-gift plans.

Due to the above, we suggest end of gift messaging be handled outside of Recurly using the expired_subscription_notification webhook. If this webhook is received for a gift plan, you can trigger your own end of gift email to upsell the associated gift recipient, or the gifter who's account the gift subscription is on.