justgiving

JustGiving is one of the most popular peer-to-peer fundraising tools, and is ideal for challenge events, allowing donors to sponsor their friends and family.

With the JustGiving app for Beacon, you can rest assured that all of your data is automatically imported into your Beacon database, structured and stored in the way that's right for you.

Contents


Features

Fundraisers import

When a supporter creates a new fundraising page for you in JustGiving, Beacon will automatically add them as a person in your database.

Donations import

When someone makes a donation in JustGiving, Beacon will automatically add the donation as a payment in Beacon.

If the donor allowed JustGiving to pass their data to your organisation, then the donor will automatically be added as a person in Beacon, allowing you to see the history of all of their payments in your database:

Additionally, Beacon will (optionally) import the fundraiser responsible for each donation, setting them on the fundraiser field on the payment record. Helpfully, this allows you to quickly see how much a person has fundraised for you when viewing their person record:


Events & appeals

When importing donations, Beacon will create events in your database for the JustGiving events that don't already exist in Beacon:

Beacon will also create a campaign in your database for each appeal you have in JustGiving, allowing you to easily keep track of the donations made across each one:


Install guide

Heads up! Installing JustGiving takes a little longer to set up than other Beacon apps. This is because JustGiving requires you to:

  1. Create an "app" in their developer portal

  2. Get your app "upgraded" by the JustGiving data API

  3. Add your details into Beacon

1. Create a JustGiving app

First up, you need to sign up for a JustGiving developer account.

Note: This is different to your regular JustGiving login.

Once you've created an account and verified your email, head to My Account > Applications.

You'll see that JustGiving has created an app already for you:

Screenshot 2020-04-07 at 16.25.28

Woohoo! We're not done yet though.

2. Get your app approved by JustGiving

For this app to be used with Beacon, it needs to have it's "plan" changed by the JustGiving developer team to have access to JustGiving's data API.

Open your app, and then click Review/Change:

This should open a dialog. Then click the JustGiving data API link on the left hand side, and then scroll down and click Request plan change.

Screenshot 2020-04-07 at 16.30.16

After you've requested a "plan change" with JustGiving, the JustGiving developer team will review your request, and should grant you access within a few working days. You'll be notified by email when this happens.

3. Add your details into Beacon

Now you have your approved JustGiving app, you can connect with Beacon! Head over to Apps > Directory and click Install on the JustGiving app.

You'll immediately be prompted to connect with JustGiving:

When connecting, you will need to add your Charity ID (can be found in your regular JustGiving account Settings > Edit Charity Details):

You'll also be asked to provide your "App ID". This is for the developer app you just created, and can be found in your list of JustGiving developer applications:

The email and password fields are the usual details that you use to login to JustGiving with.

Once you've entered all of the details, click Connect. Review the settings and then click Save integration.

Nicely done! JustGiving is now connected to your Beacon account!


Frequently asked questions

Does Beacon import all of my JustGiving data, or just donations that happen in the future?

Our JustGiving app is forward-looking. It only imports donations that are made after the JustGiving app is installed, and only imports fundraisers for fundraising pages that are created after the JustGiving app is installed.

Going forwards we will be building a system to "bulk-import" all of your existing JustGiving data. For now though, you can use our CSV import template to import your existing data.

Why is there a delay in donations being imported into Beacon?

A limitation of JustGiving's data API is that it only makes your donation data available after it has been paid into your bank account. JustGiving typically pay you every week or so, for donations that have recently been made.

Once JustGiving pay you, the donations included in the payment will be imported into Beacon a few minutes later.

We agree, this delay isn't ideal. We've added this feedback to JustGiving's ideas bank. Please add your vote and comments to suggest this to their product team.

How quickly are new fundraisers added to Beacon?

When someone has created a new fundraising page, JustGiving sends their details to Beacon overnight (around 5am!) so you should see any new fundraisers added as People within 24 hours.

How is Gift Aid handled?

At the moment, we assume that any donations marked as "Gift Aid Eligible" in JustGiving have their Gift Aid claimed by JustGiving. These payments will be imported into Beacon marked as "Gift Aid claimed".

How are contact preferences set?

If a donor or fundraiser opts-in to provide their data to you in JustGiving, the data will be available for Beacon to import. We allow you to choose which contact preferences to set for imported donors and fundraisers (depends on your consent statements in JustGiving):

Does Beacon import individual fundraising pages?

Yes! To import fundraising pages and have donations linked to them, make sure you enable 'Import fundraising pages?' and have selected 'Fundraising pages' in the 'Import related information?' dropdown of the donations section of the JustGiving app settings in Beacon.

What happens if I change my JustGiving password?

Note: This is for your regular JustGiving account and not the developer account that you used during the set up process

If you change the password of the JustGiving account associated with your Beacon account then you will need to update these details in Beacon. To do this you will need to disconnect the JustGiving app in Beacon by removing the connected account...

...and then clicking Save integration:

Once, you've got this far you will just reconnect your JustGiving app as normal and all your configuration settings will be restored!

Does Beacon support JustGiving's "custom codes"?

Not yet, but it's something we have in mind for the future. Please let us know more about why this would be useful for you!

Did this answer your question?