This article shows how an integration with Double the Donation Matching may expire when a token expires and how you can restart the integration when this occurs.
What happens to Double the Donation Matching when a token expires?
What can cause an integration token to expire?
How do I restart an integration that was paused because of invalid tokens?
Which integrations could be affected by tokens?
Some integrations with Double the Donation Matching rely on integration tokens from third-party platforms. Sometimes, these tokens expire, resulting in a paused integration with Double the Donation and no more matching gift identification or automation occurring. Consult the following FAQs to learn about tokens and what you can do to restart an integration that was paused because of an invalid token.
What happens to Double the Donation Matching when a token expires?
If your integration token expires, donation data will stop flowing between Double the Donation Matching and any integrated platforms that reply to that integration token. No more donations will flow into the matching module for matching gift processing until a valid token is exchanged for an invalid one. No data that currently exists in Double the Donation Matching will be affected.
What can cause an integration token to expire?
Most often, the cause of an expired or invalid integration token is a user from your nonprofit leaving and their profiles being deleted or reassigned. If the integration token is tied to their account within the partner platform, their integration token will no longer be valid.
That may not always be the case. Some platforms regularly refresh their integration tokens on a schedule or corresponding to a release. In this case, it's the platform that causes the token to expire, not a particular user action.
How do I restart an integration that was paused because of invalid tokens?
The best first step to restarting an integration is to simply turn it off and back on again, following the integration guide for the platform found in this folder.
If the token was refreshed by the platform partner, this simple action should generate a new token and restart your integration without further action. If a member of your team left and their account was deleted, and this led to the invalid token issue, you will need to ensure you are using credentials for a new, valid user when restarting the integration.
If these steps don't work, contact Double the Donation Support at support@doublethedonation.com, and we'll walk you through further troubleshooting steps.
Which integrations could be affected by tokens?
Common integrations based on integration tokens are:
If you receive an automated message from Double the Donation Matching notifying you of a token-related issue, the message might include the name of the platform causing the issue.