---
title: "Property sale completed: donations with the Charitips API"
description: "An estate agency gives 1 % of the sale price at completion, taken from its own fee."
canonical: https://www.charitips.com/docs/use-cases/achievement/property-sale
---

# Property sale completed: donations with the Charitips API

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

- **Use case**: [A donation for an achievement](https://www.charitips.com/docs/use-cases/achievement.md)
- **Sector**: Professional services
- **Who pays**: Your company
- **What starts the donation**: A customer action
- **Example**: 1 % of the sale price, from the agency's fee
- **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/achievement/property-sale.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": "1 % of every sale",
    "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": "1 % of every sale",
    "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. When the sale is completed

- Button: Complete the sale

**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": 650000,
    "uniqueExternalId": "sale_2026_0231",
    "externalId": "client_5521"
  }
  ```

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.

## Other ways to run it

- [Customer referral](https://www.charitips.com/docs/use-cases/referral.md) (Software and apps): 10 € when the friend signs up
- [Lease signed online](https://www.charitips.com/docs/use-cases/achievement/lease-signed.md) (Professional services): 3 € for each lease signed online
- [Certification passed](https://www.charitips.com/docs/use-cases/achievement/certification.md) (Education): 5 € for each certification passed
- [Survey completed](https://www.charitips.com/docs/use-cases/achievement/survey-completed.md) (Software and apps): 0,50 € for each survey completed
- [Unused rental kilometres](https://www.charitips.com/docs/use-cases/achievement/unused-kilometres.md) (Travel and mobility): 0,05 € per kilometre not driven
- [Unused buffet portions](https://www.charitips.com/docs/use-cases/achievement/unused-portions.md) (Hotels and restaurants): 1 € per portion saved, after the event
- [Insurance deductible settled](https://www.charitips.com/docs/use-cases/achievement/deductible-settled.md) (Banking and insurance): 5 % of the deductible, on each settled claim
- [Energy contract referral](https://www.charitips.com/docs/use-cases/achievement/energy-referral.md) (Energy): 10 € once the referred contract is active
- [Housekeeping skipped](https://www.charitips.com/docs/use-cases/achievement/skipped-housekeeping.md) (Hotels and restaurants): 1 € per day without housekeeping, at check-out
- [Shared ride completed](https://www.charitips.com/docs/use-cases/achievement/shared-ride.md) (Travel and mobility): 0,50 € per shared ride
- [New seller's first listing](https://www.charitips.com/docs/use-cases/achievement/seller-activation.md) (Software and apps): 5 € when a new seller lists within a week
- [Charity clause in a contract](https://www.charitips.com/docs/use-cases/achievement/contract-clause.md) (Professional services): 2 € per contract signed, to the charity the clause names
- [Festival tickets](https://www.charitips.com/docs/use-cases/achievement/festival-tickets.md) (Culture and events): 1 € per ticket, chosen after payment
- [Project milestones delivered early](https://www.charitips.com/docs/use-cases/achievement/project-milestones.md) (Software and apps): 10 € per milestone delivered early
- [Stand-up streak](https://www.charitips.com/docs/use-cases/achievement/standup-streak.md) (Software and apps): 5 € for every 10 stand-ups on time
- [Full guide: edge cases, webhooks, receipts](https://www.charitips.com/docs/use-cases/achievement.md)
- [All use cases](https://www.charitips.com/docs/use-cases.md)