--- title: "Users give their own money: donations with the Charitips API" description: "An app lets users give their own money: they pick a charity and an amount, then pay the app." canonical: https://www.charitips.com/docs/use-cases/b2c/own-money --- # 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. - **Use case**: [Your users give their own money](https://www.charitips.com/docs/use-cases/b2c.md) - **Sector**: Software and apps - **Who pays**: Your users, with their own money - **What starts the donation**: Your users choose to give - **Example**: A one-off gift, the receipt in the donor's name - **Calls**: [`POST /v1/charities-selections`](https://www.charitips.com/docs/api-reference/create-charities-selection.md), [`POST /v1/campaigns`](https://www.charitips.com/docs/api-reference/create-campaign.md), [`POST /v1/campaigns/{campaignId}/activate`](https://www.charitips.com/docs/api-reference/activate-campaign.md), [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md), [`POST /v1/donations/{donationId}/fiscal-receipts`](https://www.charitips.com/docs/api-reference/create-donation-fiscal-receipt.md), [`GET /v1/donations/{donationId}/fiscal-receipt`](https://www.charitips.com/docs/api-reference/get-donation-fiscal-receipt.md), [`GET /v1/fiscal-receipts/{fiscalReceiptId}/download-url`](https://www.charitips.com/docs/api-reference/generate-fiscal-receipt-download-url.md) - **Webhooks**: `donation_create`, `fiscalreceipt_generated` Interactive demo on the page. The same flow as a build spec: https://www.charitips.com/docs/demos/collect.md ## How it works The screens of the demo in order, with the calls your server makes at each one. ### Once, before the first customer - [`POST /v1/charities-selections`](https://www.charitips.com/docs/api-reference/create-charities-selection.md) Create a charities selection: once: the charities you offer, from the catalog ```json { "name": "Our charities", "charityIds": [ "" ] } ``` - [`POST /v1/campaigns`](https://www.charitips.com/docs/api-reference/create-campaign.md) Create a campaign: once: the campaign, on an account with the B2C use case ```json { "name": "Donations", "charitiesSelectionId": "" } ``` - [`POST /v1/campaigns/{campaignId}/activate`](https://www.charitips.com/docs/api-reference/activate-campaign.md) Activate a campaign: once: the campaign starts taking donations ### 1. 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/donations`](https://www.charitips.com/docs/api-reference/create-donation.md) Create a donation: after your payment succeeds; amount in cents, donor address for the receipt ```json { "campaignId": "", "amount": 5000, "hasBeenCharged": true, "withFiscalReceipt": true, "charityId": "", "uniqueExternalId": "payment_9031", "donor": { "firstName": "Camille", "lastName": "Martin", "email": "camille.martin@example.com", "street": "12 rue des Lilas", "zip": "75011", "city": "Paris", "country": "FR" } } ``` Charitips then sends the `donation_create` webhook to your endpoint. ### 2. 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-receipts`](https://www.charitips.com/docs/api-reference/create-donation-fiscal-receipt.md) Create 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. ### 3. Your fiscal receipt - Donation: 50,00 € - Receipt: PDF - Button: Download the PDF **Your server calls:** - [`GET /v1/donations/{donationId}/fiscal-receipt`](https://www.charitips.com/docs/api-reference/get-donation-fiscal-receipt.md) Get a donation fiscal receipt: returns the fiscalReceiptId of the donation - [`GET /v1/fiscal-receipts/{fiscalReceiptId}/download-url`](https://www.charitips.com/docs/api-reference/generate-fiscal-receipt-download-url.md) Generate a fiscal receipt download url: a short-lived link to the PDF; retry if it is not ready yet ## Other ways to run it - [Donation matching](https://www.charitips.com/docs/use-cases/donation-matching.md) (Professional services): The user gives 20 €, the company adds 20 € - [An extra on a group pot](https://www.charitips.com/docs/use-cases/b2c/pot-extra.md) (Banking and insurance): A contributor's extra, next to the platform's fee share - [Savings interest, matched](https://www.charitips.com/docs/use-cases/b2c/interest-matched.md) (Banking and insurance): 10 % of the interest, matched by the bank - [Badge unlocked by a gift](https://www.charitips.com/docs/use-cases/b2c/paid-badge.md) (Software and apps): 2 € to unlock a profile badge - [Second-hand seller's share](https://www.charitips.com/docs/use-cases/b2c/seller-share.md) (Retail): 10 % of a sale, given by the seller in their name - [Part of a buyback payout](https://www.charitips.com/docs/use-cases/b2c/device-buyback.md) (Retail): A platform buys a used smartphone for 182 €, the seller gives part of the payout in their name - [Part of a clothes buyback](https://www.charitips.com/docs/use-cases/b2c/clothes-collection.md) (Retail): Clothes dropped off in store, 26,40 € bought back, part of it given in the person's name - [Full guide: edge cases, webhooks, receipts](https://www.charitips.com/docs/use-cases/b2c.md) - [All use cases](https://www.charitips.com/docs/use-cases.md)