Skip to main content
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

​
transaction_id
string
required
The ID of the transaction this tip is associated with.
​
employee_id
string
required
The employee receiving the tip.
​
employee_name
string
required
Display name of the employee receiving the tip.
​
tip_amount
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

​
transaction_id
string
required
The ID of the transaction this tip is associated with.
​
employee_id
string
required
The employee receiving the tip.
​
employee_name
string
required
Display name of the employee receiving the tip.
​
tip_amount
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

​
tip_id
string
required
The ID of the tip record to adjust.
​
new_amount
number
required
The corrected tip amount in dollars.
​
reason
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

​
employee_id
string
required
The employee receiving the payout.
​
employee_name
string
required
Display name of the employee receiving the payout.
​
payout_amount
number
required
The payout amount in dollars.
​
payout_method
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.