Change API Documentation

Use the guides and examples below to integrate Change.

Or continue reading to get started.

Getting started with the Donations API

The Donations API lets you make charitable contributions through your platform. The API manages the entire donation lifecycle from initial creation to final deposit. All funds are routed through Our Change Foundation for secure payouts.

1. Get your credentials

The Donations API uses basic authentication. Sign up for a Change account to get access to test credentials. Test keys use the test prefix; production keys use the live prefix.

2. Create a donation

To create a donation, send a request with your credentials to the donations endpoint. From a terminal, send the following request. If you’re signed in to your Change account, your test credentials may already be filled in.

curl https://api.getchange.io/api/v1/donations \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "amount": 500,
        "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
        "funds_collected": false,
      }'

That request creates a test donation to Watsi, a healthcare nonprofit.

How it works

The Change platform handles the rest of the donation lifecycle. All funds are routed through Our Change Foundation for secure payouts. You specify the donation amount, the nonprofit, and other options. For example, some common options include:

Parameter	Description
`amount`	Donation amount in USD cents. For example, $5 is 500.
`nonprofit_id`	ID of the nonprofit receiving the donation. Search for nonprofits here. Most US-based nonprofits are supported.
`funds_collected`	Whether you have already collected payment for the donation.

For more parameters, see the Donations API reference.

3. Go live

When you’re ready to go live, connect your bank account from the Change dashboard and switch from test credentials to live credentials. Then, you’ll be creating real donations.

For full API details, see the API reference.