Bilty finance and payments · How-to guide

Record an authorised manual Bilty payment

Add amount, payment method, reference, notes and paid date from the Bilty record when manual payment recording is appropriate. The guide follows the Help Centre standard: exact route, prerequisites, ordered steps, verification and operational boundaries.

Audience: Administrators and authorised Bilty operations staffPermission: Relevant Bilty Management capabilityModule v1.0.0
Jump to steps
Where to goBilty Management → Bilties → Open → Record payment
Before you startRequired access: Relevant Bilty Management capability. Work on the correct tenant and record. Use least privilege and review any dependency or protected workflow warning before continuing.

What you’ll accomplish

Add amount, payment method, reference, notes and paid date from the Bilty record when manual payment recording is appropriate. Bilty Management keeps drafts, issued records, public capability links, finance, integration events and audit evidence as connected but separately verifiable records.

How the workflow fits together

Use Credit, To Pay and Cash rules, native invoice automation and payment recording. Use the module's current status, permission checks, warnings and linked records to decide the next supported action. Where a downstream invoice, WhatsApp queue item, webhook, PDF, POD record or audit event applies, verify it separately.

Follow these steps

  1. Go to Bilty Management → Bilties → Open → Record payment.
  2. Confirm the active tenant, intended Bilty record and your permission before entering or changing data.
  3. Complete the supported workflow: Add amount, payment method, reference, notes and paid date from the Bilty record when manual payment recording is appropriate.
  4. Review the displayed validation, dependent fields and any privacy, finance or integration warning before continuing.
  5. Save, submit or run the action once and wait for the module response.
  6. Reopen the relevant register or record and verify the final status, linked records and audit evidence.

Fields and decisions to review

Bilty typeCredit, To Pay and Cash determine the commercial workflow.
Cash-only chargesLabour, TT and Other are valid only for Cash.
Native invoiceCredit invoice automation uses the existing Britixo invoice system when enabled.
Payment historyVerify payments on the Bilty and any linked native invoice separately.

Record, audit and evidence checks

Reopen the relevant Bilty record or register and confirm its identifier, current status, related parties, timestamps and connected evidence. Check the audit/compliance, payment, public-link, report, API, webhook or WhatsApp evidence that applies to this workflow rather than relying only on a success alert.

How to confirm it worked

Return to Bilty Management → Bilties → Open → Record payment or the resulting register and verify that the stored state matches the intended action. For any downstream automation, confirm the downstream record or queue/log entry as a separate completion check.

Technical basis for this guidance

This guide was checked against controllers/Bilty_management.php; models/Bilty_management_model.php; views/admin/dashboard.php; views/admin/bilty_view.php; bilty_management.php. It documents only behaviour exposed or enforced by the supplied module; internal secrets, raw signature payloads and unsupported future workflow assumptions are intentionally excluded.

Controls, checks and common mistakes

  • Do not reclassify Labour, TT or Other charges onto Credit or To Pay records.
  • A native invoice and the Bilty are connected records; reconcile both when correcting genuine financial data.
  • Do not use manual payment merely to hide a failed invoice/payment integration.
Data and workflow safetyConfirm the exact Bilty, authorised audience and final stored status before issuing, publishing a link, recording payment, changing shipment state or sharing a document.