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

# Tips

> How Nmbr pays, taxes and reports each tip earning type

Nmbr has three earning types for tips: `tips_direct`, `tips_controlled` and `tips_allocated`. Quebec has its own rules for tips, and most of the differences between the types apply only there. The `gratuity` earning type isn't a tip. See [Gratuity](#gratuity).

Each type is an earning line item. Create one with [Create an earning line item](https://docs.nmbr.co/api-reference/earning-line-items/create-an-earning-line-item.md) and set `earning_type` to the type. The Quebec rules apply when the employee's [province of employment](https://docs.nmbr.co/guides/payroll-fundamentals/province-of-employment.md) (POE) is Quebec.

The API makes the treatment of each tip type available, province by province. Pass `features=ca` to [Retrieve an earning type](https://docs.nmbr.co/api-reference/earning-types/retrieve-an-earning-type.md) to see what's withheld, whether the amount is paid out, and whether it counts toward vacation pay and statutory holiday pay in each province. See [Treatment by province](#treatment-by-province) for an example.

***

## Summary

| Type | Paid through payroll | POE outside Quebec | POE in Quebec |
| :- | :- | :- | :- |
| `tips_direct` | No | Nothing withheld. Not reported on the T4. | Income tax, QPP, EI and QPIP withheld. T4 box 14, RL-1 boxes A and S. |
| `tips_controlled` | Yes | Income tax, CPP and EI withheld. T4 box 14. | Income tax, QPP, EI and QPIP withheld. T4 box 14, RL-1 boxes A and S. |
| `tips_allocated` | No | Nothing withheld. Not reported on a slip. | Quebec income tax and QPP withheld. RL-1 boxes A and T. |

In the POE in Quebec column, income tax means federal and Quebec income tax, QPP is the Quebec Pension Plan, and QPIP is the Quebec Parental Insurance Plan.

***

## Outside Quebec

`tips_direct` is for tips a customer gives the employee that the employer doesn't control. Outside Quebec, direct tips have no payroll effect. Nmbr doesn't pay them, nothing is withheld, and they aren't reported on the T4. The employee reports them on their own tax return. The amount is left out of gross pay, net pay, the deposit, the employer's debit and the journal entry.

`tips_controlled` is for tips the employer controls and then pays to the employee, such as a tip pool the employer distributes, tips handed to the employer to redistribute, or a mandatory service charge. Controlled tips are paid like wages. The amount is included in gross pay, net pay and the employee's deposit, income tax, CPP and EI are withheld, and it's reported in T4 box 14.

`tips_allocated` has no effect on pay, withholdings or tax slips.

***

## Quebec

In Quebec, employees report the tips they receive to their employer, as Quebec law requires, and the employer withholds and reports on them. Each type is treated differently from the rest of Canada.

### Direct tips

Declared tips are recorded as `tips_direct`. They're taxed and insurable, reported in T4 box 14 and RL-1 boxes A and S, and count toward vacation pay and statutory holiday pay. Nmbr still doesn't pay them, so the withholdings come out of the employee's other pay on the same pay stub. If the withholdings are more than the pay run through payroll, the pay stub gets a `negative_net_disbursement_on_pay_stub` warning, which blocks approval. See [Warnings](https://docs.nmbr.co/api/overview/warnings.md).

### Controlled tips

Controlled tips are paid like wages, with income tax, QPP, EI and QPIP withheld. They're reported in T4 box 14 and RL-1 boxes A and S, and count toward vacation pay and statutory holiday pay.

### Allocated tips

`tips_allocated` applies only in Quebec. When the tips employees declare fall below the level Revenu Québec requires, the employer allocates the shortfall to them. Nmbr doesn't calculate the allocation. The line item carries the amount the employer allocated.

Allocated tips aren't paid and aren't included in gross pay. Quebec income tax and QPP are withheld from the employee's other pay. Federal income tax, EI and QPIP don't apply. They're reported on the RL-1 in boxes A and T, not on the T4, and count toward vacation pay and statutory holiday pay.

***

## Treatment by province

This guide covers the main differences between the tip types. For the complete treatment, pass `features=ca` to [Retrieve an earning type](https://docs.nmbr.co/api-reference/earning-types/retrieve-an-earning-type.md) or [List earning types](https://docs.nmbr.co/api-reference/earning-types/list-earning-types.md):

```bash theme={null}
curl --request GET \
     --url https://sandbox.nmbr.co/services/payroll/earning_types/tips_direct?features=ca \
     --header 'Authorization: Bearer <access_token>' \
     --header 'accept: application/json'
```

The response's `features` array lists, for each jurisdiction, whether the type is subject to income tax, CPP or QPP, EI or QPIP, workers' compensation and employer health tax, whether it counts toward vacation pay and statutory holiday pay, and whether it's paid out and included in gross pay. A jurisdiction missing from a feature means the type has no effect there. See [Line Item Type Features](https://docs.nmbr.co/guides/payroll-fundamentals/line-item-type-features.md) for the full response format.

***

## Gratuity

> [!NOTE]
>
> `gratuity` is not a tip. Gratuity is a Revenu Québec term for a bonus, incentive or similar lump-sum payment, and Revenu Québec sets its own method for withholding Quebec income tax on it.
>
> In Quebec, a `gratuity` is paid through payroll, with income tax, QPP, EI and QPIP withheld. Quebec income tax is calculated with the Revenu Québec method for gratuities. It's reported in T4 box 14 and RL-1 box A, and doesn't count toward vacation pay. Outside Quebec, a `gratuity` is treated the same as `tips_controlled`.
>
> See [Gratuities and Retroactive Pay](https://www.revenuquebec.ca/en/businesses/source-deductions-and-employer-contributions/special-cases-source-deductions-and-employer-contributions/gratuities-and-retroactive-pay/) on the Revenu Québec site.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.