You cannot put a prepayment on an engagement letter directly. It has to hang off a project. That is a deliberate constraint, and understanding it explains several behaviors that otherwise look arbitrary.
A prepayment is a price on a piece of work
Aiwyn treats the prepayment as an attribute of a project, not of a letter. A project is the thing your practice management system already knows about: it has a client, a service, a fiscal year, and — once you set one — a price. The prepayment is a portion of that price collected early.
The letter's total prepayment is simply the sum of the project prepayments on it. There is no separate letter-level figure to set.
Why it works this way
Money collected up front has to be attributable to something afterwards. When the payment lands it needs a client and a piece of work to sit against, or reconciliation becomes guesswork. Anchoring it to a project supplies both — and the same anchor lets the amount merge into the letter as a placeholder, next to the service it belongs to.
What follows from it
- You must price a project before you can prepay it. The prepayment field stays unavailable until you choose Fixed fee or Hourly. The prepayment amount cannot exceed the overall project price amount.
-
A prepayment triggers a payment step, but execution timing depends on configuration. By default, the letter becomes Executed after signatures and any required payment-method setup are complete, and Aiwyn charges the prepayment afterward. A failed charge does not undo execution. If the firm has
enable_sync_engagement_prepaymentenabled, the letter stays in Sent until Stripe confirms the payment succeeded. - The letter can describe the prepayment. Because the prepayment lives on the project, it is available to the template as a placeholder and as a field a block variant can test. A dynamic letter template can show a prepayment paragraph only on letters that carry one, and merge the amount next to the service it belongs to.
If your system has no projects
Some practice management systems do not use projects, and some firms choose not to. In that case the scope of services are empty and prepayments are not possible.
Engagement letters work perfectly well without projects — they are optional throughout. But there is no other route to requiring money up front.
Related
- Require a prepayment on a project
- What executed means, and what gates it