---
title: "Energy saved: donations with the Charitips API"
description: "An energy supplier compares each bill with the customer's baseline and gives 1 cent per kWh saved."
canonical: https://www.charitips.com/docs/use-cases/periodic-statement/kwh-saved
---

# Energy saved: donations with the Charitips API

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

- **Use case**: [A saved choice, a periodic statement](https://www.charitips.com/docs/use-cases/periodic-statement.md)
- **Sector**: Energy
- **Who pays**: Your company
- **What starts the donation**: Every period
- **Example**: 0,01 € per kWh saved, on each bill
- **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`

Interactive demo on the page. The same flow as a build spec: https://www.charitips.com/docs/demos/statement/kwh-saved.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": "Your energy supplier",
    "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": "Your energy supplier",
    "charitiesSelectionId": "<charitiesSelectionId>",
    "type": "PERMANENT",
    "amountType": "FREE_AMOUNT"
  }
  ```
- [`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. At the October bill

- Button: Issue the October bill

**Your server calls:**

- [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md) Create a donation: from your server, when it happens; amount in cents

  ```json
  {
    "campaignId": "<campaignId>",
    "amount": 312,
    "uniqueExternalId": "bill_contract_77120_2026-10",
    "externalId": "household_77120"
  }
  ```

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

### 2. When the charity is chosen

- The customer picks a charity from your selection.
- Button: Choose the charity

**Your server calls:**

- [`POST /v1/donations/{donationId}/claim`](https://www.charitips.com/docs/api-reference/claim-donation.md) Claim a donation: donationId from the create-donation response

  ```json
  {
    "charityId": "<charityId>"
  }
  ```

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

### 3. At the December bill

- Button: Issue the December bill

**Your server calls:**

- [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md) Create a donation: from your server, when it happens; amount in cents

  ```json
  {
    "campaignId": "<campaignId>",
    "amount": 287,
    "uniqueExternalId": "bill_contract_77120_2026-12",
    "externalId": "household_77120",
    "charityId": "<charityId>"
  }
  ```

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

## Other ways to run it

- [Share of a subscription](https://www.charitips.com/docs/use-cases/subscription-share.md) (Software and apps): 1 % of each plan, every renewal
- [Card cashback](https://www.charitips.com/docs/use-cases/card-cashback.md) (Banking and insurance): 1 % of card spending, each month
- [No-claim year bonus](https://www.charitips.com/docs/use-cases/periodic-statement/no-claim-bonus.md) (Banking and insurance): 10 € after a year with no claim
- [Unused premium given back](https://www.charitips.com/docs/use-cases/periodic-statement/unused-premium.md) (Banking and insurance): 5 % of the unused premium, at year end
- [Monthly share of a premium](https://www.charitips.com/docs/use-cases/periodic-statement/policy-renewal.md) (Banking and insurance): 1 € a month, inside the premium
- [Share of a card fee](https://www.charitips.com/docs/use-cases/periodic-statement/card-fee-share.md) (Banking and insurance): 10 % of the yearly fee of a premium card
- [Cashback on purchases](https://www.charitips.com/docs/use-cases/periodic-statement/purchase-cashback.md) (Banking and insurance): 1 % of each purchase, settled monthly
- [Premium plan revenue](https://www.charitips.com/docs/use-cases/periodic-statement/premium-plan.md) (Education): 5 % of the Premium plan revenue, each month
- [Active time converted](https://www.charitips.com/docs/use-cases/periodic-statement/active-time.md) (Software and apps): 0,01 € per active period, settled monthly
- [Full guide: edge cases, webhooks, receipts](https://www.charitips.com/docs/use-cases/periodic-statement.md)
- [All use cases](https://www.charitips.com/docs/use-cases.md)