🎖️ This article is intended for advanced users.
Installing the Rock RMS Integration is two parts, the backend setup and the front end configuration. We'll guide you through both sections below. 😃
Backend Setup for the Rock RMS Integration
Open a window with your locally installed copy of RockWeb.
In another window, locate the zipped folder you received from Tithe.ly.
Customers receive a zipped folder from Tithe.ly that contains everything they need to get up and running with RockRMS.
❗ Important Note: Please ensure you have received your zipped folder from Tithe.ly before setting up the Rock RMS Integration.
Right click on it and choose 'extract'.
You'll want to extract it in the same location your Rock Web directory is located.
You will have an unzipped folder called 'dist'.
Inside the 'dist' folder, you'll find a .dll file.
Drag that file and drop it into the Bin folder within your locally installed copy of RockWeb.
Please Note: If you already have a copy of that file in there, you'll want to override it.
Open the 'Plugins' directory in both your locally installed copy of RockWeb and in your 'dist' folder.
Drag and drop the contents of the 'dist/Plugins' folder into your 'RockWeb/Plugins' folder.
Please Note: These files (including the .dll file) can all change with each release. So if you're moving to a newer version of the payment gateway, you'll want to replace all the files to ensure you're picking up any changes.
Once the files are dragged over into the RockWeb directory, restart your Rock Server.
📄 More Information: For more details on hosting your own Rock Server check out Rocks documentation - Rock Solid Internal Hosting.
Front End Configuration for the Rock RMS Integration
After restarting your rock server, navigate to your internal rock website to complete the following configuration steps.
Login to your internal Rock website.
Navigate to 'System Settings' inside the 'briefcase' icon.
Click 'Financial Gateways' to configure a new gateway.
Click the '+' button to add a new gateway.
Fill out the necessary information:
We recommend naming the gateway Tithely.
A description is optional.
Make sure active is checked.
For the 'Gateway Type' choose 'Tithely Gateway Stripe v2 API'.
Set 'Batch Schedule' and 'Batch Time Offset' to your preference.
Enter your Tithely Organization ID.
Tithely Support or Engineering should be able to provide this value.
Enter API URL
Enter API Key.
Someone from the Tithely Support can provide this value.
Please Note: The API key is different between QA and production.
Enter Fund ID.
This is the fund on the Tithely side that Rock Transactions will be associated with. There is not currently any fund mapping, so all Rock Transactions will go to this one Tithely Fund.
Enter Location ID. This is the location on the Tithely side that Rock Transactions will be associated with. Similar to funds, there is no location mapping, so all Rock Transactions will go to this one Tithely Location.
Enter Live Mode value.
This should be 'no' for QA and 'yes' for production.
Enter preference for Prompt for Billing Name & Address.
Please Note: These fields are currently ignored.
Click the 'Save' button at the bottom left-hand side.
You have everything you need to start using the Tithely Payment Gateway! 🎉