---
title: "What you can build"
description: "Every way to put giving in your product, grouped by mechanic, each with live demos in several sectors and the guide to build it."
canonical: https://www.charitips.com/docs/use-cases
---

# What you can build

> Every way to put giving in your product, grouped by mechanic, each with live demos in several sectors and the guide to build it.

Pick a use case by who pays, what starts the donation and your sector, or search for your idea. Each use case is one mechanic: its page switches the demo between the sectors that run the same calls, and lists what else the flow covers.

How to read a demo: the site shows what your customer does, and the panel what your server sends and what Charitips answers, step by step.

## A donation with every order

Above a basket amount, you give and your customer chooses the charity.

- Who pays: Your company
- Starts with: A purchase
- Sector: Retail, Culture and events, Health and sport
- The demo shows: 2 € for every order over 50 €
- Steps: Order paid, Charity chosen, Order history
- Variants, each with its demo and build spec:
  - [Online store](https://www.charitips.com/docs/use-cases/donation-per-order/running-store.md) (Retail): An online store adds 2 € to every order over 50 €, paid by the store. The customer picks the charity on the confirmation page; if they skip it, the donation still goes to one. 2 € for every order over 50 €, or 1 % of each order. Build spec: https://www.charitips.com/docs/demos/checkout.md
  - [Museum shop](https://www.charitips.com/docs/use-cases/donation-per-order/museum-shop.md) (Culture and events): A museum shop gives 2 € on every order over 50 € of prints or books. The shop pays; the visitor picks the charity on the confirmation page or later, from their order history. 2 € for every order over 50 €, or 1 % of each order. Build spec: https://www.charitips.com/docs/demos/checkout/museum-shop.md
  - [Gym accessories shop](https://www.charitips.com/docs/use-cases/donation-per-order/gym-shop.md) (Health and sport): A gym's accessories shop gives 2 € on each order over 50 €, or 1 % of the order. The gym pays, and the member picks the charity once the order is confirmed. 2 € for every order over 50 €, or 1 % of each order. Build spec: https://www.charitips.com/docs/demos/checkout/gym-shop.md
- Other scenarios:
  - A percentage of each order: The amount follows the basket, for example 1 % of every order, instead of a fixed sum. https://www.charitips.com/docs/use-cases/donation-per-order/gym-shop.md
  - The charity picker is a Charitips widget: A widget on your confirmation page lists the charities and records the choice, so you build no picker. https://www.charitips.com/docs/use-cases/donation-per-order.md#show-the-charities
  - The customer chooses by email: A time-limited campaign emails the customer a link to pick the charity after the order. https://www.charitips.com/docs/use-cases/delivered-gift.md#send-the-gift-by-email
  - First order only: Only a customer's first order triggers a donation, as a welcome gift. https://www.charitips.com/docs/use-cases/achievement.md
  - Marketplace sellers pay for it (Who pays: Your business customers (child accounts)): Each seller gets its own account under yours and is billed for the donations on its orders. https://www.charitips.com/docs/use-cases/marketplace-split.md
- 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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: Nothing beyond the basics.
- Page: https://www.charitips.com/docs/use-cases/donation-per-order.md
- Build spec: https://www.charitips.com/docs/demos/checkout.md

## Round-up on every payment

Round each card payment up and give the difference, charged to your customer, who gets the fiscal receipt.

- Who pays: Your users (their own money)
- Starts with: A purchase
- Sector: Banking and insurance, Culture and events, Travel and mobility, Retail, Hotels and restaurants
- The demo shows: Card payments rounded to the next euro, with a multiplier and a monthly cap
- Steps: Round-ups turned on, Payment rounded up, Payment refunded
- Variants, each with its demo and build spec:
  - [Bank card payments](https://www.charitips.com/docs/use-cases/round-up/bank-card.md) (Banking and insurance): A bank rounds each card payment up to the next euro and gives the difference. The customer opts in, sets a multiplier and a monthly cap, pays the round-ups and gets the receipt. Each card payment rounded up to the next euro. Build spec: https://www.charitips.com/docs/demos/round-up.md
  - [Festival cashless wallet](https://www.charitips.com/docs/use-cases/round-up/festival-wallet.md) (Culture and events): A festival's cashless wristband rounds each drink or food payment up to the next euro. The attendee agrees once at top-up, pays the cents and gets the receipt in their name. Each wristband payment rounded up to the next euro. Build spec: https://www.charitips.com/docs/demos/round-up/festival-wallet.md
  - [Mobility wallet](https://www.charitips.com/docs/use-cases/round-up/transit-wallet.md) (Travel and mobility): A mobility app rounds each journey up to the next euro and gives the cents to the charity the rider saved. The rider pays the round-ups; a refunded trip deletes its round-up. Each journey rounded up to the next euro. Build spec: https://www.charitips.com/docs/demos/round-up/transit-wallet.md
  - [Online store checkout](https://www.charitips.com/docs/use-cases/round-up/online-checkout.md) (Retail): An online store offers to round the order total up to the next euro at checkout. The customer ticks the round-up, picks the charity, pays the difference with the order and gets the receipt in their name. The order total rounded up to the next euro. Build spec: https://www.charitips.com/docs/demos/round-up/online-checkout.md
  - [Restaurant self-order kiosk](https://www.charitips.com/docs/use-cases/round-up/self-order-kiosk.md) (Hotels and restaurants): A restaurant's self-order kiosk offers to round the bill up to the next euro before payment. The customer picks the charity and pays the difference with the meal. The bill rounded up to the next euro at the kiosk. Build spec: https://www.charitips.com/docs/demos/round-up/self-order-kiosk.md
- Other scenarios:
  - Round to the next 5 €: The difference to the next 5 € is given instead of the difference to the next euro. https://www.charitips.com/docs/use-cases/round-up.md#create-a-donation-per-transaction
  - Round-up at e-commerce checkout: The customer rounds up the basket at checkout and you give the difference. https://www.charitips.com/docs/use-cases/round-up/online-checkout.md
  - Your company pays the round-up (Who pays: Your company): You fund the round-ups instead, without `hasBeenCharged`: the fiscal receipt goes to your company. https://www.charitips.com/docs/use-cases/round-up.md#billing-and-receipts
  - One donation a month (Starts with: Every period): Round-ups are added up and given once a month, to the charity the customer picked. https://www.charitips.com/docs/use-cases/card-cashback.md
  - Your company matches the round-ups (Who pays: Both: your users and your company): Each round-up the customer pays is matched by your company, at a rate and within a budget set once on the campaign. https://www.charitips.com/docs/use-cases/donation-matching.md#set-the-matching-rate
- 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), [`DELETE /v1/donations/{donationId}`](https://www.charitips.com/docs/api-reference/delete-donation.md)
- Webhooks: `donation_create`
- Needs: The B2C use case: each round-up is created with `hasBeenCharged: true`, once the customer is charged. The customer's name and postal address in `donor`, for the receipt in their name.
- Page: https://www.charitips.com/docs/use-cases/round-up.md
- Build spec: https://www.charitips.com/docs/demos/round-up.md

## A saved choice, a periodic statement

Your customer picks a charity once, in their settings. Each period, you give a share and show it on their statement.

- Who pays: Your company
- Starts with: Every period
- Sector: Software and apps, Banking and insurance, Energy, Education
- The demo shows: 1 % of each plan, every renewal
- Steps: Charity saved, Waiting donations claimed, Invoice paid, Invoice refunded
- Variants, each with its demo and build spec:
  - [Share of a subscription](https://www.charitips.com/docs/use-cases/subscription-share.md) (Software and apps): A SaaS gives 1 % of every plan at each renewal. The workspace admin saves a charity in the billing settings; invoices paid before that choice wait, then get claimed for it. 1 % of each plan, every renewal. Build spec: https://www.charitips.com/docs/demos/subscription.md
  - [Card cashback](https://www.charitips.com/docs/use-cases/card-cashback.md) (Banking and insurance): A bank turns 1 % of a customer's monthly card spending into one donation, at no cost to them. The customer picks the charity from the monthly notification; it is kept for later. 1 % of card spending, each month. Build spec: https://www.charitips.com/docs/demos/cashback.md
  - [Energy saved](https://www.charitips.com/docs/use-cases/periodic-statement/kwh-saved.md) (Energy): An energy supplier compares each bill with the customer's baseline and gives 1 cent per kWh saved. The supplier pays; the customer picks the charity once and sees it on each bill. 0,01 € per kWh saved, on each bill. Build spec: https://www.charitips.com/docs/demos/statement/kwh-saved.md
  - [No-claim year bonus](https://www.charitips.com/docs/use-cases/periodic-statement/no-claim-bonus.md) (Banking and insurance): An insurer gives 5 % of the premium after a year without an at-fault claim, instead of a discount. The policyholder picks the charity on their statement; the premium is unchanged. 10 € after a year with no claim. Build spec: https://www.charitips.com/docs/demos/statement/no-claim-bonus.md
  - [Unused premium given back](https://www.charitips.com/docs/use-cases/periodic-statement/unused-premium.md) (Banking and insurance): An insurer works out, at year end, the premium not spent on claims and gives 5 % of it. The policyholder joins the programme and picks the charity today; the insurer pays. 5 % of the unused premium, at year end. Build spec: https://www.charitips.com/docs/demos/statement/unused-premium.md
  - [Monthly share of a premium](https://www.charitips.com/docs/use-cases/periodic-statement/policy-renewal.md) (Banking and insurance): At renewal, a home insurer promises 1 € of each monthly premium to the charity the policyholder picks. Each payment creates the donation; the insurer pays, the premium stays put. 1 € a month, inside the premium. Build spec: https://www.charitips.com/docs/demos/statement/policy-renewal.md
  - [Share of a card fee](https://www.charitips.com/docs/use-cases/periodic-statement/card-fee-share.md) (Banking and insurance): A bank's premium card gives 10 % of its yearly fee to a charity. The customer picks it when applying for the card; charging the fee creates the donation each year; the bank pays. 10 % of the yearly fee of a premium card. Build spec: https://www.charitips.com/docs/demos/statement/card-fee-share.md
  - [Cashback on purchases](https://www.charitips.com/docs/use-cases/periodic-statement/purchase-cashback.md) (Banking and insurance): A mobile bank gives 1 % of each customer's card purchases every month, paid by the bank. The customer picks the charity once; the month closes with one donation on the statement. 1 % of each purchase, settled monthly. Build spec: https://www.charitips.com/docs/demos/statement/purchase-cashback.md
  - [Premium plan revenue](https://www.charitips.com/docs/use-cases/periodic-statement/premium-plan.md) (Education): An online school gives 5 % of all Premium subscriptions each month to one charity it names for the year. Subscribers see in their account the total given since January. 5 % of the Premium plan revenue, each month. Build spec: https://www.charitips.com/docs/demos/statement/premium-plan.md
  - [Active time converted](https://www.charitips.com/docs/use-cases/periodic-statement/active-time.md) (Software and apps): A community platform converts every 10 active minutes into 1 cent, settled monthly and paid by the platform. The member picks the charity once and watches the month add up. 0,01 € per active period, settled monthly. Build spec: https://www.charitips.com/docs/demos/statement/active-time.md
- Other scenarios:
  - The company picks the charity: Every donation carries the charity you chose, set when you create it. https://www.charitips.com/docs/use-cases/periodic-statement/premium-plan.md
  - A year-end settlement: One donation a year, its amount computed from the year, such as a claim-free bonus. https://www.charitips.com/docs/use-cases/periodic-statement/no-claim-bonus.md
  - A metered amount: The amount follows a meter your app reads: kWh saved, minutes of activity. https://www.charitips.com/docs/use-cases/periodic-statement/kwh-saved.md
  - Your customers pay the share (Who pays: Your users (their own money)): The share is added to their bill, and the fiscal receipt goes to them. https://www.charitips.com/docs/use-cases/b2c.md
  - Insurance: unused premiums: An insurer gives part of the premiums it did not pay out in claims, once a year. https://www.charitips.com/docs/use-cases/periodic-statement/unused-premium.md
  - A share of annual plans: The donation is made once a year, on the annual renewal, instead of every month. https://www.charitips.com/docs/use-cases/subscription-share.md#give-a-share-on-each-renewal
  - An amount per seat: A team plan gives a fixed amount for every active seat. https://www.charitips.com/docs/use-cases/subscription-share.md#give-a-share-on-each-renewal
  - Customers vote instead: The year's share becomes a budget your customers split between charities by voting. https://www.charitips.com/docs/use-cases/vote-on-a-budget.md
  - Billing software for your merchants (Who pays: Your business customers (child accounts)): Each merchant gets a child account and gives a share of its own subscriptions, billed to it. https://www.charitips.com/docs/use-cases/account-hierarchy.md
  - A bonus for moving a salary (Starts with: A customer action): A bank gives a donation when a customer has their income paid into it. https://www.charitips.com/docs/use-cases/achievement.md
  - A share of the average balance: Once a year, a share of each customer's average balance goes to their charity. https://www.charitips.com/docs/use-cases/periodic-statement.md
  - Savings and investment products: A savings account or a fund gives part of its fees or interest to the charity each customer chose. https://www.charitips.com/docs/use-cases/periodic-statement/card-fee-share.md
- 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/{donationId}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md), [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md), [`DELETE /v1/donations/{donationId}`](https://www.charitips.com/docs/api-reference/delete-donation.md), [`GET /v1/donations`](https://www.charitips.com/docs/api-reference/list-donations.md)
- Webhooks: `donation_update`, `donation_create`
- Needs: Nothing beyond the basics.
- Page: https://www.charitips.com/docs/use-cases/periodic-statement.md
- Build spec: https://www.charitips.com/docs/demos/statement.md

## Progress and tiers

A counter, a streak or a gauge reaches a tier: a donation unlocks, the person picks its charity once, and the next tiers follow.

- Who pays: Your company
- Starts with: A customer action
- Sector: Banking and insurance, Health and sport, Education, Software and apps
- The demo shows: 0,10 € per day at 10 000 steps, sent monthly
- Steps: At each 10,000-step day, At the end of the month, When the charity is chosen, At the end of the next month
- Variants, each with its demo and build spec:
  - [10 000 steps a day](https://www.charitips.com/docs/use-cases/progress-and-tiers/daily-steps.md) (Banking and insurance): An insurer's app sets aside 0,10 € each day the member reaches 10 000 steps. On the 1st, the month's total goes out as one donation, paid by the insurer, to the member's charity. 0,10 € per day at 10 000 steps, sent monthly. Build spec: https://www.charitips.com/docs/demos/progress/daily-steps.md
  - [Gym check-ins](https://www.charitips.com/docs/use-cases/progress-and-tiers/gym-check-ins.md) (Health and sport): Every time a member taps their phone at the gym's front desk, the gym adds 0,50 € to a monthly pot. On the 1st, the pot becomes one donation to the charity the member chose. 0,50 € per check-in, sent monthly. Build spec: https://www.charitips.com/docs/demos/progress/gym-check-ins.md
  - [Course modules completed](https://www.charitips.com/docs/use-cases/progress-and-tiers/course-modules.md) (Education): On a training platform, each module passed adds 0,10 € and more to a pot, plus 5 € when the course is complete. The learner picks the charity at the end; the platform pays. 0,10 €, then 0,20 € and up per module, plus 5 € at the end. Build spec: https://www.charitips.com/docs/demos/progress/course-modules.md
  - [E-learning path](https://www.charitips.com/docs/use-cases/progress-and-tiers/learning-path.md) (Education): An e-learning path unlocks 0,20 € from the school at each step finished. The learner picks the charity at the first step; every later step goes to the same one. 0,20 € per step completed. Build spec: https://www.charitips.com/docs/demos/progress/learning-path.md
  - [Onboarding milestones](https://www.charitips.com/docs/use-cases/progress-and-tiers/onboarding-milestones.md) (Software and apps): A SaaS turns its setup checklist into donations: each step completed unlocks 0,20 € to 1 €, paid by the vendor. The new user picks the charity once, at the first milestone. 0,20 € to 1 € per milestone reached. Build spec: https://www.charitips.com/docs/demos/progress/onboarding-milestones.md
  - [Savings tiers](https://www.charitips.com/docs/use-cases/progress-and-tiers/savings-tiers.md) (Banking and insurance): A bank gives 5 € each time a customer's savings pass another 1 000 €. The customer picks the charity on the milestone screen; the money stays in their savings account. 5 € for each 1 000 € saved. Build spec: https://www.charitips.com/docs/demos/progress/savings-tiers.md
  - [Game levels](https://www.charitips.com/docs/use-cases/progress-and-tiers/game-levels.md) (Software and apps): In a game, each level gained adds 0,05 € to the day's pot, paid by the studio. At midnight, the server sends the day's pot as one donation to the charity the player chose. 0,05 € per level, sent daily. Build spec: https://www.charitips.com/docs/demos/progress/game-levels.md
  - [Weekly health goal](https://www.charitips.com/docs/use-cases/progress-and-tiers/weekly-goal.md) (Software and apps): A wellbeing app gives 1 € each week the user completes four sessions. The user picks the charity at the first goal; every week the streak holds goes to the same charity. 1 € per weekly goal met. Build spec: https://www.charitips.com/docs/demos/progress/weekly-goal.md
  - [Follow-up visits on time](https://www.charitips.com/docs/use-cases/progress-and-tiers/follow-up-visits.md) (Health and sport): A health centre gives 1 € for each follow-up visit kept on time, 2 € from the third. The patient checks in on arrival and picks the charity once; later visits keep it. 1 € or 2 € per visit kept on time. Build spec: https://www.charitips.com/docs/demos/progress/follow-up-visits.md
  - [Game milestones for a chosen charity](https://www.charitips.com/docs/use-cases/progress-and-tiers/game-milestones.md) (Software and apps): In any game, the player picks a charity before playing. Each milestone adds 0,25 € from the studio for it; the player sees the real impact and never pays. 0,25 € every 20 levels for the charity picked before playing, paid by the studio. Build spec: https://www.charitips.com/docs/demos/progress/game-milestones.md
- Other scenarios:
  - One donation at the end: The progress adds up on your side, and one donation with the total goes when the course or the challenge ends. https://www.charitips.com/docs/use-cases/progress-and-tiers.md#pay-at-the-end
  - Micro amounts, sent monthly: Cents per step add up in your app, and one donation a month carries the total. https://www.charitips.com/docs/use-cases/progress-and-tiers.md#add-up-micro-amounts-per-period
  - A team goal: An internal challenge: when the team reaches its goal, each member picks a charity for their share. https://www.charitips.com/docs/use-cases/vote-on-a-budget/adoption-goal.md
  - The person pays to unlock (Who pays: Your users (their own money); Starts with: The customer's money): A tier unlocks only with a gift of the person's own money, the receipt in their name. https://www.charitips.com/docs/use-cases/b2c/paid-badge.md
- 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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: Nothing beyond the basics.
- Page: https://www.charitips.com/docs/use-cases/progress-and-tiers.md
- Build spec: https://www.charitips.com/docs/demos/progress.md

## A donation for an achievement

A success in your product, such as a signed lease, a passed exam or a completed survey, gives a donation, and the person picks its charity on the success screen.

- Who pays: Your company
- Starts with: A customer action
- Sector: Software and apps, Professional services, Education, Travel and mobility, Hotels and restaurants, Banking and insurance, Energy, Culture and events
- The demo shows: 10 € when the friend signs up
- Steps: Charity chosen, Friend joined, Friend's charity chosen
- Variants, each with its demo and build spec:
  - [Customer referral](https://www.charitips.com/docs/use-cases/referral.md) (Software and apps): A product gives 10 € when a referred friend signs up. The referrer picks the charity upfront, so every invite names it; the friend's own welcome gift waits for their choice. 10 € when the friend signs up. Build spec: https://www.charitips.com/docs/demos/referral.md
  - [Lease signed online](https://www.charitips.com/docs/use-cases/achievement/lease-signed.md) (Professional services): A rental agency gives 3 € for each lease signed online. On the last step before the keys, the tenant signs and picks the charity on the success screen; the agency pays. 3 € for each lease signed online. Build spec: https://www.charitips.com/docs/demos/achievement/lease-signed.md
  - [Certification passed](https://www.charitips.com/docs/use-cases/achievement/certification.md) (Education): A training provider gives 5 € for each certification passed. When the jury publishes the results, the certified candidate picks the charity on their results page. 5 € for each certification passed. Build spec: https://www.charitips.com/docs/demos/achievement/certification.md
  - [Survey completed](https://www.charitips.com/docs/use-cases/achievement/survey-completed.md) (Software and apps): A SaaS gives 0,50 € for each in-app survey completed. Three questions, two minutes, then the user picks the charity on the thank-you screen; the company pays. 0,50 € for each survey completed. Build spec: https://www.charitips.com/docs/demos/achievement/survey-completed.md
  - [Unused rental kilometres](https://www.charitips.com/docs/use-cases/achievement/unused-kilometres.md) (Travel and mobility): A car rental company gives 5 cents for each kilometre left in the allowance at return. The renter picks the charity on the return screen; the rental company pays. 0,05 € per kilometre not driven. Build spec: https://www.charitips.com/docs/demos/achievement/unused-kilometres.md
  - [Unused buffet portions](https://www.charitips.com/docs/use-cases/achievement/unused-portions.md) (Hotels and restaurants): A caterer counts the portions not served after a seminar and gives 1 € for each. The client approves the buffet report and picks the charity; the caterer pays. 1 € per portion saved, after the event. Build spec: https://www.charitips.com/docs/demos/achievement/unused-portions.md
  - [Insurance deductible settled](https://www.charitips.com/docs/use-cases/achievement/deductible-settled.md) (Banking and insurance): An insurer gives 5 % of the excess when the policyholder pays it to close a claim. The policyholder picks the charity on the claim's closing screen; the insurer pays. 5 % of the deductible, on each settled claim. Build spec: https://www.charitips.com/docs/demos/achievement/deductible-settled.md
  - [Energy contract referral](https://www.charitips.com/docs/use-cases/achievement/energy-referral.md) (Energy): An energy supplier gives 10 € once a referred friend's contract is active, after the cooling-off period. The referrer picks the charity on their referrals page; the supplier pays. 10 € once the referred contract is active. Build spec: https://www.charitips.com/docs/demos/achievement/energy-referral.md
  - [Housekeeping skipped](https://www.charitips.com/docs/use-cases/achievement/skipped-housekeeping.md) (Hotels and restaurants): A hotel gives 1 € for each day a guest skips housekeeping. At check-out the guest sees the total and picks the charity; the hotel pays and nothing appears on the bill. 1 € per day without housekeeping, at check-out. Build spec: https://www.charitips.com/docs/demos/achievement/skipped-housekeeping.md
  - [Shared ride completed](https://www.charitips.com/docs/use-cases/achievement/shared-ride.md) (Travel and mobility): A ride-hailing app gives 0,50 € each time a passenger shares the ride. On arrival, the passenger picks the charity on the receipt screen; the platform pays. 0,50 € per shared ride. Build spec: https://www.charitips.com/docs/demos/achievement/shared-ride.md
  - [New seller's first listing](https://www.charitips.com/docs/use-cases/achievement/seller-activation.md) (Software and apps): A marketplace gives 5 € when a new seller publishes a first listing within a week. The seller picks the charity on the publish confirmation; the marketplace pays. 5 € when a new seller lists within a week. Build spec: https://www.charitips.com/docs/demos/achievement/seller-activation.md
  - [Charity clause in a contract](https://www.charitips.com/docs/use-cases/achievement/contract-clause.md) (Professional services): A law firm adds a charity clause to its contracts: article 14 names the charity, and each signature gives 2 €. The donation is created already assigned; the firm pays. 2 € per contract signed, to the charity the clause names. Build spec: https://www.charitips.com/docs/demos/achievement/contract-clause.md
  - [Festival tickets](https://www.charitips.com/docs/use-cases/achievement/festival-tickets.md) (Culture and events): A festival gives 1 € per ticket sold, paid by the festival. Right after payment, the buyer picks the charity on the order confirmation; the ticket price does not change. 1 € per ticket, chosen after payment. Build spec: https://www.charitips.com/docs/demos/achievement/festival-tickets.md
  - [Property sale completed](https://www.charitips.com/docs/use-cases/achievement/property-sale.md) (Professional services): An estate agency gives 1 % of the sale price at completion, taken from its own fee. The seller picks the charity on the completion page; what they receive does not change. 1 % of the sale price, from the agency's fee. Build spec: https://www.charitips.com/docs/demos/achievement/property-sale.md
  - [Project milestones delivered early](https://www.charitips.com/docs/use-cases/achievement/project-milestones.md) (Software and apps): A project tool gives 10 € each time a team delivers a milestone ahead of its date. The team picks the charity when the milestone closes; the company pays. 10 € per milestone delivered early. Build spec: https://www.charitips.com/docs/demos/achievement/project-milestones.md
  - [Stand-up streak](https://www.charitips.com/docs/use-cases/achievement/standup-streak.md) (Software and apps): A team tool gives 5 € when a team holds 10 daily stand-ups in a row on time. The team picks the charity when the streak milestone is reached; the company pays. 5 € for every 10 stand-ups on time. Build spec: https://www.charitips.com/docs/demos/achievement/standup-streak.md
- Other scenarios:
  - A computed amount: The amount comes from the event: kilometres not driven, portions saved, a share of a deductible. https://www.charitips.com/docs/use-cases/achievement/unused-kilometres.md
  - The company names the charity: The charity is set in advance, in a contract clause for example: the donation is assigned at once. https://www.charitips.com/docs/use-cases/achievement.md#name-the-charity-yourself
  - Charitips emails the person: The person is not signed in to your product: a time-limited campaign emails them the choice. https://www.charitips.com/docs/use-cases/delivered-gift.md#send-the-gift-by-email
  - Charitips emails the referrer: A time-limited campaign sends the referrer a link to pick the charity: you only pass their name and email. https://www.charitips.com/docs/use-cases/referral.md#let-charitips-email-the-referrer
  - Both sides get a donation: The referrer and the new customer each get a donation to give. https://www.charitips.com/docs/use-cases/referral.md#give-the-friend-a-welcome-gift
  - After the first purchase (Starts with: A purchase): The donation waits for the friend's first order instead of the sign-up, so only real customers count. https://www.charitips.com/docs/use-cases/donation-per-order.md
- 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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: For the email variant: a `TIME_BASED` campaign and a `donor`.
- Page: https://www.charitips.com/docs/use-cases/achievement.md
- Build spec: https://www.charitips.com/docs/demos/achievement.md

## A reward validated later

The donation is created when the person submits; your team validates it, with its final amount, once the fact is checked.

- Who pays: Your company
- Starts with: A customer action
- Sector: Software and apps, Professional services, Health and sport, Banking and insurance
- The demo shows: 5 € to 5 000 € by severity, set at validation
- Steps: When the report is sent, When the charity is chosen, When the vulnerability is reviewed
- Variants, each with its demo and build spec:
  - [Bug bounty](https://www.charitips.com/docs/use-cases/validated-reward/bug-bounty.md) (Software and apps): A SaaS pays its bug bounty in donations: 5 € to 5 000 € by severity. The researcher submits a report and picks the charity; the security team sets the amount at validation. 5 € to 5 000 € by severity, set at validation. Build spec: https://www.charitips.com/docs/demos/validation/bug-bounty.md
  - [Employee referral bonus](https://www.charitips.com/docs/use-cases/validated-reward/hiring-referral.md) (Professional services): A company adds 50 € for a charity on top of each employee referral bonus. The employee picks the charity when the hire is made; HR validates after the probation period. 50 € once the hire passes the trial period. Build spec: https://www.charitips.com/docs/demos/validation/hiring-referral.md
  - [Bottles returned by post](https://www.charitips.com/docs/use-cases/validated-reward/bottle-return.md) (Health and sport): A beauty brand gives 0,50 € for each empty bottle sent back with a prepaid label. The customer declares the parcel and picks the charity; the workshop validates each bottle. 0,50 € per bottle received and checked. Build spec: https://www.charitips.com/docs/demos/validation/bottle-return.md
  - [Health goal validated](https://www.charitips.com/docs/use-cases/validated-reward/health-goal.md) (Banking and insurance): A health insurer gives 20 € when a member declares a health goal with proof. The member picks the charity when declaring; the insurer checks the proof and validates the donation. 20 € per goal validated by a doctor. Build spec: https://www.charitips.com/docs/demos/validation/health-goal.md
  - [Appointment kept](https://www.charitips.com/docs/use-cases/validated-reward/appointment-kept.md) (Software and apps): A medical practice gives 0,20 € when a patient confirms a reminder, 50 % more if they arrive on time. The patient picks the charity when confirming; reception validates arrival. 0,20 € per confirmed reminder, +50 % if on time. Build spec: https://www.charitips.com/docs/demos/validation/appointment-kept.md
  - [Real-world mission validated](https://www.charitips.com/docs/use-cases/validated-reward/irl-mission.md) (Professional services): A field missions app turns a mission's 5 € reward into a donation. The worker completes the mission and picks the charity; the ops team validates the report, the app pays. 5 € per mission validated by the ops team. Build spec: https://www.charitips.com/docs/demos/validation/irl-mission.md
- Other scenarios:
  - A fixed amount: The amount is known at the start: validation only confirms the donation. https://www.charitips.com/docs/use-cases/validated-reward.md#validate-once-the-fact-is-checked
  - The amount set at validation: Your team sets the final amount when it validates, from a severity or a count. https://www.charitips.com/docs/use-cases/validated-reward.md#set-the-amount-at-validation
  - A trial period: The donation waits for the end of a trial period or a return window before it is validated. https://www.charitips.com/docs/use-cases/validated-reward/hiring-referral.md
- 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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md), [`POST /v1/donations/{donationId}/validate`](https://www.charitips.com/docs/api-reference/validate-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: A campaign created with `withDonationsValidation`.
- Page: https://www.charitips.com/docs/use-cases/validated-reward.md
- Build spec: https://www.charitips.com/docs/demos/validation.md

## On site, at a kiosk or with a QR code

At a stand, a return point or on a product, a shared screen or a scanned page lets the person pick the charity on the spot.

- Who pays: Your company
- Starts with: A customer action
- Sector: Culture and events, Retail
- The demo shows: 0,50 € per cup returned
- Steps: When the charity is tapped
- Variants, each with its demo and build spec:
  - [Cup returned at a festival](https://www.charitips.com/docs/use-cases/on-site/cup-return.md) (Culture and events): At a festival return point, each cup put on the tray gives 0,50 €, paid by the festival. The attendee taps the charity on the shared screen; the receipt goes to the festival. 0,50 € per cup returned. Build spec: https://www.charitips.com/docs/demos/onsite/cup-return.md
  - [Game at an event stand](https://www.charitips.com/docs/use-cases/on-site/stand-game.md) (Culture and events): A brand's event stand runs a game: a winning slot gives 1 € to 10 €. The visitor picks the charity on the stand's screen, or scans a code to choose later; the brand pays. 1 € to 10 € per win. Build spec: https://www.charitips.com/docs/demos/onsite/stand-game.md
  - [Contact left at a stand](https://www.charitips.com/docs/use-cases/on-site/stand-lead.md) (Culture and events): At a trade show, an exhibitor gives 0,50 € for each visitor who leaves their details. One tap on the stand's tablet sends the contact and the charity choice; the exhibitor pays. 0,50 € per contact. Build spec: https://www.charitips.com/docs/demos/onsite/stand-lead.md
  - [QR code on a product](https://www.charitips.com/docs/use-cases/on-site/product-qr.md) (Retail): A QR code under a product's cap gives 2 % of the price once scanned after purchase. The buyer picks the charity on the scanned page; one donation per code, paid by the brand. 2 % of the price, scanned after purchase. Build spec: https://www.charitips.com/docs/demos/onsite/product-qr.md
  - [Packaging returned in store](https://www.charitips.com/docs/use-cases/on-site/packaging-return.md) (Retail): A shop gives 0,10 € for each packaging item dropped at its collection point. The customer picks the charity once; the shop sends the month's total as one donation. 0,10 € per item returned, settled monthly. Build spec: https://www.charitips.com/docs/demos/onsite/packaging-return.md
  - [Cashless wristband top-ups](https://www.charitips.com/docs/use-cases/on-site/cashless-top-up.md) (Culture and events): A festival gives 0,50 € for each cashless wristband top-up. The attendee picks the charity once at the top-up station; after the last day, the festival sends the total. 0,50 € per top-up, sent after the festival. Build spec: https://www.charitips.com/docs/demos/onsite/cashless-top-up.md
- Other scenarios:
  - A contact collected with the choice: The claim also records the person's contact, on a campaign with lead collection. https://www.charitips.com/docs/use-cases/on-site.md#collect-a-contact-with-the-choice
  - One donation a day: Returns or sales at the till add up, and one donation per day or per month carries them. https://www.charitips.com/docs/use-cases/on-site.md#group-small-amounts-per-day
  - A QR code on a product: The serial number of the product is the donation's unique id: a code scanned twice gives once. https://www.charitips.com/docs/use-cases/on-site/product-qr.md
- 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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: Nothing beyond the basics.
- Page: https://www.charitips.com/docs/use-cases/on-site.md
- Build spec: https://www.charitips.com/docs/demos/onsite.md

## A gift sent by email, Slack or post

Your server creates the donation with the recipient's email or Slack id; Charitips sends the message, and the recipient picks the charity on a hosted page.

- Who pays: Your company
- Starts with: A customer action
- Sector: Education, Software and apps, Professional services, Culture and events, Retail
- The demo shows: 5 € for each graduate, sent on ceremony day
- Steps: At graduation, On the choice, on the Charitips page
- Variants, each with its demo and build spec:
  - [Graduation gift](https://www.charitips.com/docs/use-cases/delivered-gift/graduation-gift.md) (Education): On ceremony day, a school's registry sends each graduate 5 € by email through Charitips. The graduate opens the hosted page and picks the charity; the school pays. 5 € for each graduate, sent on ceremony day. Build spec: https://www.charitips.com/docs/demos/delivered/graduation-gift.md
  - [Secure merge, on Slack](https://www.charitips.com/docs/use-cases/delivered-gift/secure-merge.md) (Software and apps): A dev team gives 5 € for each merge request approved with no critical vulnerability. Charitips messages the author on Slack, who picks the charity from the message. 5 € for each merge request with no critical flaw. Build spec: https://www.charitips.com/docs/demos/delivered/secure-merge.md
  - [Audit report delivered](https://www.charitips.com/docs/use-cases/delivered-gift/audit-report.md) (Professional services): A consulting firm gives 50 € when the client signs off the final audit report. Charitips emails the client, who picks the charity on a hosted page; the firm pays. 50 € when the final report is signed. Build spec: https://www.charitips.com/docs/demos/delivered/audit-report.md
  - [Property estimate sent](https://www.charitips.com/docs/use-cases/delivered-gift/property-estimate.md) (Professional services): An estate agency sends a valuation report and gives the seller 0,1 % of the estimated value. Charitips emails the seller, who picks the charity; the agency pays. 0,1 % of the estimated value. Build spec: https://www.charitips.com/docs/demos/delivered/property-estimate.md
  - [API usage milestone](https://www.charitips.com/docs/use-cases/delivered-gift/usage-milestone.md) (Software and apps): An API platform gives 10 € in a client account's name when its usage passes a milestone. Charitips emails the account owner, who picks the charity; the platform pays. 10 € in the client's name at each milestone. Build spec: https://www.charitips.com/docs/demos/delivered/usage-milestone.md
  - [Upsell signed](https://www.charitips.com/docs/use-cases/delivered-gift/upsell-signed.md) (Software and apps): When a customer signs a seat expansion, the vendor sets aside 5 % of its value as a donation in the customer's name. The signer receives a Charitips email and chooses the charity. 5 % of the upsell, offered to the client. Build spec: https://www.charitips.com/docs/demos/delivered/upsell-signed.md
  - [Gift after an event](https://www.charitips.com/docs/use-cases/delivered-gift/event-goodies.md) (Culture and events): At a trade show, an exhibitor scans a visitor's badge and emails them 1 € to 5 € instead of a goodie. The visitor picks the charity on their phone; the exhibitor pays. 1 € to 5 € per visitor, sent by email. Build spec: https://www.charitips.com/docs/demos/delivered/event-goodies.md
  - [Greeting card with a gift](https://www.charitips.com/docs/use-cases/delivered-gift/card-gift.md) (Retail): A card maker ships business greeting cards that each carry a 5 € gift. The dispatch scan triggers the email; the recipient picks the charity on a hosted page; the sender pays. 5 € in each business card, sent when it ships. Build spec: https://www.charitips.com/docs/demos/delivered/card-gift.md
  - [Client gift as a donation](https://www.charitips.com/docs/use-cases/delivered-gift/corporate-gift.md) (Professional services): A gifting platform offers each client a 50 € present or a donation. When the client picks the donation, Charitips sends them the link to choose the charity; the company pays. A 50 € client gift, turned into a donation. Build spec: https://www.charitips.com/docs/demos/delivered/corporate-gift.md
  - [Greeting card by post](https://www.charitips.com/docs/use-cases/delivered-gift/posted-card.md) (Professional services): A company orders a year-end card for each client: Charitips prints and posts it with a 25 € gift, and the client picks the charity online. The sender pays. A year-end card with a 25 € gift, posted to each client. Build spec: https://www.charitips.com/docs/demos/delivered/posted-card.md
- Other scenarios:
  - By Slack: The donation carries the person's Slack member id: the message arrives in Slack. https://www.charitips.com/docs/use-cases/delivered-gift.md#or-send-it-by-slack
  - By post: The donation carries the person's postal address: Charitips prints the card and posts it. https://www.charitips.com/docs/use-cases/delivered-gift.md#or-send-it-by-post
  - A batch of recipients: One call per recipient, each with its own unique id, for a class or a whole team. https://www.charitips.com/docs/use-cases/delivered-gift/graduation-gift.md
- 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), [`GET /v1/card-designs`](https://www.charitips.com/docs/api-reference/list-card-designs.md), [`POST /v1/donations/{donationId}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: A campaign created with `sendingMode` `EMAIL`, `SLACK` or `POSTAL`, a `donor` on each donation, and a `sendingDate` for email and Slack.
- Page: https://www.charitips.com/docs/use-cases/delivered-gift.md
- Build spec: https://www.charitips.com/docs/demos/delivered.md

## A campaign for a date

A time-limited campaign with its own budget and charities, for a day or a season.

- Who pays: Your company
- Starts with: A purchase
- Sector: Retail, Hotels and restaurants, Software and apps
- The demo shows: Earth Day budget spent on orders
- Steps: Order paid, Charity chosen, Impact page
- Variants, each with its demo and build spec:
  - [A date with a budget](https://www.charitips.com/docs/use-cases/campaign-for-a-date/campaign-for-a-date.md) (Retail): A store runs a one-day campaign with a fixed budget, for example 10 000 € on Earth Day. Each order of the day gives 5 €, billed at activation, until the budget runs out. A fixed budget spent on the orders of Earth Day. Build spec: https://www.charitips.com/docs/demos/moment.md
  - [Flash sale](https://www.charitips.com/docs/use-cases/campaign-for-a-date/flash-sale.md) (Retail): During a two-hour flash sale, a shop gives 5 % of each order into a capped pot. The buyer picks the charity after payment; the shop pays and the price does not change. 5 % of the sales during the slot. Build spec: https://www.charitips.com/docs/demos/moment/flash-sale.md
  - [Happy hour](https://www.charitips.com/docs/use-cases/campaign-for-a-date/happy-hour.md) (Hotels and restaurants): A restaurant's charity happy hour puts 5 % of each order into the evening's pot for a named charity. At 8 pm, the till sends the pot as one donation; the restaurant pays. 5 % of the evening's happy-hour sales. Build spec: https://www.charitips.com/docs/demos/moment/happy-hour.md
  - [In-game charity event](https://www.charitips.com/docs/use-cases/campaign-for-a-date/game-event.md) (Software and apps): A game runs a timed charity event: each challenge cleared adds 0,10 € to a pot for a named charity, up to a set budget. The server sends each hour's pot; the studio pays. 0,10 € per challenge, into a capped pot. Build spec: https://www.charitips.com/docs/demos/moment/game-event.md
- Other scenarios:
  - A give-away every quarter or year (Starts with: Every period): A fixed budget, renewed each period, shared according to your customers' choices. https://www.charitips.com/docs/use-cases/vote-on-a-budget/budget-vote.md
  - A vote for the day (Starts with: A customer action): For a date such as International Women's Day, people vote between charities chosen for it. https://www.charitips.com/docs/use-cases/vote-on-a-budget.md
  - End-of-year redistribution: What is left of a yearly budget goes, in December, to the charities your community picks. https://www.charitips.com/docs/use-cases/vote-on-a-budget/budget-vote.md
- 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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md), [`GET /v1/campaigns/{campaignId}/metrics`](https://www.charitips.com/docs/api-reference/get-campaign-metrics.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: A `TIME_BASED`, `FIXED_AMOUNT` campaign with an end date and a budget, billed when it is activated.
- Page: https://www.charitips.com/docs/use-cases/campaign-for-a-date.md
- Build spec: https://www.charitips.com/docs/demos/moment.md

## Customers vote on a budget

Set a yearly budget and let customers, employees or policyholders decide where it goes.

- Who pays: Your company
- Starts with: A customer action
- Sector: Retail, Culture and events, Software and apps, Education
- The demo shows: Customers split a yearly budget
- Steps: Vote created, Vote cast, Second vote refused
- Variants, each with its demo and build spec:
  - [Customers vote on a budget](https://www.charitips.com/docs/use-cases/vote-on-a-budget/budget-vote.md) (Retail): A retailer sets a yearly budget, 20 000 € for example, and lets customers decide where it goes. Each customer casts one vote on a hosted ballot; the budget is billed at activation. A yearly budget split by the votes. Build spec: https://www.charitips.com/docs/demos/vote.md
  - [Visitors vote at an exhibition](https://www.charitips.com/docs/use-cases/vote-on-a-budget/exhibition-ballot.md) (Culture and events): A museum funds a pot of 1 € per ticket for an exhibition. Each ticket is one vote on a screen at the exit; the pot is split by the votes when the exhibition closes. 1 € per ticket, split by the votes. Build spec: https://www.charitips.com/docs/demos/vote/exhibition-ballot.md
  - [The tournament winner picks](https://www.charitips.com/docs/use-cases/vote-on-a-budget/tournament-winner.md) (Software and apps): An e-sport league puts 2 € per entry into a charity pot. Players sign up and compete; the tournament winner picks the charity the whole pot goes to; the league pays. 2 € per entry, the winner picks the charity. Build spec: https://www.charitips.com/docs/demos/vote/tournament-winner.md
  - [Collective adoption goal](https://www.charitips.com/docs/use-cases/vote-on-a-budget/adoption-goal.md) (Software and apps): A SaaS ties a donation to a feature's adoption: once 500 users have turned it on, it gives 0,50 € per user. Each user picks their own charity. 0,50 € per user, paid once the goal is reached. Build spec: https://www.charitips.com/docs/demos/vote/adoption-goal.md
  - [Poll after a webinar](https://www.charitips.com/docs/use-cases/vote-on-a-budget/webinar-poll.md) (Education): A training company gives 5 % of each webinar ticket. When the live session ends, a poll opens and the attendees choose the charity together; the company pays. 5 % of each ticket, the attendees choose. Build spec: https://www.charitips.com/docs/demos/vote/webinar-poll.md
- Other scenarios:
  - Employees or policyholders vote: The people who vote are your employees or policyholders instead of your customers. https://www.charitips.com/docs/use-cases/vote-on-a-budget.md#create-one-vote-per-person
  - Some votes count more: Votes are weighted, for example by seniority or by how much a customer spent. https://www.charitips.com/docs/use-cases/vote-on-a-budget.md#create-one-vote-per-person
  - A public vote page: Charitips hosts the vote page, so you only share a link. https://www.charitips.com/docs/use-cases/vote-on-a-budget.md#edge-cases
  - A private vote by email: Each voter receives a personal link by email, and nobody else can vote. https://www.charitips.com/docs/use-cases/vote-on-a-budget.md#or-send-each-person-a-voting-link
- 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/votes`](https://www.charitips.com/docs/api-reference/create-vote.md), [`POST /v1/votes/{voteId}/cast`](https://www.charitips.com/docs/api-reference/cast-vote.md), [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md), [`POST /v1/donations/{donationId}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `vote_create`, `vote_update`, `donation_create`, `donation_update`
- Needs: A `DISTRIBUTION`, `FIXED_AMOUNT` campaign with a budget, billed when it is activated.
- Page: https://www.charitips.com/docs/use-cases/vote-on-a-budget.md
- Build spec: https://www.charitips.com/docs/demos/vote.md

## Loyalty points turned into donations

Let customers spend their points on a cause instead of a discount.

- Who pays: Your company
- Starts with: A customer action
- Sector: Retail, Travel and mobility, Culture and events, Software and apps, Professional services
- The demo shows: 100 points for 1 €
- Steps: Points given
- Variants, each with its demo and build spec:
  - [Store loyalty points](https://www.charitips.com/docs/use-cases/loyalty-points/loyalty-points.md) (Retail): A 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 €. Build spec: https://www.charitips.com/docs/demos/loyalty.md
  - [Unused gift card balance](https://www.charitips.com/docs/use-cases/gift-card-balance.md) (Retail): When 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 holder. Build spec: https://www.charitips.com/docs/demos/gift-cards.md
  - [Travel loyalty points](https://www.charitips.com/docs/use-cases/loyalty-points/travel-points.md) (Travel and mobility): A 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 €. Build spec: https://www.charitips.com/docs/demos/loyalty/travel-points.md
  - [Cultural member card](https://www.charitips.com/docs/use-cases/loyalty-points/member-card.md) (Culture and events): 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. 100 points for 1 €. Build spec: https://www.charitips.com/docs/demos/loyalty/member-card.md
  - [In-game currency](https://www.charitips.com/docs/use-cases/loyalty-points/game-currency.md) (Software and apps): A 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 rate. Build spec: https://www.charitips.com/docs/demos/loyalty/game-currency.md
  - [Solidarity items in an in-game shop](https://www.charitips.com/docs/use-cases/loyalty-points/in-game-shop.md) (Culture and events): 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. 1 € or 2 € from the studio for each solidarity item bought. Build spec: https://www.charitips.com/docs/demos/loyalty/in-game-shop.md
  - [Employee solidarity voucher](https://www.charitips.com/docs/use-cases/loyalty-points/solidarity-voucher.md) (Professional services): An 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 part. Build spec: https://www.charitips.com/docs/demos/loyalty/solidarity-voucher.md
- Other scenarios:
  - A reward for a loyalty tier: Members of a tier unlock the donation reward, or a better rate, as a perk. https://www.charitips.com/docs/use-cases/progress-and-tiers.md
  - Expiring points given automatically: Points about to expire become a donation instead of being lost, and the customer is told afterwards. https://www.charitips.com/docs/use-cases/gift-card-balance.md#redistribute-expired-cards
  - Points from a partner program: Points earned with a partner are converted on your side, then given through the same campaign. https://www.charitips.com/docs/use-cases/loyalty-points.md#redeem-the-points
  - Show what the points funded: Each customer sees their donations in their account, listed by your customer id. https://www.charitips.com/docs/use-cases/periodic-statement.md#show-it-on-the-statement
  - A loyalty platform for many brands (Who pays: Your business customers (child accounts)): Each brand you serve gets a child account and pays for the donations of its own members. https://www.charitips.com/docs/use-cases/account-hierarchy.md
  - Expired cards redistributed: Once a month, the value of expired cards goes to charities you choose, without asking anyone. https://www.charitips.com/docs/use-cases/gift-card-balance.md#redistribute-expired-cards
  - A gift card that is a donation: The card itself is a donation: the person who receives it picks the charity on a Charitips page. https://www.charitips.com/docs/use-cases/delivered-gift/card-gift.md
  - The person who receives it tops up (Who pays: Both: your users and your company): After choosing the charity, the beneficiary adds their own money to your donation. https://www.charitips.com/docs/use-cases/donation-matching.md#or-let-them-top-up-your-gift
- 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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: Nothing beyond the basics.
- Page: https://www.charitips.com/docs/use-cases/loyalty-points.md
- Build spec: https://www.charitips.com/docs/demos/loyalty.md

## Your users give their own money

You collect the funds, the fiscal receipt goes to the donor.

- Who pays: Your users (their own money)
- Starts with: The customer's money
- Sector: Software and apps, Professional services, Banking and insurance, Retail
- The demo shows: Users donate their own money, receipt to them
- Steps: Donation paid, Receipt issued, Receipt downloaded
- Variants, each with its demo and build spec:
  - [Users give their own money](https://www.charitips.com/docs/use-cases/b2c/own-money.md) (Software and apps): 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. A one-off gift, the receipt in the donor's name. Build spec: https://www.charitips.com/docs/demos/collect.md
  - [Donation matching](https://www.charitips.com/docs/use-cases/donation-matching.md) (Professional services): A 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 €. Build spec: https://www.charitips.com/docs/demos/matching.md
  - [An extra on a group pot](https://www.charitips.com/docs/use-cases/b2c/pot-extra.md) (Banking and insurance): On 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 share. Build spec: https://www.charitips.com/docs/demos/collect/pot-extra.md
  - [Savings interest, matched](https://www.charitips.com/docs/use-cases/b2c/interest-matched.md) (Banking and insurance): A 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 bank. Build spec: https://www.charitips.com/docs/demos/collect/interest-matched.md
  - [Badge unlocked by a gift](https://www.charitips.com/docs/use-cases/b2c/paid-badge.md) (Software and apps): A 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 badge. Build spec: https://www.charitips.com/docs/demos/collect/paid-badge.md
  - [Second-hand seller's share](https://www.charitips.com/docs/use-cases/b2c/seller-share.md) (Retail): On 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 name. Build spec: https://www.charitips.com/docs/demos/collect/seller-share.md
  - [Part of a buyback payout](https://www.charitips.com/docs/use-cases/b2c/device-buyback.md) (Retail): A 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 name. Build spec: https://www.charitips.com/docs/demos/collect/device-buyback.md
  - [Part of a clothes buyback](https://www.charitips.com/docs/use-cases/b2c/clothes-collection.md) (Retail): A 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 name. Build spec: https://www.charitips.com/docs/demos/collect/clothes-collection.md
- Other scenarios:
  - A widget does everything: A Charitips widget handles the charity choice, the payment and the receipt. https://www.charitips.com/docs/use-cases/b2c.md#show-a-donor-widget
  - A widget for the payment only: You keep your own charity list and use a Charitips widget just to take the payment. https://www.charitips.com/docs/use-cases/b2c.md#show-a-donor-widget
  - Monthly donations by your users (Starts with: Every period): Users give the same amount every month and get one tax receipt a year. https://www.charitips.com/docs/use-cases/recurring-donations.md
  - You add to what they give (Who pays: Both: your users and your company): Your company matches each donation your users make. https://www.charitips.com/docs/use-cases/donation-matching.md
  - A QR code at your event (Starts with: A customer action): People scan a QR code at your stand or venue and give their own money on your donation page, from their phone. https://www.charitips.com/docs/use-cases/on-site.md
  - You give first, they top up (Who pays: Both: your users and your company; Starts with: A customer action): Your company gives a donation, such as a gift card or a donation page, and the person who receives it adds their own money. https://www.charitips.com/docs/use-cases/donation-matching.md#or-let-them-top-up-your-gift
  - Employer matching (Who pays: Both: your users and your company): Employees give their own money, and the employer matches each donation. https://www.charitips.com/docs/use-cases/employee-giving.md
  - Half matching (Who pays: Both: your users and your company): You add 50 cents for every euro given, instead of doubling it. https://www.charitips.com/docs/use-cases/donation-matching.md#set-the-matching-rate
  - A cap per person (Who pays: Both: your users and your company): Matching stops at a limit per donation, per donor and for the whole campaign. https://www.charitips.com/docs/use-cases/donation-matching.md#set-the-matching-rate
  - Monthly gifts, matched (Who pays: Both: your users and your company; Starts with: Every period): Users give the same amount every month: your server charges them, creates each month's donation with hasBeenCharged, and the campaign matches it. https://www.charitips.com/docs/use-cases/donation-matching.md#then-create-the-users-donations
- 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), [`PATCH /v1/campaigns/{campaignId}/donation-matching`](https://www.charitips.com/docs/api-reference/update-donation-matching.md), [`POST /v1/donations/{donationId}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `fiscalreceipt_generated`
- Needs: The B2C use case. The B2C use case (`hasBeenCharged: true`). Each donation claimed for a charity.
- Page: https://www.charitips.com/docs/use-cases/b2c.md
- Build spec: https://www.charitips.com/docs/demos/collect.md

## A sale split between seller and buyer

On a marketplace, a listing marked for charity gives a share paid by the seller and an extra paid by the buyer, each on its own account.

- Who pays: Your business customers (child accounts)
- Starts with: A purchase
- Sector: Retail
- The demo shows: 3 % of the sale, split between seller and buyer
- Steps: When the listing goes live, When the order is paid: the seller's part, When the order is paid: the buyer's extra, When the charity is chosen, The buyer's extra follows the same choice
- Variants, each with its demo and build spec:
  - [Solidarity sale](https://www.charitips.com/docs/use-cases/marketplace-split/shared-sale.md) (Retail): A marketplace seller marks a listing as a charity sale and gives 3 % of the price. The buyer picks the charity after paying and can add an extra; each pays on their own account. 3 % of the sale, split between seller and buyer. Build spec: https://www.charitips.com/docs/demos/marketplace/shared-sale.md
  - [Independent maker's sale](https://www.charitips.com/docs/use-cases/marketplace-split/maker-sale.md) (Retail): An independent maker on a marketplace gives 5 % of a piece's price from their studio. The buyer picks the charity at checkout and can add their own extra, on a separate account. 5 % of the price from the studio, plus the buyer's extra. Build spec: https://www.charitips.com/docs/demos/marketplace/maker-sale.md
  - Why one demo: Two marketplaces show this flow: second-hand clothing and independent makers. Its two payers and the account per seller do not change with the sector.
- Other scenarios:
  - Only the seller gives: No extra for the buyer: one donation per sale, on the seller's account. https://www.charitips.com/docs/use-cases/marketplace-split/maker-sale.md
  - Only the buyer gives (Who pays: Your users (their own money)): The buyer adds an extra at checkout, with their own money and a receipt in their name. https://www.charitips.com/docs/use-cases/b2c.md
  - The marketplace pays (Who pays: Your company): No account per seller: the marketplace funds every donation, as a donation with every order. https://www.charitips.com/docs/use-cases/donation-per-order.md
- 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/accounts/{accountId}/child-accounts`](https://www.charitips.com/docs/api-reference/create-child-account.md), [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md), [`POST /v1/donations/{donationId}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md)
- Webhooks: `donation_create`, `donation_update`
- Needs: Nothing beyond the basics.
- Page: https://www.charitips.com/docs/use-cases/marketplace-split.md
- Build spec: https://www.charitips.com/docs/demos/marketplace.md

## Monthly giving by your users

Give every month on behalf of your users, on a recurring campaign: create, claim, pause or stop each donation from your product.

- Who pays: Your company
- Starts with: Every period
- Sector: Health and sport
- The demo shows: A club gives 5 € a month for each member who turns it on
- Steps: Monthly giving on, Monthly donation made, Giving paused, Giving resumed, Giving stopped
- Variants, each with its demo and build spec:
  - [Monthly giving at a club](https://www.charitips.com/docs/use-cases/recurring-donations/monthly-giving.md) (Health and sport): A sports club gives 5 € a month for each member who turns it on. The member picks the charity once; Charitips gives on the 1st and bills the club; pause or stop at any time. 5 € a month for each member who turns it on. Build spec: https://www.charitips.com/docs/demos/recurring.md
  - Why one demo: The calls are the same whatever the sector: the demo shows one club.
- Other scenarios:
  - Each user sets the amount: Users pick their own monthly amount, still paid by you; change it later with Update a recurring donation. https://www.charitips.com/docs/use-cases/recurring-donations.md#create-a-recurring-donation
  - A perk of a paid plan: Only subscribers of a plan get it: your server stops the recurring donation when the plan ends. https://www.charitips.com/docs/use-cases/recurring-donations.md#stop-giving
  - The user changes charity: Claim the recurring donation again with the new charityId: the next 1st gives to it. https://www.charitips.com/docs/use-cases/recurring-donations.md#claim-it-for-the-chosen-charity
  - Your users pay (Who pays: Your users (their own money)): Users give their own money: your server charges them each month and creates a donation with hasBeenCharged, for a receipt in their name. https://www.charitips.com/docs/use-cases/b2c.md
  - Starts when a user signs up (Starts with: A customer action): Your server creates the recurring donation when a user signs up or upgrades, instead of from a settings page. https://www.charitips.com/docs/use-cases/recurring-donations.md#create-a-recurring-donation
- 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/recurring-donations`](https://www.charitips.com/docs/api-reference/create-recurring-donation.md), [`POST /v1/recurring-donations/{recurringDonationId}/claim`](https://www.charitips.com/docs/api-reference/claim-recurring-donation.md), [`POST /v1/recurring-donations/{recurringDonationId}/pause`](https://www.charitips.com/docs/api-reference/pause-recurring-donation.md), [`POST /v1/recurring-donations/{recurringDonationId}/resume`](https://www.charitips.com/docs/api-reference/resume-recurring-donation.md), [`POST /v1/recurring-donations/{recurringDonationId}/cancel`](https://www.charitips.com/docs/api-reference/cancel-recurring-donation.md)
- Webhooks: `recurringdonation_create`, `donation_create`, `recurringdonation_update`
- Needs: A recurring campaign, created with a `frequency` and without a fixed budget. The user's first name, last name and email on each recurring donation: Charitips emails them every month.
- Page: https://www.charitips.com/docs/use-cases/recurring-donations.md
- Build spec: https://www.charitips.com/docs/demos/recurring.md

## Donations for your business customers

Give each of your business customers its own account, its own giving and its own dashboard, billed to you or to them.

- Who pays: Your business customers (child accounts)
- Starts with: Your platform
- Sector: Software and apps
- The demo shows: A SaaS offers giving to its business customers
- Steps: Giving set up, Campaign live, Colleague thanked, Colleague chose a charity, Dashboard opened
- Variants, each with its demo and build spec:
  - [Giving for business customers](https://www.charitips.com/docs/use-cases/account-hierarchy/business-customers.md) (Software and apps): A SaaS offers giving to its business customers: each gets its own Charitips account, campaign and dashboard, created and billed by the SaaS or by them. Each business customer runs its own campaigns. Build spec: https://www.charitips.com/docs/demos/account-hierarchy.md
  - Why one demo: Account hierarchy runs any family above on each business customer's own account: pick the family for what your customers do, and this page for the accounts.
- Other scenarios:
  - Any use case, per business customer: Each child account runs its own campaigns: per order, round-up, loyalty, votes, matching or monthly giving. https://www.charitips.com/docs/use-cases/account-hierarchy/business-customers.md
  - Direct or delegated billing (Who pays: Your company): You pay for all your customers' donations, or each customer is invoiced directly. https://www.charitips.com/docs/guides/account-hierarchy-billing.md
  - A dashboard for each customer: Each business customer follows its giving in its own dashboard, opened with a magic link. https://www.charitips.com/docs/concepts/account-hierarchy.md#dashboards-and-users
  - Employee giving for your customers (Who pays: Your users (their own money); Starts with: The customer's money): Your business customers' employees give from their pay or give days off, in Charitips widgets embedded in your HR or payroll software, after a call with our team. https://www.charitips.com/docs/use-cases/employee-giving.md
  - Thank-you donations to colleagues (Who pays: Your company; Starts with: A customer action): Your company sends an employee or a partner a donation to give: on a time-limited EMAIL campaign, Charitips emails the link and they pick the charity. https://www.charitips.com/docs/use-cases/delivered-gift.md#send-the-gift-by-email
- Calls: [`POST /v1/accounts/{accountId}/child-accounts`](https://www.charitips.com/docs/api-reference/create-child-account.md), [`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/accounts/{accountId}/billing-link`](https://www.charitips.com/docs/api-reference/create-shareable-billing-link.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}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md), [`GET /v1/users`](https://www.charitips.com/docs/api-reference/list-users.md), [`POST /v1/authentication/magic-links/users/{userId}`](https://www.charitips.com/docs/api-reference/create-user-magic-link.md)
- Webhooks: `campaign_create`, `campaign_update`, `donation_create`, `donation_update`
- Needs: The account hierarchy feature.
- Page: https://www.charitips.com/docs/use-cases/account-hierarchy.md
- Build spec: https://www.charitips.com/docs/demos/account-hierarchy.md

## Widget or your own UI

In every demo, the charity choice is the Charitips [charity selection widget](https://www.charitips.com/docs/widgets/charity_selection.md): the charity cards, their profiles and, when a gift is funded for the person, the thank-you card with sharing, matching and newsletter. What surrounds it, such as the order confirmation, the button that confirms the choice and the card that follows, is the site's own interface, built with the API. You can use the widget whole, keep only some of its parts, or draw the whole choice yourself: [List charities](https://www.charitips.com/docs/api-reference/list-charities.md) gives the charities to show, and [Claim a donation](https://www.charitips.com/docs/api-reference/claim-donation.md) records the one picked. Turn on "Show what is the widget" above a demo to see where one ends and the other begins.

## Not in the list?

Every flow combines the same pieces: a campaign, donations, and a charity chosen by someone. Describe your case to your coding agent with [the Charitips skill](https://www.charitips.com/docs/get-started/coding-agent.md), check the words in the [glossary](https://www.charitips.com/docs/overview/glossary.md), or [contact us](https://www.charitips.com/contact).

## What every flow needs

- A validated Charitips account.
- An active subscription, to activate a campaign.
- A payment method, in production.

Some flows need more, such as paying with your users' own money or accounts for your business customers: [Plans and prerequisites](https://www.charitips.com/docs/overview/plans.md) lists them.