The Recurly add-on needs to be installed and activated to see the features mentioned in this this documentation.
Create Your Recurly Account:
To start using your Ninja Forms + Recurly extension, you will need to have previously created and activated your Recurly account.
You can start the aforementioned processes by visiting: https://info.recurly.com/signup
Recurly will also prompt for creation of a unique subdomain, which will be needed in linking Recurly to Ninja Forms.
Setup your Plan(s):
In order to integrate your Recurly plugin, you must set up a Plan before attempting to link to Ninja Forms.
For further information regarding Plan setup, please see Recurly’s Plan documentation here: https://docs.recurly.com/docs/plans
Linking Your Recurly Account to Ninja Forms:
Obtain both your unique Private and Public API keys. You can do so by visiting your Recurly Account Dashboard > Developers > API Credentials
Also make note of your created Recurly subdomain.
(Example: https://yourname.recurly.com)
You will then take your API keys (both Public & Private) and input them, along with your Recurly subdomain, into your Ninja Forms install’s settings.
You can reach this be going to your WordPress Dashboard > Forms > Settings > Recurly
Don’t forget to Save Settings!
Setting up your form to accept Recurly payments
Please ensure that your forms have a First Name, Last Name, and Email fields. These fields are required by Recurly for any payment to be accepted.
To add the action to any form, from the Emails & Actions tab click Add New Action and then the Recurly action from inside the Actions Window that opens.
From there you want to edit the Recurly Subscription action by clicking on the correlating gear symbol from the Emails and Actions Section.
Here you will be able to name your action, and you will need to insert your plan code.
Your plan code can be found in your Recurly Dashboard > Configuration > Plans, in the column next to your plan name: labelled Code.
After inserting the plan code into the Plan Code field in Recurly Subscription action, you will then want to apply merge tags, under Basic Actions you will do this for First Name, Last Name, Email.
You can also modify specifics (like Tax Exemption) under the Advanced dropdown.
**Recurly requires your company address be set inside your Recurly account. If you have not, this can be found in your Recurly account dashboard under Configuration > Site Settings > Company Location
After completing and publishing your form, it is recommended that you preview or append the form to a new post and visit the Recurly Test Gateway to acquire test credit card numbers for your demonstration submission.
This allows you to start testing Recurly without setting up any payment gateway details.
From your form test, after submitting the initial information, you should then be prompted with a Finalize Subscription pop up, where you will input you test data, as referenced below:
We also encourage you to visit Recurly’s documentation page for additional troubleshooting, located here: https://docs.recurly.com/docs/