Skip to main content

Managing Section 8 Payments

Learn how to create and apply credit note schedules for Section 8 payments to ensure invoices are accurate.

Written by Jimmy Chowdhury

Use a Credit Note schedule and automatic action to apply housing-assistance credits to a tenant's outstanding invoices. Create a separate Housing Assistance item so tenants see and pay only their share of rent.

Create a Credit Note Schedule

  1. Go to Tenants and select the correct tenant.

  2. Open the Future tab.

  3. Click New Schedule.

  4. Set the transaction type to Credit Note.

  5. Complete the schedule details and save it.

The Credit Note schedule appears on the tenant's Future tab after it is created.

Apply Credits Automatically

Go to Settings > Automatic Actions and look for Automatically apply available credits. Most accounts have this action enabled already.

If it is not available, create it:

  1. Click New Automatic Action.

  2. Set the trigger to When there are outstanding invoices and click Continue.

  3. Leave the condition set to Always, then click Continue.

  4. Set the event to Apply credits to outstanding invoices.

  5. Set Apply To to All Outstanding.

  6. Select Credit Notes as the credit type to apply.

  7. Click Save.

Create a Housing-Assistance Item

  1. While creating an invoice, open the Item dropdown for a line item.

  2. Click Manage, then Add Item.

  3. Enter a recognizable name, such as Section 8 or Housing Assistance.

  4. In the Account dropdown, choose an income account. Using the same income account as rent is recommended.

  5. Clear Tenant Portal Payment and Tenant Autopay, then save the item.

An item must have Tenant Portal Payment enabled before it can use Tenant Autopay. For housing assistance, leave both options disabled so tenants cannot see or pay the agency portion.

Split the Invoice Charges

Add separate line items for the tenant and housing-assistance portions of the rent. For example, for total rent of $800:

  • Add the tenant's rent item for $500.

  • Add the Housing Assistance item for $300.

Click Save to record the invoice. The tenant portal shows only the tenant-payable line item, preventing accidental payment of the housing-assistance amount. When the agency payment is received, record it from the management side to complete the invoice.

Did this answer your question?