Solidarity items in an in-game shop: donations with the Charitips API
In a game's shop, some items are tied to a charity. When the player buys one with gems earned in play, the studio gives 1 € or 2 € for it; the player never pays.
- Who paysYour company
- Starts withA customer action
- Tax receiptIn your company's name
Needs API access on a validated account. Plans
One variant of Loyalty points turned into donations · Culture and events
1 € or 2 € from the studio for each solidarity item bought
- Mobile games
- Console games
- PC games
- Browser games
- Casual games
- Hybrid-casual games
- Mid-core games
- Hardcore games
- Idle and incremental games
- Puzzle games
- Match-3 games
- Action games
- Adventure games
- Role-playing games (RPGs)
- MMOs
- Strategy and 4X games
- Tower defense games
- Simulation and tycoon games
- Sports games
- Racing games
- Shooters
- Battle royale games
- Survival games
- Sandbox games
- Location-based games
play.your-studio.example
Step by step
Click through the site. Each step shows what your customer does, what your server sends and what Charitips answers.
1Elixir bought, the studio gives to its charity
To comeYour customer does…
Clicks “Buy the elixir”.
Your server sends…
Creates a 1 € donation for purchase #88412 on the campaign “Solidarity items”, for another charity.
POSTcreate-donation
Charitips answers…
Charitips records the donation and returns its id: it goes to another charity at once.
Charitips will then tell your server the donation was created.
2Seed bought, the studio gives to its charity
To comeYour customer does…
Clicks “Buy the seed”.
Your server sends…
Creates a 1 € donation for purchase #88413 on the campaign “Solidarity items”, for another charity.
POSTcreate-donation
Charitips answers…
Charitips records the donation and returns its id: it goes to another charity at once.
Charitips will then tell your server the donation was created.
3Bread bought, the studio gives to its charity
To comeYour customer does…
Clicks “Buy the bread”.
Your server sends…
Creates a 2 € donation for purchase #88414 on the campaign “Solidarity items”, for another charity.
POSTcreate-donation
Charitips answers…
Charitips records the donation and returns its id: it goes to another charity at once.
Charitips will then tell your server the donation was created.
How to read this demo: the site shows what your customer does, and the panel what your server sends and what Charitips answers, step by step.
The site is made up and nothing is sent. The endpoints, fields and webhook events are the real ones, and so are the charities.
How it works
The screens of the demo in order, with the calls your server makes at each one. Its build spec
donation_createOnce, before the first customer
- POST /v1/charities-selectionsCreate a charities selection: once: the charities you offer, from the catalog
- POST /v1/campaignsCreate a campaign: once: the campaign the donations go to
- POST /v1/campaigns/{campaignId}/activateActivate a campaign: once: the campaign starts taking donations
01
Elixir bought, the studio gives to its charity
Button: Buy the elixir
Your server calls:
- POST /v1/donationsCreate a donation: from your server, when it happens; amount in cents
Charitips then sends the
donation_createwebhook to your endpoint.02
Seed bought, the studio gives to its charity
Button: Buy the seed
Your server calls:
- POST /v1/donationsCreate a donation: from your server, when it happens; amount in cents
Charitips then sends the
donation_createwebhook to your endpoint.03
Bread bought, the studio gives to its charity
Button: Buy the bread
Your server calls:
- POST /v1/donationsCreate a donation: from your server, when it happens; amount in cents
Charitips then sends the
donation_createwebhook to your endpoint.
Other ways to run it
The same calls in other sectors and products. Each card opens its own page, with its demo.
- RetailStore loyalty pointsA store lets customers spend loyalty points on a charity at the voucher rate, 100 points for 1 €. The customer picks the charity and the points; the store funds the donation.100 points for 1 €Try the demoLoyalty points turned into donations: Store loyalty points
- RetailUnused gift card balanceWhen a gift card keeps a small balance or is about to expire, the store suggests giving it. The holder picks the charity, the card drops to zero and the store funds the donation.The remaining balance, given by the holderTry the demoLoyalty points turned into donations: Unused gift card balance
- Travel and mobilityTravel loyalty pointsA travel company lets members give expiring loyalty points at the same rate as flights, 100 points for 5 €. The member picks the charity; the company pays, tier progress stays.100 points for 5 €Try the demoLoyalty points turned into donations: Travel loyalty points
- Culture and eventsCultural member cardA museum's membership card lets members give points about to expire, 100 points for 1 €, to an art or heritage charity. The museum pays; the visit count does not change.100 points for 1 €Try the demoLoyalty points turned into donations: Cultural member card
- Software and appsIn-game currencyA game lets players convert in-game gems into a real donation at a fixed rate. The player picks the charity; the studio pays, and level, items and season pass stay untouched.Virtual currency at a fixed rateTry the demoLoyalty points turned into donations: In-game currency
- Professional servicesEmployee solidarity voucherAn employer funds a 60 € solidarity voucher for each employee. In the benefits portal, the employee gives all or part of it to the charity they pick; the rest stays for later.A 60 € voucher funded by the employer, given all or partTry the demoLoyalty points turned into donations: Employee solidarity voucher
