Tenant Portal Overview

The Tenant Portal is a self-service web application at my.aqarjia.com where tenants can manage their rental experience. It provides tenants with access to their lease information, payment history, and the ability to pay invoices online and submit maintenance requests.

Tenant Login

Tenants log in using their mobile phone number and a one-time password (OTP):

  1. The tenant visits my.aqarjia.com.
  2. They enter their registered phone number.
  3. An OTP code is sent to their phone.
  4. They enter the code to access the portal.

No password is required -- authentication is entirely OTP-based for simplicity and security.

Tenants must be linked to their user account via the TenantUserLink system. Property managers set this up when adding tenants to the platform.

What Tenants Can See

Once logged in, tenants have access to:

Dashboard

A summary view showing:

  • Current lease details (unit, property, rent amount).
  • Upcoming and overdue invoices.
  • Recent maintenance request status updates.

Lease Information

  • Active lease terms and dates.
  • Property and unit details.
  • Lease contract documents (if uploaded by the property manager).

Invoices

  • All invoices issued to the tenant.
  • Invoice status (Pending, Paid, Overdue).
  • Line item breakdown for each invoice.
  • Online payment option for unpaid invoices.

Payments

  • Complete payment history.
  • Payment receipts.
  • Payment method details.

Maintenance Requests

  • Submit new maintenance requests.
  • Track the status of existing requests.
  • View resolution details and communications.

Multi-Organization Support

A single tenant may have leases with multiple property management companies. The portal shows data across all organizations the tenant is linked to, providing a unified view of all their rentals.

Setting Up Portal Access

To enable portal access for a tenant:

  1. Ensure the tenant record has a valid phone number.
  2. The phone number is normalized to E.164 format automatically.
  3. The system creates the TenantUserLink when the tenant first logs in, matching by phone number.

Security

  • OTP codes expire after a short time window.
  • Sessions are managed via secure cookies with the BFF (Backend-for-Frontend) pattern.
  • Tenants can only see their own data -- they cannot view other tenants' information.