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

# How are payments allocated to invoice items, and how do I re-allocate one?

> See which invoice items each payment covered, move a payment to different items, and lock past allocations with a lock date.

> [!NOTE]
>
> **Must know**
>
> * **Where it shows.** Once money has moved on an invoice, staff with **View financials** see three tabs on it: **Allocated items**, **Payments applied** and **Allocation history**.
> * **Re-allocating is bookkeeping only.** **Re-allocate** is on **Payments applied** and needs **Edit financials**. It never changes what the family owes.
> * **The allocation lock.** It is the **Allocations locked through** row on **Settings > Financials > Closing Dates**, and changing it needs **Financial admin**. The later of it and **Books closed through** applies.
> * **New payments.** A new payment reads "Waiting to be assigned (usually within a minute)". If it still isn't assigned after a while, it reads "Not posted to the books yet".

**What it is.** Uplifter assigns every payment and refund to the invoice parts it paid: lines, discounts, taxes, the service fee and surcharges.

**Where to find it.** Open an invoice from **Financials > Invoices**. Each allocation tab appears only when it has rows, and a summary line at its top reads **Fully allocated** once payments cover every item. If the figures can't load, a single **Allocation** tab reads "Couldn't load the payment allocation." with **Try again**. A failed refresh keeps the old figures and says they may be out of date.

**Allocated items.** The table shows **Item**, **Account**, **Charged**, **Allocated**, **Refunded** and **Left to cover**. When your governing body takes a share of a line (such as a body membership), that share is its own row under the same item name, on the **Due to Governing Bodies** account, and your governing body's own service fee shows as a **Governing body service fee** row. Under the table, a note reads "Left to cover is what payments haven't been assigned to yet. This doesn't change what the family owes." (it names the club on an invoice billed to a club). **Left to cover** and this note are hidden when money not yet posted covers everything left, so a paid invoice does not look owed.

**Payments applied.** Each row shows the payment's method, amount and assigned day, and what it is **Assigned to**.

| Under **Assigned to** | What it means |
| - | - |
| Each item it covers, with an amount | Assigned |
| "Waiting to be assigned (usually within a minute)" | A new payment, not assigned yet |
| "Not posted to the books yet" | Still waiting a while after it was recorded |
| "Assigned when imported history is posted" | A payment brought over from your previous system |
| **Unallocated \[amount]**, with the reason under it | Part of the payment sits on no item (the summary warns "Money received but not assigned to an item yet.") |
| "Kept for the family \[amount]" ("Kept for \[club]" on an invoice billed to a club) | Money an invoice edit freed that stays on the invoice |
| "Handed back \[amount]" | Money given back off this payment's unassigned part as a refund or credit, including one an invoice edit hasn't posted yet |
| "Covers part of a refund \[amount]" | This payment now covers items another payment's refund or credit freed |

While a payment waits, the summary line at the top reads "\[amount] not posted to the books yet".

**Allocation history.** Columns are **When**, **What**, **Amount** and **By** (a staff name, or **Automatic**). **What** is **Paid**, **Refunded**, **Payment returned**, **Overpayment credit**, **Invoice changed** or **Re-allocated**.

**1. Click Re-allocate**

On **Payments applied**, click **Re-allocate** on a completed payment that is assigned.

**2. Type an amount for each item**

Type an amount in each item, or click **Fill** to move unassigned money onto it. Each item shows **Up to** \[amount], the most it can take. Amounts can't be negative, and going past the limit reads "\[Item] can take at most \[amount]." Tax rows are allocated separately. Too much overall reads "This payment has \[amount] left to assign, so these amounts are \[amount] too much." **Unallocated:** next to **Save** shows what is left, hidden at \$0.00. The kept, handed back and refund amounts show beside it, and handed-back money is never assigned to an item. **Save** stays off until you change an amount.

**3. Add a reason and save**

Type a **Reason (optional)**, kept in the invoice's activity. If the payment is on or before the lock date, the dialog warns it is in a locked period and the field reads **Reason (required)**. Click **Save**. A message reads "Payment re-allocated", and **Allocation history** gets a **Re-allocated** row with your name. If it says "These allocations changed while you were editing", click **Reload** and try again.

**Set the allocation lock.** The lock is the **Allocations locked through** row on **Settings > Financials > Closing Dates**. It shows the date or "Not set", and only **Financial admin** sees **Change**. When **Books closed through** is later, the row shows that date with "Follows your books closing date". Moving the date earlier or removing it needs a reason. If a save reads "A payment is being posted right now. Try again in a moment.", save again. For the steps, see [How do I lock my books with closing dates?](https://docs.uplifter.app/club/money-payouts-accounting/lock-your-books-with-closing-dates.md).

**What the lock covers.** Payment allocations only. Refunds, invoice changes and journal entries still post on their own dates. **Change history** on **Closing Dates** records each change and its reason.

**The report.** **Reports > Payments > Payment allocations** lists money collected by the item it paid for, one row per assignment (refunds and re-allocations included), dated the day it was assigned. **Invoice #** links to the invoice. Filter by **Allocation date** (the last 30 days to start), **Payment date**, **Payment Method**, **Invoice #** or **Unallocated money only**. **Total allocated** counts every payment method, less refunds, so it differs from ledger revenue. **Reports > Payments > Revenue ledger** splits each payment by account the way its allocations recorded it when it came in, with a discount as its own negative row, so a later change to the invoice does not move an earlier payment. The **Unallocated only** toggle on **Payment reconciliation** is a different filter: it finds card and bank payments not matched to the processor.

**Related:** [How do I lock my books with closing dates?](https://docs.uplifter.app/club/money-payouts-accounting/lock-your-books-with-closing-dates.md) · [How does my club's ledger work?](https://docs.uplifter.app/club/money-payouts-accounting/how-the-ledger-works.md) · [Which reports are available, and what does each one show?](https://docs.uplifter.app/club/money-payouts-accounting/which-reports-are-available.md) · [How do I take a payment on an invoice?](https://docs.uplifter.app/club/payments-checkout/take-a-payment-on-an-invoice.md)


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