A settlement payout adds commission from a sold listing to an agent's ledger, ready to be paid in a commission pay run. You can add one straight from the listing's commission worksheet, or from the agent ledger itself. When you add it from the commission worksheet, you can also put the payment on hold in the same step, for example while you wait for funds to clear.
This article covers how to add a settlement payout from the commission worksheet and from an agent ledger, how to create a payment on hold, and what to do with a remaining balance.
Please Note: Before you can add a settlement payout:
- Your account needs the Agent Ledgers add-on, and the agent needs an open agent ledger. For more on this, see - Setting up Agent Ledgers.
- The listing must use Commission Worksheet version 2. To check or change the version, go to the Commissions tab on the listing and click Worksheet Settings in the top right-hand corner.
- The commission must be invoiced with a Commission Invoice, not a Custom Invoice. For more on this, see - Creating Commission Invoices.
How Do I Add a Settlement Payout From the Commission Worksheet?
- Open the listing and switch to Finance mode using the $ button
- Go to the Commissions tab
- Scroll to the Payments Made To Agent Ledger section
- Click Add a payment next to the agent you want to pay
- The Settlement Payout For window opens, showing a summary of the commission. Check or update the Amount to Pay. For more on what each section shows, see - Editing a Settlement Payout.
- If you want to hold the payment, tick mark as on hold (see the next section)
- Click Add to Ledger
You can also get to the same worksheet from Financials > Commission Worksheets.
How Do I Put a Payment On Hold When I Create It?
When you add a payment from the commission worksheet, you can create it on hold straight away, instead of creating it and then holding it from the agent's ledger.
- In the Settlement Payout For window, tick mark as on hold. You'll find it at the bottom left, beside ignore uninvoiced balance.
- Click Add to Ledger
The payment is added to the agent's ledger with an On Hold status. On-hold payments are left out of commission pay runs until you release them.
A payment you've put on hold stays on hold, even if the commission worksheet is locked or its invoices change later.
If you leave mark as on hold unticked, the payment is added as normal.
Please Note: The mark as on hold option only appears when you add a payment from the commission worksheet. It doesn't appear when you add a settlement payout from an agent ledger, or when you edit an existing settlement payout. You can still hold those payments afterwards from the agent's ledger.
How Do I Release a Payment That's On Hold?
- Go to Financials > Agent Ledgers and open the agent's ledger
- Hover over the payment and click the Dropdown button
- Click Mark as Active
The payment will then be included in the next commission pay run. You can also hold any existing payment from the same dropdown, using Mark as On Hold.
How Do I Add a Settlement Payout From an Agent Ledger?
- Go to Financials > Agent Ledgers and open the agent's ledger
- Click the Add transaction dropdown
- Choose Add Settlement Payout
- Select the listing you want to process
- Click Continue
- A window opens with a summary of the commission payout. For more on this, see - Editing a Settlement Payout.
- Once you've finished, click Save Changes
What If There's a Balance I Don't Want to Pay the Agent?
If there's a remaining balance you don't want to pay to the agent:
- On the commission worksheet, click Ignore remaining balance next to the agent, or
- In the Settlement Payout For window, tick ignore uninvoiced balance
❓ FAQs
I can't see the mark as on hold option. Why?
Check that you opened the payment from Add a payment on the commission worksheet. The option doesn't appear when you add a settlement payout from an agent ledger or edit an existing one. Your account also needs the Agent Ledgers add-on for the worksheet's Payments Made To Agent Ledger section to appear.
Can I hold a payment after it's been created?
Yes. Open the agent's ledger, hover over the payment, click the Dropdown button and choose Mark as On Hold.
Will locking the commission worksheet release my held payment?
No. A payment you've put on hold stays on hold until you release it with Mark as Active.
Does this work if we use automated payments to agent ledgers?
Yes. The mark as on hold option still appears, and automated changes won't release a payment you've put on hold.
Can I set a date for a held payment to release automatically?
No. Payments held from the commission worksheet stay on hold until you release them with Mark as Active.
Do I need a new permission to use this?
No. Anyone who can already add settlement payouts to agent ledgers can use it.