> ## 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.

# POST /transaction/override — Override rounding

> Apply a manager-approved override to a transaction's rounding amount. Requires employee attribution and a reason code. Creates an immutable audit record.

When a rounding outcome needs to be corrected after the fact — due to a customer dispute, a pricing error, or a system issue — a manager can apply an override. You submit the target transaction ID, the authorizing employee's identity, a reason code, and the corrected cash total. The engine creates an immutable override audit record with its own hash, linking it to the original transaction. Override records are surfaced in the override report and are included in the merchant's fraud risk profile.

## Endpoint

```
POST https://api.centsless.org/api/v1/transaction/override
```

## Authentication

<ParamField header="x-api-key" type="string" required>
  Your merchant or partner API key.
</ParamField>

## Request body

<ParamField body="transaction_id" type="string" required>
  The ID of the transaction to override (e.g., `TXN-2026-04-14-A82C2EAA`).
</ParamField>

<ParamField body="employee_id" type="string" required>
  The ID of the employee authorizing the override (e.g., `EMP-001`).
</ParamField>

<ParamField body="employee_name" type="string" required>
  The full name of the employee authorizing the override. Included verbatim in the audit record.
</ParamField>

<ParamField body="reason" type="string" required>
  Reason code for the override. One of: `customer-request`, `manager-discretion`, `pricing-error`, `system-error`.
</ParamField>

<ParamField body="new_cash_total_cents" type="integer" required>
  The corrected cash total to collect, in cents. This replaces the original `cash_total_cents` for settlement purposes.
</ParamField>

## Example

```bash theme={null}
curl -X POST https://api.centsless.org/api/v1/transaction/override \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "transaction_id": "TXN-2026-04-14-A82C2EAA",
    "employee_id": "EMP-001",
    "employee_name": "Jane Manager",
    "reason": "customer-request",
    "new_cash_total_cents": 720
  }'
```