---
title: "Store loyalty points: donations with the Charitips API"
description: "A store lets customers spend loyalty points on a charity at the voucher rate, 100 points for 1 €."
canonical: https://www.charitips.com/docs/use-cases/loyalty-points/loyalty-points
---

# Store loyalty points: donations with the Charitips API

> 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.

- **Use case**: [Loyalty points turned into donations](https://www.charitips.com/docs/use-cases/loyalty-points.md)
- **Sector**: Retail
- **Who pays**: Your company
- **What starts the donation**: A customer action
- **Example**: 100 points for 1 €
- **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)
- **Webhooks**: `donation_create`

Interactive demo on the page. The same flow as a build spec: https://www.charitips.com/docs/demos/loyalty.md

## How it works

The screens of the demo in order, with the calls your server makes at each one.

### Once, before the first customer

- [`POST /v1/charities-selections`](https://www.charitips.com/docs/api-reference/create-charities-selection.md) Create a charities selection: once: the charities you offer, from the catalog

  ```json
  {
    "name": "Rewards charities",
    "charityIds": [
      "<charityId>"
    ]
  }
  ```
- [`POST /v1/campaigns`](https://www.charitips.com/docs/api-reference/create-campaign.md) Create a campaign: once: the campaign the donations go to

  ```json
  {
    "name": "Points for charities",
    "charitiesSelectionId": "<charitiesSelectionId>"
  }
  ```
- [`POST /v1/campaigns/{campaignId}/activate`](https://www.charitips.com/docs/api-reference/activate-campaign.md) Activate a campaign: once: the campaign starts taking donations

### 1. Give your points to a charity

The customer picks the charity, then the points, and confirms once. One call records the donation, already assigned. Your store funds it at the voucher rate and gets the fiscal receipt.

- Your points: 1 240
- 100 points: 1,00 €
- **500 points as a donation: 5,00 €**
- The customer picks a charity from your selection.
- Button: Give 500 points to the charity

**Your server calls:**

- [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md) Create a donation: once the customer confirms, with the chosen charity: the donation is assigned at once; amount in cents; then your app takes the points off

  ```json
  {
    "campaignId": "<campaignId>",
    "amount": 500,
    "charityId": "<charityId>",
    "uniqueExternalId": "redemption_3318",
    "externalId": "customer_204"
  }
  ```

Charitips then sends the `donation_create` webhook to your endpoint.

## Other ways to run it

- [Unused gift card balance](https://www.charitips.com/docs/use-cases/gift-card-balance.md) (Retail): The remaining balance, given by the holder
- [Travel loyalty points](https://www.charitips.com/docs/use-cases/loyalty-points/travel-points.md) (Travel and mobility): 100 points for 5 €
- [Cultural member card](https://www.charitips.com/docs/use-cases/loyalty-points/member-card.md) (Culture and events): 100 points for 1 €
- [In-game currency](https://www.charitips.com/docs/use-cases/loyalty-points/game-currency.md) (Software and apps): Virtual currency at a fixed rate
- [Solidarity items in an in-game shop](https://www.charitips.com/docs/use-cases/loyalty-points/in-game-shop.md) (Culture and events): 1 € or 2 € from the studio for each solidarity item bought
- [Employee solidarity voucher](https://www.charitips.com/docs/use-cases/loyalty-points/solidarity-voucher.md) (Professional services): A 60 € voucher funded by the employer, given all or part
- [Full guide: edge cases, webhooks, receipts](https://www.charitips.com/docs/use-cases/loyalty-points.md)
- [All use cases](https://www.charitips.com/docs/use-cases.md)
