> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centsless.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Record tips, payouts, and wage theft analytics

> Record cash and credit card tips, adjust tip amounts, process employee payouts, and retrieve tip analytics using the Centsless tipping API.

Centsless provides FLSA-compliant tip processing for cash and credit card transactions. Ceiling rounding always favors the employee — any fractional cent rounds up, never down. Every tip operation is recorded in the audit trail with a cryptographic hash, giving you a tamper-evident record for wage compliance purposes.

## Authentication

All requests require an `x-api-key` header.

***

## POST /tip/cash — Process a cash tip

Record a cash tip against a completed transaction.

```
POST https://api.centsless.org/api/v1/tip/cash
```

### Request body

<ParamField body="transaction_id" type="string" required>
  The ID of the transaction this tip is associated with.
</ParamField>

<ParamField body="employee_id" type="string" required>
  The employee receiving the tip.
</ParamField>

<ParamField body="employee_name" type="string" required>
  Display name of the employee receiving the tip.
</ParamField>

<ParamField body="tip_amount" type="number" required>
  Tip amount in dollars. Example: `3.50`
</ParamField>

### Code example

```bash theme={null}
curl -X POST https://api.centsless.org/api/v1/tip/cash \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "TXN-2026-04-14-A82C2EAA",
    "employee_id": "EMP-001",
    "employee_name": "Jordan Smith",
    "tip_amount": 3.50
  }'
```

***

## POST /tip/credit-card — Process a credit card tip

Record a credit card tip with a full audit trail entry.

```
POST https://api.centsless.org/api/v1/tip/credit-card
```

### Request body

<ParamField body="transaction_id" type="string" required>
  The ID of the transaction this tip is associated with.
</ParamField>

<ParamField body="employee_id" type="string" required>
  The employee receiving the tip.
</ParamField>

<ParamField body="employee_name" type="string" required>
  Display name of the employee receiving the tip.
</ParamField>

<ParamField body="tip_amount" type="number" required>
  Tip amount in dollars. Example: `5.00`
</ParamField>

### Code example

```bash theme={null}
curl -X POST https://api.centsless.org/api/v1/tip/credit-card \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "TXN-2026-04-14-A82C2EAA",
    "employee_id": "EMP-001",
    "employee_name": "Jordan Smith",
    "tip_amount": 5.00
  }'
```

***

## POST /tip/adjust — Adjust a tip

Correct a previously recorded tip amount. All adjustments are logged with a reason for audit purposes.

```
POST https://api.centsless.org/api/v1/tip/adjust
```

### Request body

<ParamField body="tip_id" type="string" required>
  The ID of the tip record to adjust.
</ParamField>

<ParamField body="new_amount" type="number" required>
  The corrected tip amount in dollars.
</ParamField>

<ParamField body="reason" type="string" required>
  A description of why the tip is being adjusted. Recorded in the audit trail.
</ParamField>

### Code example

```bash theme={null}
curl -X POST https://api.centsless.org/api/v1/tip/adjust \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tip_id": "TIP-00123",
    "new_amount": 4.00,
    "reason": "Customer corrected amount after signing"
  }'
```

***

## POST /tip/payout — Process employee payout

Disburse accumulated tips to an employee. Rounding always favors the employee (FLSA compliance).

```
POST https://api.centsless.org/api/v1/tip/payout
```

### Request body

<ParamField body="employee_id" type="string" required>
  The employee receiving the payout.
</ParamField>

<ParamField body="employee_name" type="string" required>
  Display name of the employee receiving the payout.
</ParamField>

<ParamField body="payout_amount" type="number" required>
  The payout amount in dollars.
</ParamField>

<ParamField body="payout_method" type="string" required>
  How the payout is disbursed. One of: `cash`, `check`, `direct_deposit`
</ParamField>

### Code example

```bash theme={null}
curl -X POST https://api.centsless.org/api/v1/tip/payout \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": "EMP-001",
    "employee_name": "Jordan Smith",
    "payout_amount": 42.75,
    "payout_method": "direct_deposit"
  }'
```

***

## GET /analytics/tips — Tip analytics

Returns aggregate tip statistics across all recorded tips.

```
GET https://api.centsless.org/api/v1/analytics/tips
```

### Code example

```bash theme={null}
curl https://api.centsless.org/api/v1/analytics/tips \
  -H "x-api-key: YOUR_API_KEY"
```

The response includes totals by payment method (cash vs. credit card), average tip amounts, and pool distribution summaries.

***

## GET /analytics/tip-wage-theft — Wage theft detection

Analyzes recorded tip data for patterns that may indicate wage theft violations.

```
GET https://api.centsless.org/api/v1/analytics/tip-wage-theft
```

### Code example

```bash theme={null}
curl https://api.centsless.org/api/v1/analytics/tip-wage-theft \
  -H "x-api-key: YOUR_API_KEY"
```

The response flags patterns associated with tip skimming, unauthorized deductions, and employees being paid below the federal minimum wage after the tip credit is applied.