Getting Started
Welcome to Pledge’s developer docs!
Pledge’s widgets and APIs allow you to seamlessly integrate global charity search and donation processing into your online platforms. Offer your users the ability to search for their favorite nonprofits around the world by name, location, or cause directly through your site. Allow them to donate in a variety of ways, including the ability to round up their transaction for charity, enter their own donation amount, or have preset donation options to choose from.
API Basics
Section titled “API Basics”Authenticate API requests by passing your API key as a Bearer token in the
Authorization header:
Authorization: Bearer YOUR_API_KEYList endpoints return paginated results. Use the page and per query
parameters to navigate through pages. See the
API reference for details on each endpoint.
Sandbox
Section titled “Sandbox”Pledge’s widgets and APIs can be tested in our sandbox environment. This is a completely isolated environment from production, with different databases, API keys, etc. Expect to see a smaller number of organizations available. Begin by creating an account in the sandbox environment. Once logged in, you can create fundraisers or navigate to the Pledge APIs section. There you can find your API key.
Test Credit Cards
Section titled “Test Credit Cards”When submitting donations in the sandbox, use the test card number 4242 4242 4242 4242 with any future expiration date and any 3-digit CVC.
Where to go next
Section titled “Where to go next”Pledge’s widgets and APIs can be combined in many ways. Here are a few common starting points — explore the full sidebar for everything available.