---
title: "Contact left at a stand: donations with the Charitips API"
description: "At a trade show, an exhibitor gives 0,50 € for each visitor who leaves their details."
canonical: https://www.charitips.com/docs/use-cases/on-site/stand-lead
---

# Contact left at a stand: donations with the Charitips API

> At a trade show, an exhibitor gives 0,50 € for each visitor who leaves their details. One tap on the stand's tablet sends the contact and the charity choice; the exhibitor pays.

- **Use case**: [On site, at a kiosk or with a QR code](https://www.charitips.com/docs/use-cases/on-site.md)
- **Sector**: Culture and events
- **Who pays**: Your company
- **What starts the donation**: A customer action
- **Example**: 0,50 € per contact
- **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/onsite/stand-lead.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": "Trade show charity leads",
    "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": "Trade show charity leads",
    "charitiesSelectionId": "<charitiesSelectionId>",
    "type": "PERMANENT",
    "amountType": "FREE_AMOUNT",
    "withLeadCollection": true,
    "leadCollectionOptions": {
      "fullname": true,
      "companyName": true,
      "email": true,
      "phone": true,
      "custom": false
    }
  }
  ```
- [`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 form opens

- Button: Leave my details

**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": 50,
    "uniqueExternalId": "stand_b12_lead_0087"
  }
  ```

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

### 2. When the form is sent

- 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>",
    "lead": {
      "fullname": "Camille Martin",
      "companyName": "Martin Consulting",
      "email": "camille.martin@example.com",
      "phone": "06 12 34 56 78",
      "hasAcceptedTerms": true
    }
  }
  ```

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

## Other ways to run it

- [Cup returned at a festival](https://www.charitips.com/docs/use-cases/on-site/cup-return.md) (Culture and events): 0,50 € per cup returned
- [Game at an event stand](https://www.charitips.com/docs/use-cases/on-site/stand-game.md) (Culture and events): 1 € to 10 € per win
- [QR code on a product](https://www.charitips.com/docs/use-cases/on-site/product-qr.md) (Retail): 2 % of the price, scanned after purchase
- [Packaging returned in store](https://www.charitips.com/docs/use-cases/on-site/packaging-return.md) (Retail): 0,10 € per item returned, settled monthly
- [Cashless wristband top-ups](https://www.charitips.com/docs/use-cases/on-site/cashless-top-up.md) (Culture and events): 0,50 € per top-up, sent after the festival
- [Full guide: edge cases, webhooks, receipts](https://www.charitips.com/docs/use-cases/on-site.md)
- [All use cases](https://www.charitips.com/docs/use-cases.md)