Getting Started with Change — Ruby Tutorial
Matt Massoodi is a software engineer who loves to design and build distributed applications. When he’s not coding, you can find him boxing, biking and enjoying a beer 🥊 🚴♂️ 🍺
Change is a set of APIs that powers donations directly from your app. At the end of this guide, you will make a test donation to a nonprofit of your choice!
Learn more about the Change Donations API here.
1. Prerequisites
- Register for Change here
2. Get your test API keys
Navigate to the Home page of your Change dashboard
Below, you will see the Let’s get Started section with your test API Keys
3. Choose your favorite nonprofit
Navigate to the Nonprofits page
Search for the nonprofit you’d like to make a test donation to and copy the ID
4. Make your first donation
You can create a donation with your test API keys by passing the nonprofit_id and amount
You should get a response like below
{
"amount":500,
"id":"d_YfJQ94YaoyDsZdz0b4VFsqKe",
"live_mode":false,
"merchant_id":"m_your_merchant_id",
"nonprofit_id":"n_XI19548HjWhTUzRUYwAQoBqt",
"order_value":null,
"zip_code":null,
"external_id":null
}View Test Data in the Change dashboard to see your recent donation
Navigate to the Ledger page and check it out ❤️
As you keep building, you can use the Insights page to track your impact
That’s it! You just made your first test donation to a nonprofit you love. If you want to tinker some more with the Change API, check out the CLI I made!
Happy building 😊
