As part of our ongoing work to ensure the protection of personal data of our users via the API’s we have come to the decision to deprecate one of our API endpoints. The endpoint in question is this one: https://api.justgiving.com/docs/resources/v1/Account/Validate - which allows the user (any user with an existing JustGiving email address) to check to see if their credentials are correct (email and password).
We will be removing use of the API on Friday 4th October 2024. At that point there is a risk your application may throw an error if dependent in any way upon this particular endpoint.
With the depreciation of the Validate endpoint we would suggest 2 scenarios for authenticating or creating a Fundraising page.
- Oauth – we recommend as best practice that all of the sign in procedure takes place on our platform. That enables the details of the user not to be passed or handles by a third Party.
Here is some documentation on oAuth: https://justgiving-developer.zendesk.com/hc/en-us/sections/14252651657745-oAuth
What is oAuth?: https://justgiving-developer.zendesk.com/hc/en-us/articles/14308856128657-What-is-oAuth
What does the oAuth journey look like?: https://justgiving-developer.zendesk.com/hc/en-us/articles/14307612032273-What-does-the-oAuth-journey-look-like
- We know that the oAuth journey can be not suitable in some scenarios. What we would suggest in this instance is using our Unclaimed Page creation.
https://api.justgiving.com/docs/resources/v1/QrCodes/RegisterFundraisingPage
This enables you to create an unclaimed page which the user can then claim via the surfaced link.
When using this page creation, we recommend surfacing the Claim page link at the end of the registration/data collection point as well as Storing the claim page URL. Each user will only be able to claim their page via that specific claim page link, so it’s important that information is stored.
The deprecation date for this endpoint is set for 4th October 2024.
As always, more than happy to jump on a call and work through your application to discuss the various alternatives. If you reach out to Developer@justgiving.com we can schedule a suitable time to do this.