Online store checkout: donations with the Charitips API

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.

Who paysYour users
Starts withA purchase
Tax receiptIn the user's name

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

One variant of Round-up on every payment · Retail

The order total rounded up to the next euro

See every variant

Device

Charities shown as

Outline widget

your-store.example/checkout

Step by step

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

1Round-up added
To come
Your customer does…
Clicks “Round my total up to 55,00 €”.
Your server sends…
The customer ticks the round-up at checkout and picks a charity in the widget. Your store keeps both with the order. Nothing is sent to Charitips yet.
Charitips answers…
Nothing: Charitips is not called at this step.
2Order paid
To come
Your customer does…
Clicks “Pay 55,00 €”.
Your server sends…
Creates a 0,60 € donation for order #20817 on the campaign “Checkout round-ups”, 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.
3Order refunded
To come
Your customer does…
Clicks “Simulate a refund of the order”.
Your server sends…
Deletes that donation.
DELETEdelete-donation
Charitips answers…
The donation is deleted and never billed.

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 delete-donation

Webhooksdonation_create

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
Round up at checkout
The customer ticks the round-up at checkout and picks a charity in the widget. Your store keeps both with the order. Nothing is sent to Charitips yet.
The customer picks a charity from your selection. Button: Round my total up to 55,00 €
No call: this screen only shows the result.
02
Order paid with its round-up
The customer pays the order and the round-up in one payment. Your server then records the donation in the customer's name, with the order's billing name and address: the fiscal receipt goes to them, and in France 66 % of the donation comes off their income tax.
- Order total: 54,40 €
- Round-up for the charity: 0,60 €
- Charged to the customer: 55,00 €
Button: Pay 55,00 €
Your server calls:
- POST /v1/donationsCreate a donation: once the order is paid, from your payment webhook; amount in cents; hasBeenCharged puts the receipt in the customer's name, at the order's billing address
Charitips then sends the donation_create webhook to your endpoint.
03
Order refunded
The order is refunded: your server deletes its round-up, as long as it is not billed yet.
Button: Simulate a refund of the order
Your server calls:
- DELETE /v1/donations/{donationId}Delete a donation: donationId kept with the order; only before the monthly bill

Other ways to run it

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

Banking and insuranceBank card paymentsA 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 euroTry the demoRound-up on every payment: Bank card payments
Culture and eventsFestival cashless walletA 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 euroTry the demoRound-up on every payment: Festival cashless wallet
Travel and mobilityMobility walletA 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 euroTry the demoRound-up on every payment: Mobility wallet
Hotels and restaurantsRestaurant self-order kioskA 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 kioskTry the demoRound-up on every payment: Restaurant self-order kiosk

One variant of Round-up on every payment · Retail

How it works

Once, before the first customer

Round up at checkout

Order paid with its round-up

Order refunded

Other ways to run it