---
title: "Second-hand seller's share: donations with the Charitips API"
description: "On a second-hand marketplace, a seller gives 10 % of a sale from their payout, in their own name."
canonical: https://www.charitips.com/docs/use-cases/b2c/seller-share
---

# Second-hand seller's share: donations with the Charitips API

> On a second-hand marketplace, a seller gives 10 % of a sale from their payout, in their own name. A badge shows on their listings and buyers see where the share goes.

- **Use case**: [Your users give their own money](https://www.charitips.com/docs/use-cases/b2c.md)
- **Sector**: Retail
- **Who pays**: Your users, with their own money
- **What starts the donation**: Your users choose to give
- **Example**: 10 % of a sale, given by the seller in their name
- **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), [`GET /v1/donations/{donationId}/fiscal-receipt`](https://www.charitips.com/docs/api-reference/get-donation-fiscal-receipt.md)
- **Webhooks**: `donation_create`, `fiscalreceipt_generated`

Interactive demo on the page. The same flow as a build spec: https://www.charitips.com/docs/demos/collect/seller-share.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": "Seller shares",
    "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": "Seller shares",
    "charitiesSelectionId": "<charitiesSelectionId>",
    "type": "PERMANENT",
    "amountType": "FREE_AMOUNT",
    "defaultHasBeenCharged": true
  }
  ```
- [`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. Charity chosen, share taken from the payout

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

**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": 450,
    "uniqueExternalId": "sale_20931_share",
    "hasBeenCharged": true,
    "withFiscalReceipt": true,
    "donor": {
      "firstName": "Camille",
      "lastName": "Martin",
      "email": "camille.martin@example.com",
      "street": "12 rue des Lilas",
      "zip": "75011",
      "city": "Paris",
      "country": "FR"
    },
    "charityId": "<charityId>"
  }
  ```

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

### 2. Fiscal receipt issued

- Button: Process the donation

No call: this screen only shows the result.

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

### 3. Receipt downloaded

- Button: Download

**Your server calls:**

- [`GET /v1/donations/{donationId}/fiscal-receipt`](https://www.charitips.com/docs/api-reference/get-donation-fiscal-receipt.md) Get a donation fiscal receipt: the receipt in the donor's name, once Charitips has issued it

## Other ways to run it

- [Users give their own money](https://www.charitips.com/docs/use-cases/b2c/own-money.md) (Software and apps): A one-off gift, the receipt in the donor's name
- [Donation matching](https://www.charitips.com/docs/use-cases/donation-matching.md) (Professional services): The user gives 20 €, the company adds 20 €
- [An extra on a group pot](https://www.charitips.com/docs/use-cases/b2c/pot-extra.md) (Banking and insurance): A contributor's extra, next to the platform's fee share
- [Savings interest, matched](https://www.charitips.com/docs/use-cases/b2c/interest-matched.md) (Banking and insurance): 10 % of the interest, matched by the bank
- [Badge unlocked by a gift](https://www.charitips.com/docs/use-cases/b2c/paid-badge.md) (Software and apps): 2 € to unlock a profile badge
- [Part of a buyback payout](https://www.charitips.com/docs/use-cases/b2c/device-buyback.md) (Retail): A platform buys a used smartphone for 182 €, the seller gives part of the payout in their name
- [Part of a clothes buyback](https://www.charitips.com/docs/use-cases/b2c/clothes-collection.md) (Retail): Clothes dropped off in store, 26,40 € bought back, part of it given in the person's name
- [Full guide: edge cases, webhooks, receipts](https://www.charitips.com/docs/use-cases/b2c.md)
- [All use cases](https://www.charitips.com/docs/use-cases.md)