Setup, navigation and lifecycle

Understand the payment-added property activity hook

Know when a CRM payment can add real-estate activity evidence.

Audience: CRM staffPermission: Invoice/payment permissionModule v1.0.0
Exact navigationAdmin Area → Sales → Payments → Record Payment
Before you begin
  • Use an account with Invoice/payment permission and confirm the intended record or setting before making a change.
  • Follow the exact route above. If the screen or action is absent, check module activation, ownership and permissions rather than using another person’s account.
  • Use controlled test data for configuration, integration, email, AI, payment, portal or automation changes before production-wide use.

What this guide covers

Know when a CRM payment can add real-estate activity evidence. The instructions reflect the supplied module’s registered menus, controller actions, views, settings and code-backed validation flow.

Exact step-by-step process

  1. Open Admin Area → Sales → Payments → Record Payment.
  2. Select the relevant record, filter, report, model or configuration described below.
  3. Use the displayed action or read the current values without altering unrelated data.
  4. Compare the output with the code-backed rules and expected result in this guide.
  5. Record or correct any mismatch before relying on the output in production.

Fields, choices and supported possibilities

Exact actionUnderstand the payment-added property activity hook
Exact navigationAdmin Area → Sales → Payments → Record Payment
Module version1.0.0
Access ruleInvoice/payment permission
VerificationReopen the source record and confirm the expected status, linked record, file, notification, portal visibility or financial effect.
Property ownership and listingConfirm the property owner/landlord, estate-agent company, listing type, transaction type, privacy and status before saving.
Address and mapComplete address, city, country and latitude/longitude where the map is used.
Commercial valuesReview price/rent, commission, fees, income/expense values, currency context and availability dates.
Financial recordClient/vendor/landlord, linked property/request/contract, date/due date, currency, items, taxes, discounts, totals and status.
Payment evidencePayment mode, amount, transaction ID, note/comments, date paid and email/PDF choices where exposed.

Code-backed validations and workflow rules

  • The after_payment_added hook runs after a core CRM payment is stored.
  • Verify the linked real-estate relation before relying on the activity.
  • Property visibility and actions are controlled by real_property view-own/view/create/edit/delete capabilities.
  • Property status, account status and approval workspaces are separate from the main listing form.
  • Verify linked CRM invoice/payment records before changing a real-estate payment or payout status.
  • The module hooks after_payment_added to write property-related activity when the payment is linked.

Expected result and verification

  • The supported understand the payment-added property activity hook flow completes without bypassing permission or validation checks.
  • The resulting record, setting, status, file, delivery event or external response is visible from the relevant workspace.
  • Unexpected validation, provider or linked-record errors are investigated before retrying.

Security, privacy and operational checks

  • Apply least privilege to purchasing, vendor, invoice, payment, return, contract and report permissions.
  • Verify vendor identity, bank/payment details, tax, currency, totals and approvals before creating financial commitments.
  • Treat public links, signatures, portal files, attachments and exported reports as controlled business records.
  • Test settings and automated jobs with controlled records before production-wide use.