FirstPromoter allows you to automatically track sales, refunds, upgrades and cancellations from Recurly.
This is for FirstPromoter v2, if you are still using v1, please check this article
1. Accessing Recurly Integration
Navigate to your profile located in the upper-right section and select "Settings";
Access the "Integrations" tab;
Scroll down to the "Integrations with third-parties" section;
Select "Setup" under Recurly.
2. Setting API Credentials
Open a new browser tab and log in to your Recurly dashboard;
Navigate to Developers > API credentials;
Click on "Add Private API key";
Provide a descriptive key name like 'FirstPromoter' and check the 'Read-only' checkbox;
Click "Save changes";
Copy the Private API key generated by Recurly;
Paste the copied Private API key into the "Private API key" field in the FirstPromoter Recurly Setup section;
In the "Subdomain" field, enter your Recurly subdomain (found in the URL bar of your Recurly dashboard).
3. Setting Recurly Webhooks
Return to your Recurly dashboard and navigate to Developers > Webhook;
Click on "Configure";
Click on "New Endpoint";
Copy the Webhook Endpoint URL value from the FirstPromoter Recurly Setup form and paste it into the 'Endpoint URL' field on Recurly;
Provide a descriptive name for the endpoint in the "Endpoint Name" field;
Click "Save Changes".
Note: Ensure you've selected "successful payment", "successful refund", "void payment", and "cancelled subscription" events.
4. Completion
Return to FirstPromoter and click "Save". If no error messages occur, you are successfully connected to the Recurly API.
Note: To make changes to the Recurly account or switch between sandbox and production environments, navigate to Settings > Integrations tab - Integrations with third parties > Select Recurly - update, and repeat the steps starting from Step 1.