Setting up your integration
To create a donation, you can use our donation
REST API. The API allows you to create donations (payment requests) either on behalf of your customers or as corporate donations and then retrieve statistics for the donations made.
This is an overview of how things tie together:
Set up your Donation API
Creating a new integration
Once logged in to the Partner Portal, navigate to Solutions and scroll down to the Available solutions section. Click on the New API integration button, to create a new integration.
- Name your integration*
- Set a default currency and default cause(s)
You can choose from any of our causes:
Oceans and seas,
Forests and landscapes.
When done, just click the
Create button at the bottom right.
- The name of your integration will be displayed to end users when following up on their donations.
Create API keys
After the integration has been created, you have access to your
Integration keys. Here you can generate a secret key to create donations. We generate a public key for you automatically that you can use for making client-side requests to our API.
Create a secret key for your integration by clicking Create Secret Key. You should only use the secret key in your backend requests since it has access to all partner API endpoints. Note that we will only display the secret key once, so if you lose the key, you will need to replace your existing one.
Make sure to store the returned key somewhere safe. You should only use the secret key in your backend requests since it has access to all partner API endpoints.
Note that we will only display the secret key once. If you lose the key, you will need to revoke your existing key and replace it with a new one.