> ## Documentation Index
> Fetch the complete documentation index at: https://docs.briksync.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payments

> How rent payments work in BrikSync PropOS. Track payment status, view payment history, and manage arrears.

BrikSync PropOS gives landlords and property managers a clear, real-time view of rent payments across their portfolio. You can record payments, track status against each lease, and tenants can see their own payment history in their portal.

<Note>
  **Online card payments are coming soon.** During beta, BrikSync PropOS does not process online
  rent payments — there is no live checkout. You can record and track payments (bank transfer, cash,
  cheque, and more) manually, and tenants can view their payment history. We'll announce online
  collection in the [changelog](/changelog/2026-06-20) when it's enabled.
</Note>

***

## How Payments Work

Each active lease in BrikSync PropOS generates an expected rent payment based on the rent amount and due date set in the lease. Payments are tracked against these expected amounts, giving you a clear picture of what has been collected and what is outstanding.

***

## Payment statuses

| Status         | Meaning                                                                                     |
| -------------- | ------------------------------------------------------------------------------------------- |
| **Pending**    | Payment expected but not yet received.                                                      |
| **Processing** | Reserved for online payments (coming soon) — not used while payments are recorded manually. |
| **Succeeded**  | Full payment received and confirmed.                                                        |
| **Failed**     | Payment attempt failed.                                                                     |
| **Refunded**   | Payment was refunded to the tenant.                                                         |
| **Disputed**   | Payment is under dispute.                                                                   |

<Note>
  Overdue payments are derived from Pending or Processing payments where the due date has passed.
  "Overdue" is a display label, not a stored status.
</Note>

***

## Viewing Payment History

### For Managers and Landlords

1. Go to **Payments** in the left sidebar.
2. You will see a full list of all rent payments across your properties.
3. Use the **filters** to narrow by:
   * **Month** — view payments for a specific month.
   * **Year** — view payments for a specific year.

You can also view payment history from an individual **Lease record**.

### For Tenants

Tenants can view their own payment history by going to **Payments** in their portal. They will see:

* All past payments with dates, amounts, and status.
* The next upcoming payment — amount and due date.
* A **Download Receipt** button for any payment marked as succeeded.

***

## Paying rent online (coming soon)

<Note>
  Online rent payments are not yet enabled. We're building secure online collection so tenants will
  be able to pay rent directly from their portal in a future release. For now, tenants pay via your
  existing method (bank transfer, cash, cheque, etc.) and you record the payment in BrikSync PropOS
  so it shows up in the tenant's history. We'll announce online payments in the
  [changelog](/changelog/2026-06-20) when they go live.
</Note>

***

## Downloading a receipt

After a payment has been confirmed as **Succeeded**, you can download a PDF receipt. Tenants can download receipts for their own payments. Property managers, landlords, and admins can download receipts for any payment within their organisation.

1. Go to **Payments** in the tenant portal.
2. Find the succeeded payment.
3. Click **Download Receipt**.

The receipt includes:

* Receipt ID
* Tenant name and email
* Property and unit
* Payment amount and any late fee
* Due date and payment date
* Payment status

<Info>
  Receipts are only available for payments in **Succeeded** status. Tenants can only access receipts
  for their own payments; property managers, landlords, and admins can access any receipt within
  their organisation.
</Info>

<Tip>
  You can also download receipts programmatically via `GET /api/payments/receipt?paymentId={uuid}`.
  See the [API overview](/api/overview) for details.
</Tip>

***

## Recording a Manual Payment

If a tenant pays by bank transfer, cheque, or cash, you can record the payment manually.

1. Go to **Payments** and click **Record Payment**.
2. Select the **tenant** and **lease**.
3. Enter the **amount** (0.01–1,000,000) and **payment date** (YYYY-MM-DD).
4. Enter the **due date** (YYYY-MM-DD).
5. Select the **payment method** — one of: **Bank Transfer**, **Cash**, **Check**, or **Other** (defaults to Other).
6. Enter **late fee charged** if applicable (0–10,000, defaults to 0).
7. Add any **reference notes** (up to 1,000 characters).
8. Click **Save Payment**.

The payment will be reflected in both your dashboard and the tenant's portal.

<Note>
  Recording payments manually is the primary way to track rent during beta. Integrated online
  payment collection is coming soon.
</Note>

***

## Managing Arrears

Tenants with overdue payments are flagged automatically in your dashboard. The Payments overview shows an **overdue count** stat card so you can see at a glance how many payments are past due.

<Tip>
  Rent reminders are sent automatically to tenants **3 days before rent is due**, as long as the
  tenant has rent reminders enabled in their notification settings.
</Tip>

***

## Exporting Payment Records

<Note>
  CSV and PDF export of payment records is **coming soon**. We'll announce this in the
  [changelog](/changelog/2026-06-20) when it's available.
</Note>

***

## Waiving a payment

<Note>
  Payment waiving is not yet available via the API. To waive a payment, record a refund using the
  **Refunded** status or contact support for assistance.
</Note>

***

## Automatic payment processing (coming soon)

<Note>
  Automated online payment processing is part of our roadmap and not yet enabled. When online
  collection launches, payment statuses will update in real time and every confirmation will be
  logged to your audit trail. Until then, you control payment status by recording payments manually.
  We'll announce this in the [changelog](/changelog/2026-06-20) when it's available.
</Note>

***

Built by [Errsol Technologies LLP](https://errsol.com)
