Users give their own money: donations with the Charitips API

An app lets users give their own money: they pick a charity and an amount, then pay the app. The server records the donation after payment; the receipt is in the donor's name.

Who paysYour users
Starts withYour users choose to give
Tax receiptIn the user's name

Needs API access and the B2C use case on a validated account. Plans

One variant of Your users give their own money · Software and apps

A one-off gift, the receipt in the donor's name

See every variant

Device

Charities shown as

Outline widget

your-app.example/donate

Step by step

Click through the site. Each step shows what your customer does, what your server sends and what Charitips answers.

1Donation paid
To come
Your customer does…
Clicks “Give 50 € to the charity”.
Your server sends…
Creates a 50 € donation for payment #9031 on the campaign “Donations”, for the charity your customer picks, paid by Camille Martin with a fiscal receipt in their name.
POSTcreate-donation
Charitips answers…
Charitips records the donation and returns its id: it goes to the charity your customer picks at once, and the fiscal receipt will be in Camille Martin's name.
Charitips will then tell your server the donation was created.
2Receipt issued
To come
Your customer does…
Clicks “Donation processed”.
Your server sends…
Asks for the fiscal receipt of that donation.
POSTcreate-donation-fiscal-receipt
Charitips answers…
Charitips issues the fiscal receipt.
Charitips will then tell your server the fiscal receipt is ready.
3Receipt downloaded
To come
Your customer does…
Clicks “Download the PDF”.
Your server sends…
Reads the fiscal receipt of that donation.
GETget-donation-fiscal-receipt
Asks for a download link to that receipt.
GETgenerate-fiscal-receipt-download-url
Charitips answers…
Charitips returns the receipt and its id.
Charitips returns a download link that expires soon.

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.

Build spec

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

Callscreate-charities-selection create-campaign activate-campaign create-donation create-donation-fiscal-receipt get-donation-fiscal-receipt generate-fiscal-receipt-download-url

Webhooksdonation_createfiscalreceipt_generated

Once, 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, on an account with the B2C use case
- POST /v1/campaigns/{campaignId}/activateActivate a campaign: once: the campaign starts taking donations
01
Give to a cause
The donor picks a charity, then an amount, and pays you. Your server records the donation once your payment succeeds, with the donor's address for the fiscal receipt in their name.
- Your donation: 50,00 €
- Cost after the 66 % tax reduction: 17,00 €
The customer picks a charity from your selection. Button: Give 50 € to the charity
Your server calls:
- POST /v1/donationsCreate a donation: after your payment succeeds; amount in cents, donor address for the receipt
Charitips then sends the donation_create webhook to your endpoint.
02
Thank you
Receipts are yearly by default. For one receipt per donation, your server asks for it once the donation is processed; before that, the API answers 403. The PDF is generated in the background.
Button: Donation processed
Your server calls:
- POST /v1/donations/{donationId}/fiscal-receiptsCreate a donation fiscal receipt: once the donation is processed; skip it to keep the yearly receipt
Charitips then sends the fiscalreceipt_generated webhook to your endpoint.
03
Your fiscal receipt
- Donation: 50,00 €
- Receipt: PDF
Button: Download the PDF
Your server calls:
- GET /v1/donations/{donationId}/fiscal-receiptGet a donation fiscal receipt: returns the fiscalReceiptId of the donation
- GET /v1/fiscal-receipts/{fiscalReceiptId}/download-urlGenerate a fiscal receipt download url: a short-lived link to the PDF; retry if it is not ready yet

Other ways to run it

The same calls in other sectors and products. Each card opens its own page, with its demo.

Professional servicesDonation matchingA user gives 20 € and the company adds 20 €. The user picks the charity, pays and gets the receipt for their part; the company gets its own receipt for the matched part.The user gives 20 €, the company adds 20 €Try the demoYour users give their own money: Donation matching
Banking and insuranceAn extra on a group potOn a group pot, a contributor chips in for the gift and can add a donation in their own name on top. They pick the charity; the receipt is theirs, next to the platform's fee share.A contributor's extra, next to the platform's fee shareTry the demoYour users give their own money: An extra on a group pot
Banking and insuranceSavings interest, matchedA bank proposes to give 10 % of the interest just credited on a savings account, and matches it euro for euro. The customer picks the charity and confirms; two receipts, one each.10 % of the interest, matched by the bankTry the demoYour users give their own money: Savings interest, matched
Software and appsBadge unlocked by a giftA community platform sells a supporter badge for a 2 € donation. The member picks the charity and pays; the badge shows on their profile and the receipt is in their name.2 € to unlock a profile badgeTry the demoYour users give their own money: Badge unlocked by a gift
RetailSecond-hand seller's shareOn a second-hand marketplace, a seller gives 10 % of a sale from their payout, in their own name. A badge shows on their listings and buyers see where the share goes.10 % of a sale, given by the seller in their nameTry the demoYour users give their own money: Second-hand seller's share
RetailPart of a buyback payoutA buyback service offers 182 € for a used smartphone. Before accepting, the seller can give part of the payout to a charity they pick; the receipt is in their name.A platform buys a used smartphone for 182 €, the seller gives part of the payout in their nameTry the demoYour users give their own money: Part of a buyback payout
RetailPart of a clothes buybackA fashion store buys back clothes dropped off in store, 26,40 € for seven pieces. The customer can give part of the buyback to a charity they pick; the receipt is theirs.Clothes dropped off in store, 26,40 € bought back, part of it given in the person's nameTry the demoYour users give their own money: Part of a clothes buyback

One variant of Your users give their own money · Software and apps

How it works

Once, before the first customer

Give to a cause

Thank you

Your fiscal receipt

Other ways to run it