Skip to content

Client-facing 'contact {biller} for assistance' copy — review framing #73

@n8bar

Description

@n8bar

Concern

Several client-facing copy spots tell the payer to "contact {billerContactName} for assistance" when there's an outstanding balance or overpayment.

Surfaces (resources/views/invoices/partials/print/content.blade.php):

  • Line 331 — overpayment-with-gratuity-note variant
  • Line 333 — overpayment fallback
  • Line 338 — underpayment / outstanding balance
  • Line 342 — gratuity-only note

$billerContactName resolves to billingDetails['name'] or "the biller" as fallback (line 325).

Issues

  1. Assumes a support relationship that may not exist. "Contact the biller for assistance" frames the issuer as a customer-support desk for payment-mechanics problems. For most small-business users of CZ, that's the wrong expectation — the issuer is a vendor, not a support team.

  2. Names can read oddly in context. When the biller name is something like "CyberCreek" (parent-org or test-account naming), client-facing copy that says "Contact CyberCreek for assistance" can leak branding into places that should read product-neutral or be silent.

  3. The copy doesn't add useful action. A payer who has overpaid/underpaid generally knows; the instruction to "contact the biller" doesn't tell them how, doesn't guarantee a response channel, and creates support expectations on the issuer side.

Suggested direction

Per copy spot, choose one of:

  • Drop the "for assistance" framing entirely (state the fact: "Outstanding balance of X — please send the remaining amount.")
  • Keep biller-contact only where there's a clear next action (e.g., refund request after overpayment, where the client genuinely needs the biller to act).
  • Consider whether the issuer should be able to customize/override this copy from their settings (footer-note pattern already exists in billingDetails['footer_note']).

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions