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

# Invoices and payments

> Invoices, the customer pay page, and recording payments.

Field Ops handles billing from work order to paid invoice: **work order → invoice → payment**.

## Invoices

Go to **Invoices** (`/invoices`). Search the list, or click **Create invoice** to start one.

* Invoice lines come from the **price book picker**. Search, filter by category, and add an item at its locked price. If an item isn't in the price book, add a **Custom item** with a reason.
* An invoice can include a **deposit**. When the deposit is the standard \$99, it's labelled **Reservation fee**; otherwise **Deposit**.
* In the list, chips read **Fee due** / **Fee paid**. On the invoice itself you'll see the full **Reservation fee due/paid**.
* Paid invoices keep **View PDF** and **Send receipt**.

### Unpaid invoices

The Desk **Unpaid** tile counts invoices that still have a balance and links to `/invoices?status=unpaid`. That filter matches the tile: stored balance greater than zero, status not void. It is not limited to the last 90 days.

On the invoices list, **Unpaid** is a status chip on the same admin list every allowed role sees. There is no separate unpaid screen.

### Who can open invoices

Every role except installers can open Invoices (`/invoices`), including the Unpaid tile and the unpaid status filter, and everyone sees the same list. Installers can't open `/invoices`. Being able to open invoices doesn't open **Collected** reporting; see [Reporting](https://help.yournewdoor.com/guides/reporting.md#your-own-numbers).

### On the job card and customer page

Invoices also appear on the [job card](https://help.yournewdoor.com/jobs/billing-and-invoices.md#invoices-on-the-job-card) and the [customer page](https://help.yournewdoor.com/customers/invoices-and-forms.md#invoices). Job-linked invoices (with payments when linked) show first; other invoices for the same customer appear under **Also on this customer** for context. Those views do not create or change invoice–job links.

### Invoices on sold jobs

When a customer signs a proposal, Field Ops gives the job a draft invoice built from the signed lines, so the installers on the job can collect in the field. Nothing is sent to the customer until you send it. Half now, half later jobs get their deposit invoice attached instead, and you build the final. See [Invoice on a sold job](https://help.yournewdoor.com/jobs/billing-and-invoices.md#invoice-on-a-sold-job).

### Edit a line description

Dispatchers, PMs and Admins can fix or reword the description on an invoice line, even after the invoice is sent, partly paid or paid. The quantity, price and totals stay the same.

**1. Click Edit next to the line**

Open the invoice. Under **Line items**, each line has an **Edit** button next to its description.

**2. Change the wording and save**

In **Edit description**, type the new wording in **Description** (up to 250 characters) and click **Save**. The line shows the new description right away.

* Only the description changes. **Qty**, price, discount, tax, total, amount paid and balance due don't.
* A pay link you already sent keeps working, so the customer doesn't need a new one.
* The PDF and the customer pay page show the new description.
* A blank description isn't saved. You'll see **"Enter a description."**
* Void invoices have no **Edit** button, and neither do roles other than Dispatcher, PM and Admin.

### Customer pay page

Customers pay on a secure link (`/pay/…`) and can download a PDF. The pay page shows the same breakdown as the PDF, so the customer can check what they're paying for before they pay. Customer copies never show labor or cost breakdowns. Drafts and void invoices have no PDF.

#### What the customer sees

The summary on the pay page lists, from top to bottom:

* **Line items:** each invoice line with its description, **Qty** and amount. Item codes aren't shown.
* **Subtotal**
* **Discount**, when the invoice has one, shown as a minus amount. If the discount has a reason, the row reads **Discount (reason)**, for example **Discount (Pay-in-full discount (10%))**.
* **Tax**, when there is tax.
* **Total**
* The deposit, amount paid and **Balance due** rows for this invoice.

If the line amounts don't add up to the subtotal to the cent (for example on a deposit invoice that was closed out for a smaller amount), the pay page hides the line items and shows only the totals, so the customer never sees lines that don't match what they owe.

#### One open pay link per invoice

An invoice has one open card payment at a time, whether the link came from the office or the customer opened the invoice's pay page themselves.

* **Same amount:** if a pay link for that amount is already open, the customer lands on that same payment page. No second payment page is made, so the balance can't be paid twice.
* **New amount:** sending a pay link for a different amount closes the older open link first. The old link then shows **"That payment link is no longer valid. Please request a new one."**
* **Already paid:** if the customer already finished paying through an open link, no new link is made.

If Field Ops can't confirm the state of an older link, it doesn't make a new one and shows the same **"That payment link is no longer valid. Please request a new one."** message. Try again in a moment.

> [!NOTE]
>
> If card payments aren't connected yet, the **Collect card** button is disabled with: *"Card payments aren't set up yet. Ask an admin to connect Stripe."*

## Send a pay link

Send the customer the invoice's pay page so they can pay by card themselves. The link is the invoice's own secure pay page (`ops.yournewdoor.com/pay/…`), the same one every time, so it doesn't go stale.

**Who can do this:** Dispatchers, PMs and Admins. Anyone else who clicks a pay-link button gets **"Only dispatcher, PM, or admin can record payments and discounts"** and nothing is copied or sent. Installers on the job can text the pay link from the field job page with a fixed message; see [Take a payment](https://help.yournewdoor.com/sales/field-packet.md#take-a-payment).

On an invoice with a balance due, the header has **Text pay link**, **Email pay link** and **Copy pay link** next to **Collect card payment** and **Record payment**.

* **Copy pay link** copies the link and shows **"Pay link copied"**.
* **Text pay link** opens the **Send by text** panel (see [Text the link](#text-the-link)).
* **Email pay link** opens the **Email pay link** panel (see [Email the link](#email-the-link)).
* On a **Reservation fee** or repair deposit invoice, **Text pay link** and **Email pay link** don't show. **Copy pay link** still works. To send the \$99 link to the customer, use [Reservation fee](https://help.yournewdoor.com/customers/reservation-fee.md) on the customer page.
* Paid and void invoices, and invoices with nothing due, show neither button. If the balance is already paid, you'll see **"No balance to pay."**

### From Collect card payment

**1. Click Collect card payment**

The panel says **"The customer pays on our secure page. You can copy the link, open it, or text it."** The **Amount (USD)** field starts at the balance due.

**2. Click Create payment link**

The panel shows **Payment link ready** and the link. Whatever you type in **Amount (USD)**, the link is the same invoice pay page, and the customer pays the balance shown there.

**3. Share it**

Click **Copy link**, **Open** to see the customer's page, **Send by text** or **Email pay link**. Click **Done** to close.

### Text the link

**1. Check who it goes to**

The **Send by text** panel shows the invoice number and customer, the phone it goes **To**, and the line it's sent from. If the customer has more than one phone, pick one under **Phone**. A number that replied STOP shows **· STOP** and can't be texted. **Opens thread** takes you to the customer's conversation in Texts.

**2. Edit the words if you want**

The message starts from a template, like **"Hi Sam, this is Alex at Your New Door. You can pay securely here:"**. You can change the words. The link and **"Reply STOP to opt out."** are added for you and can't be edited. Click **Reset to template** to undo your changes.

**3. Click Send text**

Or press Ctrl+Enter (Cmd+Enter on a Mac). You'll see **"Text sent to Sam"** with **Open thread**, and the text shows in the customer's conversation like any other text.

Only text customers who agreed to get texts.

### When the text doesn't send

| Message | What it means |
| - | - |
| **"Add a phone to text Sam."** | The customer has no phone number. Click **Add phone number**. |
| **"Add this invoice to a customer before texting a pay link."** | The invoice isn't tied to a customer. |
| **"Connect your texting line to send"** | You don't have a texting line set up. |
| **Earliest send:** and a day and time | It's quiet hours for the customer, so the text is blocked. Send it at or after that time, shown in your profile's timezone. |
| **"The pay link was changed. Reset to the template and try again."** | The link in the message was edited. Click **Reset to template**. |
| **"That wording can't be texted. Reset to the template and try again."** | The words include something that can't go in a pay-link text. |
| **"This invoice is void. The pay link no longer works."** | The invoice was voided. |
| **"A pay link was just texted for this invoice. Wait a few minutes before sending again."** | This invoice's pay link went to the same phone in the last 15 minutes. |

If the text fails for another reason, the reason shows in the panel with a **Retry** button.

### Email the link

Email the same pay page to an address already saved on the customer.

**1. Click Email pay link**

The **Email pay link** panel shows the invoice number and customer, the **Amount due**, and the link. The link is locked and can't be edited.

**2. Pick the address**

Under **Email on file**, pick one of the customer's saved emails. The primary email, marked **· Primary**, is picked for you. You can't type a new address here: to email someone else, add the address to the customer first.

**3. Click Send email**

The button reads **Sending…** while it works. You'll see **"Pay link emailed to"** and the address, and the panel closes. Click **Cancel** to close without sending.

The customer gets a Your New Door email with the invoice number, the amount due and the pay link.

### When the email doesn't send

| Message | What it means |
| - | - |
| **"Add an email on the customer before emailing a pay link."** | The customer has no email saved. Click **Add email address** to open the customer page and add one. |
| **"Add this invoice to a customer before emailing a pay link."** | The invoice isn't tied to a customer. |
| **"Pick an email address already on this customer."** | The address isn't saved on the customer. Pick one from **Email on file**. |
| **"No balance to pay."** | The invoice is paid, void or has nothing due. |
| **"The email provider timed out. Try again."** | The email didn't go out. Click **Send email** again. |
| **"Couldn't send the pay-link email. Try again."** | The email didn't go out. Try again in a moment. |

If the panel says email isn't connected or set up, ask an admin.

## Take a card by phone

When a customer reads you their card on a call, take it right on the invoice. The card form opens on the invoice page, and the payment is recorded the moment the card goes through.

**Who can do this:** Admins, the Owner, Managers, Executives, PMs, CSRs and Door Experts. Dispatchers, Design Concierges and installers don't get the card form.

**1. Open the invoice**

Go to the invoice from **Invoices**, or click **Go to invoice** on a published estimate or proposal (see [Go to the invoice from an estimate](https://help.yournewdoor.com/estimates/publish.md#go-to-the-invoice-to-take-a-card)). The **Take card by phone** box shows **Charges the balance due:** and the amount.

**2. Click Take card by phone**

The button reads **Loading card form…** for a moment, then the card form opens inside the box.

**3. Enter the card**

Type the card details the customer reads to you. If the bank asks for an extra check, it opens on screen; ask the customer for what it needs.

**4. Click Charge**

The button shows the amount, like **Charge \$500.00**, and reads **Charging…** while it works. When it goes through you'll see **"Payment of \$500.00 recorded."** and the invoice balance updates. Click **Cancel** instead to close the form without charging.

The amount is always the invoice's current balance due, including on partly paid and deposit invoices. You can't type a different amount. Your name is recorded on the payment as the person who took the card.

Opening the card form closes any pay link the customer still has open for this invoice, so the same balance can't be paid twice. If the customer already paid through their pay link and the payment isn't on the invoice yet, the card isn't taken: refresh the invoice and check the payment first.

### When the card form isn't offered

The box doesn't show on void or paid invoices, or when nothing is due. In these cases the **Take card by phone** button is greyed out with a line under it that says why:

| Message | What it means |
| - | - |
| **"This job was unsold. Card payments are off."** | The job on this invoice was unsold. |
| **"This invoice is financed. Card payments are off."** | The customer is paying through financing. |
| **"This deposit is no longer due — the final invoice covers the balance."** | Collect on the final invoice instead. |
| **"Card payments aren't set up yet. Ask an admin to connect Stripe."** | Card payments aren't connected. |
| **"Card payments are being set up — Stripe keys not matched yet"** | Card payments aren't fully connected. Ask an admin. |

### When someone else has the form open

Only one person can have the card form open on an invoice at a time. If a teammate has it open, you'll see a message like **"\[Teammate] has the card form open for this invoice (started 3 min ago). Ask them to finish or cancel, or take over — that cancels their form."** Click **Take over (cancels their form)** to close their form and open yours. A form left open for 30 minutes stops holding the invoice.

### Messages while you charge

These can show when you click **Take card by phone** or **Charge**.

| Message | What to do |
| - | - |
| **"Stripe shows the customer's pay link as completed, so the card was not taken. Refresh this invoice. If the payment still isn't showing, open Stripe → Payments for this invoice and check whether it went through before taking a card."** | The customer may have just paid through their pay link. Nothing was charged. Refresh the invoice. If the payment still isn't there, check Stripe before you take a card. |
| **"A card payment for this balance was already taken and then refunded, so nothing was charged and nothing new was recorded. Refresh the invoice and check the refund before taking another card."** | An earlier card payment for this balance was refunded. Refresh and check the refund before you charge again. |
| **"The balance changed since this card form opened (another payment landed). Nothing was charged — reopen the card form."** | Another payment came in. Open the form again; it charges the new balance. |
| **"This card form is no longer active (cancelled or taken over). Nothing was charged — reopen the card form."** | Someone took over or the form was cancelled. Open it again if you still need to charge. |
| **"Couldn't close the customer's open pay link at Stripe, so the card was not taken. Try again in a moment."** | Nothing was charged. Click **Charge** again in a moment. |
| **"Payment status unknown — refresh to check before trying again."** | Refresh the page and check the balance before you charge again. |
| **"The bank is still processing this card. The invoice updates when Stripe confirms."** | The charge went through but isn't final yet. Don't charge again. |

If the card is declined, the reason shows under the form and you can fix the details and click **Charge** again.

## Payments desk

Go to **Payments** (`/payments`) to see every payment.

* **Record payment** for cash or check. A customer is required. If you pick an invoice or job, it must belong to that customer.
* PMs and admins can void a payment.
* Filter by date with the same date picker used in Reporting (default **All time**). The date picker and the **Gross/Net** toggle sit at the right of the table header row, next to **Filters**.
* Possible overpayments and duplicate payments are flagged for review. Only PMs, admins and the Owner see those flags.

## Installers recording payment in the field

On the job packet (`/field/[id]`), the lead installer, or a crew helper on a visit for the job that is today (CT) or in progress, can **Record payment** for cash or check or **Text pay link** to the customer. Installers never see the amount, the link or the customer's phones. When there's nothing to collect, a **Take payment** box says **"No invoice yet — office needs to create one."** or **"Paid in full — nothing due on this job."** Installers can't open the Payments desk. See [Take a payment](https://help.yournewdoor.com/sales/field-packet.md#take-a-payment).

## Who can record payments

Dispatchers, PMs and admins can record payments, on the Payments desk or from an invoice. Installers can record payments only from the job packet, on jobs they lead or as a crew helper on a visit for the job that is today (CT) or in progress.

The Payments desk (`/payments`) opens for dispatchers, PMs, admins, CSRs and the Owner. CSRs and the Owner can look but not record. Managers and executives don't have the Payments desk.

Taking a card on an invoice is separate: Admins, the Owner, Managers, Executives, PMs, CSRs and Door Experts can do it. See [Take a card by phone](#take-a-card-by-phone).

## Payment emails

When a card payment goes through, on the customer's pay page or a card taken by phone, Field Ops sends two emails on its own. You don't need to click anything.

| Email | Who gets it | What it shows |
| - | - | - |
| Payment confirmation | The customer, at the first email saved on their customer page | Amount paid, invoice number, job number, when they paid (CT) and the remaining balance (**\$0.00** when paid in full) |
| Payment received | Every active Dispatcher, Admin and Manager with an email | The same details plus the payment method, with a link to the job, or to the invoice when it isn't on a job. The time follows each person's profile timezone (CT when none is set) |

* If the customer has no email saved, only the office email goes out.
* When an invoice has no job number, the email shows the invoice number in its place.
* Jobs tagged **test** don't send either email.
* Cash and check payments recorded on the Payments desk or the job packet, refunds, failed payments and voided payments don't send these emails.
* If an email can't be sent, the payment is still recorded.

## Starting a job on an installer's behalf

Admins, PMs and the Owner can **Start** a job for an installer. A reason is required (up to 500 characters). The job history shows **"Started the job"**.


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