DOCSEARCHbyAlgolia
Submit Docs

Change Documentation

website·Indexed 34 days ago

https://docs.getchange.io

A charitable giving API that enables businesses to integrate donations into their apps, websites, and stores.

Tokens
562
Snippets
0
Records
5
Agent score
10%

What's inside Change

  1. Manage the donation lifecycle with Change

    Change is a charitable giving API that manages the entire donation lifecycle from creation to final deposit through Our Change Foundation. When creating donations, you can use the following fields for tracking and customization:

    • external_id: A string field used to store your own identifiers, which can be used to filter donations during retrieval.
    • metadata: A JSON object used to store arbitrary additional information associated with a donation.

  2. Switch between Change API Test and Production environments

    Change provides separate environments for development and live transactions. Test keys allow you to simulate donations without moving real money. Production keys process real donations and generate monthly invoices. To go live, swap the test keys for production keys in your configuration.

  3. Integrate Change donations into e-commerce platforms

    Change provides specific integration recipes for common platforms:

    • Stripe: Use webhooks for basic checkout flows or use Stripe Connect to send donations directly to Change.
    • Shopify: Integrate donations into Shopify or Shopify Plus stores.
    • WooCommerce: Reward customers with a donation to a nonprofit of their choice in WordPress/WooCommerce.

  4. Core API resources for charitable giving

    The Change API provides several core resources to manage the giving process:

    • Donations: Create, list (with filtering by external_id, nonprofit_id, and timestamps), and retrieve donation details.
    • Nonprofits: Search the nonprofit network, retrieve specific nonprofit details, and generate social media content for donations.
    • Nonprofit Requests: Submit and track requests to add new nonprofits to the network.
    • Campaigns: Create, retrieve, and update fundraising campaigns, and add donations to specific campaigns.
    • Transfers: Capture Stripe transfers for donation payments.
    • Reports: Fetch impact reports for donation data within specific time ranges.
    • Prebuilt Pages: Generate hosted checkout links to accept donations without custom development.
    • Nonprofit Filing Data & Documents: Manage tax filing information and upload/retrieve documents for nonprofits.

  5. Authenticate with the Change API

    The Change API uses HTTP Basic Auth. Users are provided with four keys: two for testing and two for production. Test keys are prefixed with pk_test_ and sk_test_, while production keys are prefixed with pk_live_ and sk_live_.