The roadmap description says billing teams can return an unused retainer balance through the project invoice. They no longer have to correct an already confirmed invoice just to release the remainder. Teams can choose to retain or refund the balance, and project closeout gets simpler even when no new chargeable transactions exist.
Roadmap status versus documentation
The February 2027 date is an estimate, and Microsoft says roadmap dates and descriptions can change. The timeline is also muddled:
- Microsoft's archived 2025 release wave 2 plan listed the feature for public preview in March 2026, with no general availability date.
- That page warned that some functionality in the plan had not been released and that delivery timelines may change.
- Microsoft Learn's procedure page, last updated March 13, 2026, already documents the workflow. It tells users to enable a "Refund retainers" feature flag.
So the documentation describes how the feature works, but the roadmap still shows it as in development. Don't assume your tenant has it, or that it's production-ready, just because a Learn page exists. Check for the feature flag in your own environment before planning a closeout around it.
The problem it solves
In Project Operations, a retainer or advance recorded on a contract can't be used against customer charges until it has been invoiced and that invoice confirmed. Before this feature, returning the unused remainder generally meant correcting the original invoice. A 2023 community walkthrough from D365 Feeds described exactly that route: select the original retainer invoice, choose "correct invoice," and a new invoice for the balance is created.
Microsoft's current guidance describes a simpler approach. If a project finishes with a remaining retainer balance, Project Operations lets you refund the unused amount from a project invoice or directly from the project contract, without separate corrective invoices.
Scenarios the feature covers
Microsoft's release plan lists several supported cases:
- Refunding unused retainer balances within the same invoice, so no corrective invoice is needed.
- Refunds when the invoice has no chargeable transactions, or when the total invoice amount is zero or negative.
- A UI toggle that lets users choose between retaining and refunding the remaining amount.
- Integration with "Refresh invoice line transactions," which fetches retainers in a "ready for invoicing" state even when no chargeable transactions exist.
The no-chargeable-transactions case matters most for closeout. A project can end with all work billed and money still sitting in a retainer. Without this feature, there may be no natural invoice to hang the refund on.
Step by step: refunding from a project invoice
This is the documented path when you are already working on an invoice. It assumes the feature flag is enabled.
- Open an existing draft project invoice, or create one from the Billing hub. Microsoft says you can create a draft even with no chargeable transactions, as long as you are refunding retainers.
- Go to Applied advances and retainers.
- Select one or more retainers with an available balance. If a retainer isn't on the invoice yet, select Add to include it with its available amount.
- For a newly added retainer, choose between applying it to invoice transactions (using Extended amount) and refunding it.
- To refund, select the retainer and choose Refund. Its status becomes Ready to refund. Cancel refund reverses the staging.
- Confirm the invoice. The status changes to Refunded, and the amount is returned to the customer.
Step by step: refunding from the project contract
Microsoft documents this path for closing a project when no invoice exists yet.
- Go to Sales > Project contracts and open the contract.
- Under Advances and retainers, select one or more retainers with an available balance.
- Select Refund. The status becomes Ready to refund.
- Create a draft invoice, for example from the Billing hub.
- Review the refund in Applied advances and retainers, then confirm the invoice to complete it.
Statuses and limits
| Status | Meaning |
|---|---|
| Ready to refund | The refund is staged but not yet processed |
| Refunded | The refund invoice is confirmed |
| (Blank) | The retainer is active, or was reset due to a correction |
Documented limits:
- You can't refund more than the retainer's available balance.
- Refund actions aren't available on confirmed invoices.
- If a confirmed refund needs changing, use invoice correction or revision flows.
- Extended amount is calculated from Amount minus Used amount. You can lower it but can't raise it above what remains.
Selecting Refund only stages the refund. Confirming the invoice completes it, so that step is your financial control point. Have someone review the Applied advances and retainers grid before confirming.
What admins and finance teams should do
- Check availability first. Look for the "Refund retainers" flag in a non-production environment. Treat the February 2027 roadmap date as an estimate.
- Update closeout checklists. Decide who reviews retainer balances at project end, and whether refund or retention is the default for each contract type.
- Test an end-to-end refund. The documentation covers the invoice workflow, but not payment settlement timing or accounting treatment. Confirm with your finance and ERP owners how a refund invoice flows into receivables and payments in your setup.
- Educate billing staff. The refund status is easy to misread. "Ready to refund" is not money returned.
Analysis
This is a modest feature with real operational value. Corrective invoices create extra confirmed documents and audit-trail clutter, and they are awkward when no work is left to bill. A refund built into the invoice lifecycle is a more natural fit.
The caveats are the ones above: the roadmap says "in development" while Learn already documents the steps, and the archived release plan carries different dates. Neither source covers regional tax handling, payment timing, or how the feature interacts with specific ERP-integrated setups. Pilot it before you rely on it for a live closeout.
References
- Dynamics 365 Project Operations: Optimize Project Operations - Refund retainers feature Microsoft 365 Roadmap · 2026-11-17T18:36:41.967573Z
- Invoice a retainer or an advance learn.microsoft.com
- Refund unused retainers learn.microsoft.com