Automatically apply Recurly coupons, credits, or trial extensions as rewards.

Note: The Recurly integration is only available to users on the LoyaltySurf Business plan or higher.

How to Set Up

You must first select a default currency for your LoyaltySurf campaign in order to use Recurly. Your default currency determines whether Recurly coupons, credits, or trial extensions can be applied to your Recurly subscriptions. For example, if your default currency is USD, then the coupon, credit, or trial extension you set up can only be redeemed for Recurly subscriptions using USD.

Step 1: In Campaign Editor > 3. Options > Integrations, open the Recurly integration card, and enter your Recurly API key and test API key.

Your test API key can be any of your Recurly API keys but we recommend using the API key that you typically use for development and testing.

Step 2: Once connected, press the 'Connect A Reward' button and select your reward.

Step 3: Click on either coupon, credit, or trial extension. If 'Coupon' is selected, enter the details of the coupon, including the name, type, and discount. You can also click Show advanced coupon settings to view more customization settings.

Note: By default, coupons are recommended. However, if you want rewards to be stackable (e.g., $10 off for every loyalty action), you will want to use credits.

If 'Credit' is selected, enter the credit description and amount to apply to the Recurly customer's account every time this reward is unlocked.

If 'Trial extension' is selected, specify the number of days to extend the trial period.

Please note that due to the way that Recurly subscriptions work, the way that LoyaltySurf extends trial periods for existing subscriptions is by creating a new Recurly subscription and applying a free trial coupon to it.

Then select the Recurly plan to which the free trial coupon should be applied.

The Recurly free trial coupon generated by LoyaltySurf must be redeemed when the Recurly customer has a new subscription created. It cannot be utilized for existing subscriptions. If a Recurly plan is not chosen for the application of the free trial coupon, the customer will still receive the coupon. However, it can only be redeemed at a later time. For more information about free trial coupons, click here.

Step 4: Then hit Save. Now, anytime this reward is unlocked by a winning participant, a Recurly coupon, credit, or trial extension will also be applied to the Recurly subscription associated with the LoyaltySurf participant email address.

Step 5 (optional): To ensure the legitimacy of your campaign and prevent any fraudulent activities, it is advisable to establish Recurly webhooks. By setting up webhooks, LoyaltySurf can monitor any modifications customers make to their email addresses on Chargebee using the customer's unique Recurly ID.

Step 6: Toggle the Recurly webhooks switch to enabled within LoyaltySurf, then go to your Recurly dashboard and create a new Recurly webhook by navigating to Integrations > Webhooks. Click on the configure button and select the New Endpoint option to create a new endpoint. Use the webhook URL displayed in the LoyaltySurf Recurly integration as the endpoint URL. Next, generate a username and password for your endpoint, scroll down to the Notification section, and select account.updated. Finally, click the Save Changes button at the bottom of the page. To complete the integration, return to the LoyaltySurf Recurly integration and input the username and password for your Recurly webhook.

Important Note: Only the following notification should be selected for your Recurly webhook:

  • account.updated

Test Mode

Our Recurly integration comes with a test mode that allows you to test coupons/credits and trial extensions based on the test API key that you initially provided. This helps you keep development/testing separate from production. When you toggle Test Mode on, LoyaltySurf will apply coupons/credits and trial extensions using your test API key.

To enable test mode, toggle the Test Mode switch at the bottom-right, then connect a reward.

Please note that the rewards you connect to while Test Mode is enabled are completely separate from those you connect to in live mode.

Important note: When you go live with your campaign, please make sure to switch back to live mode.

Troubleshooting Tips

  • If you have manual reward approval enabled for your campaign: Recurly coupons, credits, and trial extensions will only be issued to the winner(s) after you approve the reward.

  • When testing out the Recurly integration, make sure to view participants' activity logs for details that can help you troubleshoot any issues.

Last updated