Skip to main content

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 Impact Portal, navigate to Solutions and scroll down to the Available solutions section. Click on the New API integration button, to create a new integration.

Solutions 2

Setup

  • Name your integration*
  • Set a default currency and default Impact Fund(s)

You can choose from any of our Impact Funds:

  • Climate Transformation Fund,
  • Oceans and Seas Fund,
  • Wildlife Fund,
  • Environmental Justice Fund,
  • Forests and Landscapes Fund and
  • Pollinators Fund.

When done, just click the Create button at the bottom right.

note
  • The name of your integration will be displayed to end users when following up on their donations.

New integration

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.

Integration keys

Secret key

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.

Don't lose the key

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.

Secret key