Recurly Hosted

This guide explains how to integrate Recurly purchases and subscriptions into LeadDyno. The integration between Recurly and LeadDyno allows automated tracking of lead conversion, cancellation, and affiliate compensation for purchases made via Recurly hosted pages.

In this article

Recurly Hosted Payment Page Settings

The first step to enable the integration is to make sure Recurly Hosted Payment Pages are enabled. Login to your Recurly account, go to Configuration >  Hosted Payment Pages from the left menu, and make sure Enable Hosted Payment Pages is checked. Review the other settings and adjust if necessary.

Recurly Plan Settings

To obtain the Hosted Payment Page URL within Recurly, click on Configuration >  Plans in the left menu and then click on the plan you wish to use. The Plan Code must match the Commission Plan configured in the Commissions section of the LeadDyno Dashboard.

On this page, you will see the  Hosted Page URL. This is the URL your website will link to when customers are ready to make a purchase.

Recurly Webhooks

In order for LeadDyno to receive events about purchases made by your customers, you must configure a Recurly Push Notification to be sent to LeadDyno. This is done in Recurly by going to Integrations > Webhooks.

Click on the Configure button and Configure a new endpoint

And then in the Webhook URL text field, put in the following:

https://collector.leaddyno.com/recurly_push_notification?key=YOUR_PRIVATE_KEY

Replace YOUR_PRIVATE_KEY with your private API key found on LeadDyno Dashboard at Tools > LeadDyno Javascript.

For endpoint enter: LeadDyno.

Leave both the HTTP Auth Username and HTTP Auth Password fields blank.

Click Save Changes and you are done configuring Recurly.

Enable Recurly Integration with LeadDyno

This section assumes the regular LeadDyno visitor tracking is already installed on your website. If not, see our Installation Guide for details, and return here after it is installed.

The integration with Recurly is very simple. All that needs to be done is to add a special parameter to any link to the Recurly hosted payment page at the end of the URL.

Before the modification, the link to the Recurly Hosted Payment page might look like this on your page:

<a href="https://example.recurly.com/subscribe/myplan">Subscribe!</a>

To enable the integration add  /{{leaddyno.visit.id}} at the end of the link URL. For example, the above would become:

<a href="https://example.recurly.com/subscribe/myplan/{{leaddyno.visit.id}}">Subscribe!</a>

The variable  {{leaddyno.visit.id}} will be replaced by the LeadDyno visitor ID and when the Recurly Push Notification is sent to LeadDyno (configured in the previous section), we will match up the visitor with the purchase and perform the appropriate action.

Conclusion

LeadDyno is able to seamlessly integrate with Recurly for transactions that occur on your Hosted Payment Pages. All Recurly transactions are automatically sent to LeadDyno to track conversions, cancellations, and affiliate compensation.

Known Limitations / Issues

N/A

Still need help? Contact Us Contact Us