mwillmott
commented
9 years ago An overview of the Givey API and how it could work with the above (from @marcqualie – CTO):
- create user I can enable this endpoint for you later today
- create first piece of content (yes this is how fundraisers work) This requires a bit of manual work on the part of each rider currently. A fundraising page is generated after the first donation to a piece of content by a user. Once they’ve made their donation a URL is generated https://www.givey.com/s/:content_url/u/:username where others can go to view their progress (although they’ll probably browse this on your site). The limitation here is that in order to “inspire” someone, i.e. have them donate through your account, is that there needs to be a donation in the system first to start the chain. I understand this may be slightly troublesome to automate but it’s a decision we made a company in order to connect the dots in our system based on donation networking. You can follow the steps below after creating the users and content to email each rider with their own pre=built link in order to donate (£1.05 minimum) and get their page generated. They will need to be logged in with the correct username in order to do so.
- The URL is constructed at this endpoint https://www.givey.com/share with the following params:
- charity_id: giveytag of the charity to preselect (optional, can be modified by the user)
- amount: suggested amount (optional, can be modified by the user)
- url: The url to the piece of content they’re donating to (optional, won’t be linked to the correct content without)
- inspired_by: username of the rider they’re donating because of (optional, won’t be linked to a rider without)
- client_id: your application token (required)
- redirect_to: where you want donors to end up after successful donation
- Get the total amount raised per rider
- Request /donations?user_id={username}&content_id={content_id} will return all donations inspired by a rider to that piece of content. I can addd a field to the meta data containing various information like the sum and counts so you don’t have to iterate over these manually.
marcqualie
pawelsawicz
We need to integrate a donation platform with the Techbikers site to allow our riders to fundraise for any given ride and allow us to track fundraising. The idea of integration is that we want to minimise the amount of form filling and setup on other sites as well as being able to display fundraising info on our site. Last year we used Believe.in but they have since shut down.
We are currently looking at integrating with
Givey (givey.com)Just Giving. There are several key areas i see that we can integrate. We are pressed for time so they don't all need to be done and we should figure out what can be done quickly and what should be done first.Add a field(s) to the rider model so we know if and the details of their fundraising profile on Givey. This is likely to just be the Givey UID.We have added the fundraiser model (see dae95df1014514837e6bba62c569b365e5f03431) which links the user and ride to a fundraising page on JGEither users go and manually create their accounts and we enter their Givey UID into the system so we can link through or we create their accounts through the Givey API. This should be pretty easy._We have replaced the donationpage field in the rider model and now fetch the JG page from the fundraising recordUnlike Virgin Giving, Givey doesn't have the concept of events. You can donate against a bit of content though – i'd suggest we use the ride page url for this so we can track donations against the ride.JG have events so all fundraising pages are created against an event which matches the ride.The last points i'm not sure how much caching and storing of fundraising info on our side we want to do. Let's not pre-emptively optimise though – i'm happy to hammer the API each time for now ;)
The most important thing is getting the riders donation setup so they can start to fundraise.