JustGiving
J
Written by James Gilray
Updated over a week ago

Integration Summary

Product

Method

Pull (Timer)

Frequency

Every 12 Hours

Articles

Demonstration Video

Supported Modes

Logic is required to map Raisely notifications to your Salesforce data. To quickly and easily do so we recommend using one of the supported MoveData Extensions.

Fundraising and Donations

Ticketing and Commerce

Forms

Setup

To set up JustGiving you will need to know your Charity ID and Consumer and Data App IDs.

  • To access your Charity ID, log into your JustGiving Admin and navigate to Settings → Your Charity → Edit charity account details

  • To access your Consumer and Data App IDs, contact JustGiving Support (support@justgivingdeveloper.zendesk.com) requesting access to the Data and Consumer APIs for Production data

You will need to create your JustGiving Integration in MoveData. To do this, open the MoveData app and select the Integrations tab. Click New Integration and select JustGiving from the list of available integrations. Add a Name and click Save.

MoveData JustGiving Configuration Screen

Enter your Charity ID and Data and Consumer App IDs, as well as the username and password you use to access JustGiving. Referring to the JustGiving Configurable Options complete your configuration (if in doubt we recommend using the default options). Click Save to continue.

From this point, MoveData will request new information from JustGiving every 12 hours.

Configurable Options

Priority for Top-Level Campaign

A JustGiving fundraising page links optionally to a Campaign and Event. Often, a fundraiser will create a fundraising page that isn’t linked to an event such as the London Marathon. We have found that Campaigns are often more reliable to be used as the parent campaign for fundraising pages.

Replace JG Charity Events with Top-Level Generic Campaign

(if JG Campaign is missing)

Toggle between using a top level campaign as “JustGiving” or an event / campaign (if present)

Data Migration

Data Migration is available upon request. This is a custom service provided by MoveData and is delivered by MoveData Professional Services.

  • Records will only be imported if available via the JustGiving API

  • The older the records, the more likely the data and associated structures have minor variations and must be accepted as a risk to the success of any import

Additional Field Mappings

Where possible, all fields are mapped to the appropriate schemas. Often there are fields that do not fit explicitly into a schema and these are appended as custom fields. JustGiving Questions are dynamically added to Questions entries within the produced schema objects.

Other Resources

Reference

Below is a list detailing additional Custom fields sent as part of a notification by schema and object.

All Schemas

Accounts

  • No Custom Attributes

Contacts

  • No Custom Attributes

Campaigns

Event

Attribute Name

Description

Example

category

JustGiving Event Category

CharityAppeal

customCode1

Campaign / Event Custom Code 1

customCode2

Campaign / Event Custom Code 2

customCode3

Campaign / Event Custom Code 3

isOverseas

Is Overseas Flag

true

isPromoted

Is Promoted Flag

true

isUserCreated

Is User Created Flag

true

Team

Attribute Name

Description

Example

inMemoriam_dateOfBirth

In Memoriam Date of Birth

1970-01-02T00:00:00Z

inMemoriam_dateOfDeath

In Memoriam Date of Death

2023-06-01T00:00:00Z

inMemoriam_firstName

In Memoriam First Name

Tom

inMemoriam_lastName

In Memoriam Last Name

Smith

inMemoriam_gender

In Memoriam Gender

M

inMemoriam_id

In Memoriam ID

969104

inMemoriam_name

In Memoriam Full Name

Tom Smith

inMemoriam_relationship

In Memoriam Relationship

inMemoriam_town

In Memoriam Town

HOLSWORTHY

appeal

Appeal Name

National Benevolent Fund

birthdayName

Birthday Name

campaignCode1

Campaign Code 1

campaignCode2

Campaign Code 2

campaignCode3

Campaign Code 3

code1

Fundraising Page Code 1

code2

Fundraising Page Code 2

code3

Fundraising Page Code 3

code4

Fundraising Page Code 4

code5

Fundraising Page Code 5

code6

Fundraising Page Code 6

Fundraiser

As above with team, plus:

Attribute Name

Description

Example

category

Event / Page Category

Personal Streaming / Gaming

eventName

Event Name

London Marathon

eventDate

Event Date

2023-06-01T22:48:14Z

eventExpiryDate

Event Expiry Date

2023-06-01T22:48:14Z

eventIsUserCreated

Event Is User Created Flag

true

eventCompletionDate

Event Completion Date

2023-06-01T22:48:14Z

eventCategory

Event Category

12 days of streaming

teamId

JustGiving Team ID

a4227312-11c2-490d-809e-ddae4e734bd4

pageGuid

JustGiving Page GUID

409e9c71-2958-43b1-887a-d131cb0a7cb4

activityType

Page Activity Type

Running_Marathons

apiSource

API Source

page / payment

pageSummary

Page Summary

I am attempting ...

Donation Schema

Recurring Donation

  • No Custom Attributes

Donation

apiSource

API Source

donation / payment / paymentGiftAid

paymentRef

Initial Donation Payment Reference

3076717

totalAmount

Total Amount inc Gift Aid and Transitional Relief

25

paymentDate

Settlement / Payment Date

2023-03-28T00:00:00.000Z

paymentPaymentRef

Reference for Settlement / Payment

3175721

giftaidAmount

Gift Aid Amount

1.25

giftaidFee

Gift Aid Fee

0.06

giftaidPaymentDate

Gift Aid Payment Date

2023-06-01T00:00:00.000Z

giftaidPaymentRef

Gift Aid Payment Reference

2638779

thirdPartyReference

Third Party Reference

whatsapp

Did this answer your question?