--- title: "The Charitips gift card" description: "What the Charitips gift card is, how your server can offer one through the API by email, Slack or post, what the recipient sees, the card images to show in your product, and what stays in the dashboard." canonical: https://www.charitips.com/docs/overview/gift-card --- # The Charitips gift card > What the Charitips gift card is, how your server can offer one through the API by email, Slack or post, what the recipient sees, the card images to show in your product, and what stays in the dashboard. A Charitips gift card is a donation your company funds, offered to a person who picks the charity. Through the API, one call creates it: your server gives the recipient's email, Slack id or postal address, and Charitips delivers the card, hosts the page where the person chooses, sends the reminders and pays the charity. > **In short** > > - The card is created with [Create a donation](https://www.charitips.com/docs/api-reference/create-donation.md), on a campaign whose `sendingMode` says how Charitips delivers it: `EMAIL`, `SLACK` or `POSTAL`. > - Charitips sends the message with the card, the link or code to choose, and the reminders. Your product makes no other call. > - The recipient picks the charity on a page hosted by Charitips; your server gets a `donation_update` webhook. > - Many printed cards for an event, and the card bought by an individual on charitips.com, stay outside the API. ## What it is The card carries the amount your company gives, a message, a design, and the link or code to choose the charity among the ones your campaign offers. The recipient opens it, picks a charity, and Charitips pays the charity. No donation is lost: one that nobody claims is assigned to a charity when it expires or when the campaign closes. ## Offer one through the API Once, create the campaign with its charities selection and the delivery, then activate it: ```bash curl -X POST https://api.sandbox.charitips.com/v1/campaigns \ -H "Authorization: Bearer $CHARITIPS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Birthday cards", "charitiesSelectionId": "", "sendingMode": "EMAIL" }' ``` Then create one donation per card, with the recipient in `donor` and the day to send it in `sendingDate`: ```bash curl -X POST https://api.sandbox.charitips.com/v1/donations \ -H "Authorization: Bearer $CHARITIPS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "campaignId": "", "amount": 2000, "uniqueExternalId": "birthday_2026_1042", "sendingDate": "2026-06-30T09:00:00Z", "donor": { "firstName": "Camille", "email": "camille.martin@example.com" } }' ``` `amount` is in cents. `uniqueExternalId` is your own id for the card, so a retry never gives twice. Leave `charityId` out: the recipient chooses. - **By email** (`sendingMode` set to `EMAIL`). Charitips emails the recipient the campaign's message, the front of the card with its amount, and the link to choose. `donor.firstName`, `donor.email` and `sendingDate` are required, otherwise the API answers `400`; the email leaves within ten minutes of `sendingDate`. Replies go to the address of the account's user unless the campaign sets another. - **By Slack** (`SLACK`). The message and a button to choose reach the person through the Charitips Slack app installed on your workspace. Pass `donor.firstName`, `donor.slackId` and `sendingDate`. - **By post** (`POSTAL`). Charitips prints the card in a design it validated, with the code to choose, and posts it as a tracked letter to the recipient's address in France. The designs come from [List card designs](https://www.charitips.com/docs/api-reference/list-card-designs.md), each with its `momentSlug`, set once on the campaign. See [By post](https://www.charitips.com/docs/use-cases/delivered-gift.md#or-send-it-by-post) for the address fields, the posting day, the statuses and the price. The details of each delivery, with the errors and the edge cases, are in [A gift sent by email, Slack or post](https://www.charitips.com/docs/use-cases/delivered-gift.md). ## What the recipient sees 1. **The card.** The message in your company's name, with the campaign's logo when it has one, and the amount offered. 2. **The choice.** A link, or the code on a printed card, opens the page hosted by Charitips where the person picks one charity among your campaign's selection. Reminders follow until they do. 3. **The confirmation.** Once chosen, Charitips pays the charity. Your server gets the `donation_update` webhook with the `charityId`; the dashboard shows the donation with the others. Your company funds the donation, so the fiscal receipt is issued to your company, not to the recipient: see [Billing and fiscal receipts](https://www.charitips.com/docs/concepts/billing-and-receipts.md). ## You deliver it yourself When the recipient is already in your product, skip the sending: create the donation without a delivery and show the choice of the charity in your own interface, with the [charity selection widget](https://www.charitips.com/docs/widgets/charity_selection.md) or the [claim call](https://www.charitips.com/docs/api-reference/claim-donation.md). See [A donation with every order](https://www.charitips.com/docs/use-cases/donation-per-order.md). If your product sells gift cards of its own, the remaining balance can become a donation: see [Unused gift card balance](https://www.charitips.com/docs/use-cases/gift-card-balance.md). ## Show the card in your product Add `includeAssets=true` to [Get a donation](https://www.charitips.com/docs/api-reference/get-donation.md) or [List donations](https://www.charitips.com/docs/api-reference/list-donations.md), and each donation comes with the images of its card, in the donation's language: ```json { "donationId": "6f1c2a4e-3b5d-4e8f-9a0b-1c2d3e4f5a6b", "assets": { "donationCard": { "digital": { "front": "", "back": "" }, "print": { "front": "", "back": "" } }, "qrCode": "" } } ``` - `digital`: the card to show on a screen or attach to a message, front and back. - `print`: the card for a printer, with bleed, cut marks and safety margins. Its back holds the QR code to choose, and the donor's name when the donation has a `donor`, so each card finds its owner. - `qrCode`: the QR code alone, which opens the page to choose. _Interactive component ``: open the page in a browser to use it._ To print the cards of a whole campaign at once, ask for a PDF with [Create a file generation request](https://www.charitips.com/docs/api-reference/create-file-generation-request.md), `type` set to `PRINT_PHYSICAL_CARDS_PDF` and the campaign in `params.campaignId`. The file is made in the background: the `file_generated` webhook tells you when it is ready, or check with [Get a file generation request](https://www.charitips.com/docs/api-reference/get-file.md), then download it with [Generate a file download url](https://www.charitips.com/docs/api-reference/generate-file-generation-request-download-url.md). Eight requests per five minutes at most. ```bash curl -X POST https://api.sandbox.charitips.com/v1/files/file-generation-requests \ -H "Authorization: Bearer $CHARITIPS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "type": "PRINT_PHYSICAL_CARDS_PDF", "params": { "campaignId": "" } }' ``` To show what a card looks like before any donation exists, on a product page for example, use its public preview: `https://preview.charitips.com/api/previews/virtual-cards/front/_.png`, with the amount in cents and `fr` or `en`, like `5000_fr.png` for 50 €. ## What stays in the dashboard and on charitips.com - **Many printed cards at once.** Cards with a code to hand out at an event, and orders of many printed cards, are made from the dashboard: such a campaign reads `withGiftCards: true` and a `physicalFormat` when you [get it](https://www.charitips.com/docs/api-reference/get-campaign.md). - **One card bought by an individual.** The gift card of [charitips.com](https://www.charitips.com), bought and offered by a person for a birthday, a wedding or any occasion, is a Charitips product with its own payment and its own page. For a bulk order of printed cards driven by your product, [ask us](https://www.charitips.com/contact). ## Reference [Create a campaign](https://www.charitips.com/docs/api-reference/create-campaign.md), [Create a donation](https://www.charitips.com/docs/api-reference/create-donation.md), [Webhooks](https://www.charitips.com/docs/webhooks/configuration.md).