FirstPromoter allows you to automatically track sales, refunds, upgrades and cancellations from Recurly.
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.