Cultural member card: donations with the Charitips API
A 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.
- 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
100 points for 1 €
See every variantmembers.your-museum.example
Step by step
Click through the site. Each step shows what your customer does, what your server sends and what Charitips answers.
1Points converted, at the charity choice
To comeYour customer does…
Clicks “Give 500 points”.
Your server sends…
Creates a 5 € donation for conversion #8812 on the campaign “Your museum”.
POSTcreate-donation
Charitips answers…
Charitips records the donation and returns its id: it waits for your customer to pick a charity.
Charitips will then tell your server the donation was created.
2Charity recorded
To comeYour customer does…
Clicks “Choose the charity”.
Your server sends…
Assigns that donation to the charity your customer picks.
POSTclaim-donation
Charitips answers…
The donation now goes to the charity your customer picks.
Charitips will then tell your server the donation was updated.
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_createdonation_updateOnce, 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
Points converted, at the charity choice
Button: Give 500 points
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
Charity recorded
The customer picks a charity from your selection. Button: Choose the charity
Your server calls:
- POST /v1/donations/{donationId}/claimClaim a donation: donationId from the create-donation response
Charitips then sends the
donation_updatewebhook 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
- 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
- Culture and eventsSolidarity items in an in-game shopIn 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.1 € or 2 € from the studio for each solidarity item boughtTry the demoLoyalty points turned into donations: Solidarity items in an in-game shop
- 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





