Your Knowledge Base is moving on 3/25/24! Our new Help Center provides all the articles you know and love (plus so much more) in a one-stop shop. Ask your SPoC for details!

Tithe.ly

 

Tithe.ly was born mobile first. From text-to-give to their mobile-giving app, everything has been built for the mobile generation. This integration pushes transactions made in Tithe.ly to MP whenever a deposit occurs. The transactions that make up the deposit will be pushed over as a new batch. Tithe.ly's integration is built on a campus-by-campus level which means multiple campuses can have the same integration configured.

Cost

There is no charge from ACS Technologies for configuring the integration.

Fees from Tithe.ly will be assessed as per each church's individual contract agreement.

Initial Setup and Requirements

An account with Tithe.ly must be established before the integration can be configured.

Integration Setup

Pro tip: Best Practice is to create a NEW Company Contact using the Add/Edit Company tool, and then create a NEW User for each Integration. Set up your Giving Provider API Client before configuring this integration. Be sure to grant the new API User Administrative rights!
Step 1: In MP
  1. Go to Administration > API Clients.
  2. Click New.
  3. Enter Tithely for Display Name and Client ID.
  4. Enter a Client Secret. This is the 'password' used by Tithe.ly to access your MinistryPlatform database. We highly recommend using a password generator to have your Client Secret be very unique and secure.
  5. Select the Client User you created for this integration.
    • Note that whatever Client User you choose/create, they must have a Security Role with Administrator rights.
  6. Authentication Flow: Authorization Code, Implicit, Hybrid, Client Credentials, or Resource Owner.
  7. All other settings can remain the same.
  8. Click Save.
Step 2: Setup Integration in Tithe.ly
  1. Once you have the items listed above, login to your Tithe.ly Admin account.
  2. Navigate to My Churches > Edit Organization.
  3. Click the "Integrations" tab.
  4. Select the "Ministry Platform" option from the Integration drop-down list.
  5. Once here, enter your base URL to your Ministry Platform installation.
  6. Then enter your Client ID and Client Secret.
  7. If you would like donations to be passed over as loose transactions, check the checkbox at the bottom labeled "Send Transactions Without A Batch". (If this box is unchecked, a new batch will be created and all transactions within the deposit will be pushed into the batch.)
  8. Finish by clicking "Configure".

Giving Types

Once your integration is configured, you'll need to pull over your active programs as giving types for your donors to make designations for their donations.

  • Click the "Giving Types" tab.
  • Click the "Resync Integration Giving Type" link.
  • Click the "Resync Giving Types" button.
  • Your active programs will be pulled over from MinistryPlatform as new giving types.

Any giving type without an Integration ID should no longer be used for taking donations.

  • Change the status on these to "hidden".
  • For any giving types you would like to show on the donation form, change the status to "active".
  • You can change the names of the giving types if you'd like and/or reorder them as you see fit.
  • To add another giving type, create a new program in MP, then repeat these steps.

Donor Matching

If no match is found, the donation will be matched to "***Default, Contact." The transaction details include all the donation info including the name and email to assist the admin in assigning the donation to the proper donor. The donors can then be assigned/created by going to Tools > Assign Donor.

Support

Support is provided by Tithe.ly at 424-644-3120 or support@tithe.ly.

See Also