Record tips, payouts, and wage theft analytics

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

string

required

The ID of the transaction this tip is associated with.

string

required

The employee receiving the tip.

string

required

Display name of the employee receiving the tip.

number

required

Tip amount in dollars. Example: 3.50

Code example

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

string

required

The ID of the transaction this tip is associated with.

string

required

The employee receiving the tip.

string

required

Display name of the employee receiving the tip.

number

required

Tip amount in dollars. Example: 5.00

Code example

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

string

required

The ID of the tip record to adjust.

number

required

The corrected tip amount in dollars.

string

required

A description of why the tip is being adjusted. Recorded in the audit trail.

Code example

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

string

required

The employee receiving the payout.

string

required

Display name of the employee receiving the payout.

number

required

The payout amount in dollars.

string

required

How the payout is disbursed. One of: cash, check, direct_deposit

Code example

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

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

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.

Overview

Transactions

Jurisdiction

Tipping

Compliance & Audit

Record tips, payouts, and wage theft analytics

Authentication

POST /tip/cash — Process a cash tip

Request body

Code example

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

Request body

Code example

POST /tip/adjust — Adjust a tip

Request body

Code example

POST /tip/payout — Process employee payout

Request body

Code example

GET /analytics/tips — Tip analytics

Code example

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

Code example

​Authentication

​POST /tip/cash — Process a cash tip

​Request body

​Code example

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

​Request body

​Code example

​POST /tip/adjust — Adjust a tip

​Request body

​Code example

​POST /tip/payout — Process employee payout

​Request body

​Code example

​GET /analytics/tips — Tip analytics

​Code example

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

​Code example

Authentication

POST /tip/cash — Process a cash tip

Request body

Code example

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

Request body

Code example

POST /tip/adjust — Adjust a tip

Request body

Code example

POST /tip/payout — Process employee payout

Request body

Code example

GET /analytics/tips — Tip analytics

Code example

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

Code example