Skip to main content
If your congregation takes payments through PayPal, you can connect it so those payments arrive in KehillaHQ on their own. No more copying figures across from a PayPal report every month. Go to Settings, then Payments and data sources.

Who can do this

Admin and Financial Admin. Your treasurer can set up their own connection without needing an administrator to do it for them. Board Member can see whether the connection is healthy, but cannot read or change any of its details.

What you will need

Credentials from your congregation’s PayPal business account. These come from PayPal’s own developer settings, and getting them usually means asking whoever administers your PayPal account.
Use your congregation’s PayPal account, not a personal one. Untangling a treasurer’s personal PayPal from congregational records later is genuinely unpleasant.

How your credentials are held

They are encrypted before they are stored, and they are never shown again. Not to you, not to anyone else at your congregation, not in any export or error message. That means if you need to change them, you enter them fresh rather than editing what is there. This is the correct trade-off: credentials that can be read back can be leaked.

Once connected

Payments are collected automatically, several times a day. You do not press anything. Each payment arrives in the To file inbox, because PayPal can tell you that money came in but not whether it was dues or a building fund gift. You say what it was for, and it joins your ledger. If a payer’s email address matches someone in your records, the donor is filled in for you. See The To file inbox.
The Payments and data sources settings page

Filing rules save the repetitive part

If you have separate PayPal buttons for separate purposes, file the first payment from each one and save your choice as a rule. Everything through that button files itself afterwards. For most congregations this turns an ongoing weekly job into a few minutes of setup.

Watch for double-counting

The most common problem after connecting is the same gift recorded twice: once by hand when the treasurer saw it in PayPal, once automatically. Two habits prevent it:
  • Stop entering PayPal payments by hand once the connection is live. Let them arrive.
  • Use ignore for genuine duplicates already in the inbox, rather than deleting them. Ignoring keeps them from coming back on the next sync.

Disconnecting

You can disconnect at any time. New payments stop arriving. Everything already recorded stays exactly where it is, and your history is not affected. Disconnect when your congregation changes PayPal accounts, or when you stop using PayPal.

If the connection stops working

The settings page shows whether the connection is healthy. If it is not, the usual causes are credentials that were changed or revoked in PayPal, or a PayPal account whose permissions changed. Reconnect with fresh credentials. If it still fails, contact support@kehillahq.com.
Payments that arrived while a connection was broken are not lost. Once it is working again, the sync picks up what it missed.