Getting Started with the Donations API
Use the Donations API to easily 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 to ensure expedient and secure payouts. Check out our YouTube channel for quick video tutorials.
Let’s see how easy it is to make a donation with Change.
Get your credentials
The Donations API uses basic authentication. Sign up for a Change account to get access to test credentials. Your test keys have the prefix
test, and your production keys have the prefix
Create a donation
To create a donation, send a request with your credentials to the donations/create endpoint. Pop open a terminal, and send the following request. (If you’re signed in to your Change accout, your test credentials will already be filled in)
curl https://api.getchange.io/api/v1/donations \
-u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
-H "Content-Type: application/json" \
Badabing, badaboom! You just made a (test) donation to Watsi, a healthcare nonprofit.
Is it really that easy?
Yes! The Change platform manages the rest of the donation lifecycle. All funds are routed through Our Change Foundation to ensure expedient and secure payouts.
You control the amount of the donation, the nonprofit, and more.
|amount ||Donation amount USD cents. For example, a $5 donation has an amount of 500.|
|nonprofit_id ||ID of the nonprofit the donation is being sent to. Search for nonprofits here. We support most US-based nonprofits!|
|funds_collected ||Indicator for whether you collected payment for the donation.|
For more parameters, see the Donations API reference.
Share your donation
Change does more than make donations easy. We also generate social media content for your users to share. Send a request to our content API, and get back a set of sharing-ready URLs for your customers. This endpoint does not post anything to social media.
curl https://api.getchange.io/api/v1/nonprofits/n_IfEoPCaPqVsFAUI5xl0CBUOx/social_media_content \
-d 'public_key=YOUR_PUBLIC_KEY' \
Get back a list of social-media optimized images that are tailored for your business. Present these images to your users as options for sharing a donation.
🔴 Go live!
When you’re ready to go live, connect your bank account from the Change dashboard, and swap your test credentials for your live credentials. At that point, you’ll be making real-world donations.
To learn more about our donations API, check out the API reference.