> For the complete documentation index, see [llms.txt](https://help.paintscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.paintscout.com/support/invoicing-and-payments/payment-requests/how-to-create-a-payment-request.md).

# Create a Payment Request

Create payment requests for deposits, progress payments, and remaining balances on invoices.

Payment requests in PaintScout let you request deposits, progress payments, or full balances on a single invoice. Use a deposit to collect a partial payment before work starts. Your customer receives an email with a link to pay online.

{% embed url="<https://www.youtube.com/watch?v=qMyV8GmnxEM>" %}

## What are payment requests?

A payment request is a notification sent to your customer asking for a specific payment amount. You can send multiple requests on one invoice to collect deposits and progress payments throughout a project.

***

## How to create a payment request

1. Create an invoice, scroll to the Payments section, and click **Add/Request Payment.**

   <figure><img src="https://231248629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyUbJF1GXLjxdJqm89IQ%2Fuploads%2Fgit-blob-5c977f79aa6f411dd8a79069fa36be19266fe4df%2FScreenshot%202026-08-04%20at%204.47.47%E2%80%AFPM.png?alt=media" alt="Screenshot showing the Add/Request Payment button in the Payments section of an invoice"><figcaption></figcaption></figure>
2. Choose **Request Payment.**

   <figure><img src="https://231248629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyUbJF1GXLjxdJqm89IQ%2Fuploads%2Fgit-blob-f58ae4dd510df09f1cc48a565f034a7c29330322%2FScreenshot%202026-08-04%20at%204.48.10%E2%80%AFPM.png?alt=media" alt="Screenshot showing the Request Payment option in the pop-up menu"><figcaption></figcaption></figure>
3. On the **Configure Payment** dialog, you’ll find two options for your payment request:

* **Full Amount:** Choose this option to request the total amount listed on the invoice. Ideal for collecting the full remaining balance in one go.
* **Custom:** Use this option to customize your payment request. You can request a deposit or progress payment in either a dollar amount ($) or a percentage (%). If you choose a percentage, you’ll have the option to calculate it based on the total invoice amount or the remaining balance.

<figure><img src="https://231248629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyUbJF1GXLjxdJqm89IQ%2Fuploads%2Fgit-blob-c00fa771f090827caf3929e9a33f16d78fbf262a%2FScreenshot%202026-08-04%20at%204.49.13%E2%80%AFPM.png?alt=media" alt="Screenshot showing the Configure Payment screen with Full Amount and Custom payment options"><figcaption></figcaption></figure>

4. Add an optional **Client Note** to your payment request. Your customer sees this message.
5. You can choose whether to allow credit card or ACH payments in the payment settings for this invoice.
6. When your payment request is ready, click **Next** to draft the email, then click **Send Payment Request** to send it by email or text.

   <figure><img src="https://231248629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyUbJF1GXLjxdJqm89IQ%2Fuploads%2Fgit-blob-a6a6ad07bdc679e2415dd591b6661f9e3eccf33f%2FScreenshot%202026-08-04%20at%204.50.27%E2%80%AFPM.png?alt=media" alt="Screenshot showing the email composition screen with the Send Payment Request button"><figcaption></figcaption></figure>
7. Your customer sees the request at the top of their invoice.

<figure><img src="https://231248629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyUbJF1GXLjxdJqm89IQ%2Fuploads%2Fgit-blob-72793f1eb08798effc1a09ba8036074ec8b15eed%2FScreenshot%202026-08-04%20at%204.56.17%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

8. Sent requests appear in the Payments section with a **Requested** status.

<figure><img src="https://231248629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyUbJF1GXLjxdJqm89IQ%2Fuploads%2FUybBqJjZz4nqsAhlUewD%2FScreenshot%202026-08-07%20at%2011.13.39%E2%80%AFAM.png?alt=media&amp;token=908d5e6d-bb71-409e-af04-36e3fb43c587" alt=""><figcaption></figcaption></figure>

&#x20;&#x20;

## Related articles

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Delete a Payment Request</strong></td><td>How to remove a payment request from an invoice while keeping the invoice accessible</td><td><a href="/support/invoicing-and-payments/payment-requests/how-to-delete-a-payment-request.md">Delete a Payment Request</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.paintscout.com/support/invoicing-and-payments/payment-requests/how-to-create-a-payment-request.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.