Set Up

Overview

We’re going to utilize Chariot’s APIs to generate a CID (Connect Identifier) for a nonprofit organization. This CID is a crucial element needed to activate the DAFpay button.

To create a CID to a nonprofit, we first establish the nonprofit’s ID by utilizing their EIN (Employer Identification Number). Following that, we proceed to create a CID(Connect Identifier) with the nonprofit’s ID.

Create Nonprofit

The Create Nonprofit endpoint registers a new nonprofit or confirms its existence within the Chariot system. For registration, it’s necessary to supply the nonprofit’s EIN and details for a contact person at the nonprofit.

Below are a few examples of different implementations. Modify the user object, ein field, and access token from step 1 before making the request.

1
curl --request POST \
2
     --url https://sandboxapi.givechariot.com/v1/nonprofits \
3
     --header 'accept: application/json' \
4
     --header 'authorization: Bearer ACCESS_TOKEN' \
5
     --header 'content-type: application/json' \
6
     --data '
7
{
8
     "user": {
9
          "email": "hansolo@savethestars.com",
10
          "phone": "3051234321",
11
          "firstName": "Han",
12
          "lastName": "Solo"
13
     },
14
     "ein": "123456789"
15
}
16
'

Bravo! You have just created a nonprofit in the Chariot system. Save down the nonprofit’s id and now let’s create a Connect for this nonprofit.

Create Connect

The Create Connect endpoint creates a Connect record or retrieves it if a Connect already exists for this nonprofit in Chariot’s system.

To create a Connect, the nonprofit’s id must be provided, which you should have from the previous step!

Below are a few examples of different implementations. Modify the NONPROFIT_ID query parameter with the nonprofit’s id. Don’t forget to add the access_token!

1
curl --request POST \
2
     --url 'https://sandboxapi.givechariot.com/v1/connects?nonprofit=NONPROFIT_ID' \
3
     --header 'accept: application/json' \
4
     --header 'authorization: Bearer ACCESS_TOKEN' \
5
     --header 'content-type: application/json'

Amazing! You can now start integrating DAFpay to build a front end and start receiving grants for this nonprofit.

Create Launch Plan

For fundraising platforms with multiple nonprofits, the Create Nonprofit and Create Connect need to be called once for each nonprofit on your platform. As part of development, you should determine when and how these calls will be made for each nonprofit.