Pushpay provides mobile giving solutions and custom mobile apps to over 7,000 churches around the world, including 50 of America’s Top 100 churches. This article will show you how to link your Pushpay account to your One Church Software account.

Benefits

Besides taking advantage of all the great features Pushpay offers, enabling this integration provides the following benefits:

  • Automatic import of all contributions done through the Pushpay website, mobile app, or text giving into One Church in real time. You can view all transactions by clicking on "Contributions > Transactions" from the left hand menu.
  • Automatic import and updates of all recurring giving schedules. Recurring schedules are imported every hour.
  • Easy access to your organization's Pushpay giving page from within the software.
  • Collect payments with Pushpay while completing a custom form.

The following changes will occur in One Church while this integration is enabled:

  • The One Church giving portal and text giving options will be disabled. You would instead use Pushpay for all giving.
  • Transactions entered into One Church are not sent to Pushpay.
  • All recurring giving schedule data will be read only. You will instead have to go to the Pushpay website to make changes.
  • You will no longer be able to charge a credit card when entering a transaction within a batch. You will need to do this within Pushpay instead.
  • You can only have a maximum of one active donation field or item/ticket field on a custom form. You cannot have both field types active on a form at the same time.
  • Payment for any product defined for an item/ticket field can only be credited to a single fund. See the section entitled "Collecting Form Payments" below for more information.
  • When clicking on the "Visit Giving Portal" in the left hand navigation, if your Pushpay account has multiple merchants (e.g. giving pages) defined, the user will be given the option to select which one they want to visit. Otherwise, they will be redirected automatically if your account only has one.

How to Enable Integration

You will need the Financial Settings permission to perform this action. 

Navigate to "Contributions > Settings" from the left hand menu. Then from the "Integrations" tab, locate Pushpay in the list and click on "Enable."

A pop up will appear. If you do not have an account, or have not been given API access from Pushpay yet, click on "Request access from Pushpay." An email will be sent to Pushpay containing everything they need to properly set up this integration. They will be in touch with you concerning your access. If they have already given you a client id and secret then you can skip this step.

Once you have received API access, enter the client id and secret they gave you in the appropriate fields and click the "Authorize" button. You will be asked to sign into your Pushpay account and allow One Church Software access to your account. The pop up will list exactly what you are allowing the system to do. You should sign in using an administrator account.

Important: if you do not see the pop up where you can sign into your Pushpay account, the browser may be blocking pop ups from opening. Make sure you allow pop ups for onechurchsoftware.com.

Once you authorize One Church Software to access your account, the integration will be complete.

Importing Past Contributions

Once the integration is enabled, all contributions moving forward will be automatically imported into the system and matched to the appropriate person's profile (if possible). See this article on how to handle any unmatched contributions that may appear. 

You can also manually import any contributions within a specified date range. We recommend you import any past contributions if you would like to have them in the system as these will not be imported automatically.

To do this, navigate to "Contributions > Transactions" from the left hand menu. Select the arrow next to "Add New" and click on "Import Pushpay Transactions".

A pop up will appear with the following fields:

  • Start Date - the date of the earliest transaction to import
  • End Date - the date of the latest transaction to import

Once you are finished, click on the "Import" button to import all transactions within the specified date range. Remember, One Church Software automatically syncs both systems together so there is no need to do this for future payments.

Collecting Form Payments

You can design custom forms as normal with a few notable differences. This section explains how to set up the system to support form payments with Pushpay as well as some important limitations to keep in mind while this integration is enabled.

Payment Flow

When someone fills out a form and is required to pay for an item, they will be redirected to Pushpay to complete the transaction. 

They will have 10 minutes to complete the transaction before their form submission is marked as expired. Once this happens, the form submission will be removed from the system at the top of the next hour. 

Once complete, they will be redirected back to One Church Software. At this point, all actions that are defined to occur after form submission (e.g. automation, notifications) will happen.

When viewing submissions, an entry which is pending payment will be marked with a "Pay Now" label. An administrator will be able to visit the Pushpay payment page to complete the transaction by either clicking on the label or selecting "Pay Now" from the dropdown menu at the end of the row.

Setting Up Pushpay Anticipated Payments

It is important that the URL they are redirected back to (i.e. the "complete order URL") is whitelisted with Pushpay. Otherwise, they will not be able to submit the form. This only needs to be set up once per Pushpay merchant. To do this, sign into your Pushpay administrator account and click on "Settings > API settings" from the left hand menu and then on "Configure Anticipated Payment Whitelist"

On the next screen, enter the expected URL on a new line in the text box for every merchant you want to use on your forms and then click the "Update" button. We recommend to add it on all merchants.

The URL is in the format:
https://<subdomain>.onechurchsoftware.com/embed/form

You will also find the exact URL to whitelist when editing a donation or item/ticket field on a custom form. See screenshots under the "Donation Field" and "Item/Ticket Field" sections below for an example.

Donation Field

When specifying the funds that a person can donate to for a donation field on a custom form, you will need to first choose one of the merchants from your Pushpay account. Only the funds visible to that merchant can be chosen.

You will need to whitelist your "order complete URL" for this to work. See section named "Setting Up Pushpay Anticipated Payments" above for more information.

Item/Ticket Field

You can define multiple products as normal for the item/ticket field on a custom form. However, you can only choose a single fund. All purchased products will be credited to that fund. As with the donation field, the list of selectable funds is limited to the ones visible to the merchant you choose.

You will need to whitelist your "order complete URL" for this to work. See section named "Setting Up Pushpay Anticipated Payments" above for more information.

Did this answer your question?