Monetary donations

Overview

API setup

Hosted setup

Product donations

Overview

API setup

Hosted setup

Additional fields

Discount redemption

Outcome emails

Applications inbox

Organization validation

Overview

Compliance checks

Eligibility review

Agent verification

Testing

Overview

The API setup for monetary donations allows you to build a totally custom donation experience that will live in your product. If you don’t need a custom setup and are limited in engineering resource please have a look at our hosted setup.

With our API only setup, you simply create donations using the Donations API and Percent will keep track of your donations, request payment from you and handle timely disbursement of the donations to the nonprofits.

There are many ways to build donations into your product including one-off donations, round ups and recurring donations. Below we will outline a typical flow for allowing users to make one off donations to the nonprofit of their choice.

1. Get your API keys

Before you start your implementation, you’ll need access to the dashboard to retrieve your Percent API keys.

Go to the Keys page in your Partner dashboard to access your Publishable Key as well as your Secret Key.

Overview

Authenticate your API requests by using these API keys in the request header. The secret key should be used for server to server requests and the publishable key for requests via your front end to any public API services. Header parameter name: Authorization

Please do not publish your private key in repos or use anywhere in front end.

1: Find nonprofit

Guide your users to find their nonprofit through your frontend application. Call the Search Organisations API from your frontend application using your publishable API key and display the results back to your users.

The nonprofit search API can be filtered by:

→ Country using the countryCode parameter

→ Nonprofit name using the query parameter

2: Create donations on behalf of your users

After your user has selected a nonprofit, create a donation using the Donations API, supplying the organisationId of the nonprofit as well as the amount and currency, from your backend application using your secret API key.

POST https://api.poweredbypercent.com/v1/donations
Authorization: Secret Key
Content-Type: application/json

{
	"organisationId": "organisation_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"amount": 1000,
	"currency": "AUD",
	"userId": "user_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

On successful response of creating a Donation, you can update the user that they have successfully donated.

3. Track donations

You can view and retrieve donations either in your dashboard (see image below) or using the Donations API.

You can query for Donations by userId and filter by date. A Donation object tracks the lifecycle of a donation.

For a full reference see Donations API.

On this page

• Overview
• 1. Get your API keys
• Overview
• 1: Find nonprofit
• 2: Create donations on behalf of your users
• 3. Track donations