Glossary

Business vocabulary

Advance

Cash paid to a supplier ahead of marketplace remittance, repaid out of subsequent remittances. Modelled as supplier_advances with a supplierAdvanceKey. An advance line is a revolving facility rather than a one-off advance.

Advance offer request

The priced proposal for an advance, keyed by advanceOfferRequestKey. Carries requested/recommended/approved amounts, risk rating, fee periods, reserve and underwriter notes. See Advances and offers.

Balance approval

Treasury review of a supplier’s balance before a transfer is released. Backed by the pending_review endpoints. See Balance approval.

Batch (payment batch)

A group of supplier payments released together as a fund transfer, keyed by processKey / batch id. See Processes and batches.

Chargeback

A reversal charged back to the supplier’s balance, added via the Actions menu.

Deposit account

The supplier’s bank account that Payability deposits into, keyed by depositAccountKey. Manual bank accounts can be bulk-imported by CSV.

EFS

A prepaid card programme (Electronic Funds Source). efsAvailable, efsRebatePercent and efsLastCardReqTs on the supplier record; a dedicated card-transactions tab. See Card programmes.

Fund facility limit

The ceiling on total funding exposure for a supplier (fundFacilityLimit).

Instant access

The product where a supplier receives daily accelerated payouts (instantAccess on the supplier record).

KYC document

An identity/business verification artefact tracked per supplier with a status, surfaced as kycDocumentsStatuses. See Onboarding and KYC.

Marketplace

A sales channel Payability funds against (Amazon Seller Central, Amazon Vendor Central/Express, Walmart, Target, …), keyed by marketplaceKey.

Marketplace supplier (mp-supplier)

The link between one supplier and one marketplace, keyed by mpSupKey / mpSupplierKey. Funding settings, opt-in periods, minimum-fee overrides and statements all hang off this link, not off the supplier.

Marqeta

A card issuing platform used for one of the card programmes, keyed by marqetaKey. The supplier record carries marqetaStatuses (businessState, userState).

Airwallex

A card issuing platform behind the CARD_MANAGEMENT_AIRWALLEX feature flag, with its own cardholder registration and terms-acceptance status.

Month-end close

The periodic accounting close process exposed under Manage.

Opt-in period

A date range in which a supplier has opted a marketplace into funding (SupplierMarketplaceOptInPeriodModel). oldestOptIn on the supplier is the earliest one.

Payment config

A configured outgoing payment method for a supplier, keyed by paymentConfigKey. Pre-funded cards can be bulk-imported by CSV.

Pending edit / pending approval

A supplier change that requires a second pair of eyes before it takes effect (pendApprovNeeded).

Progressive pricing

The advance fee model: a list of periods, each with a length and a weekly fee percentage, whose totals produce the average fee. Defaults are chosen from the underwriting risk rating. See Advances and offers.

Receivable

An amount owed to the supplier by a marketplace that Payability can fund against.

Remittance

The marketplace’s periodic payout, from which Payability recovers advances. Loaded into the system through the Load Remittance action.

Reserve (repayment reserve)

The portion of incoming funds withheld to repay an advance. Expressed both as a percentage (offerAdvanceReservePercent, extraReservePercent) and an amount (reserveTotalAmount).

Risk rating

The underwriting score (an integer; -1 means "no rating") that selects the default progressive-pricing period table.

Supplier

A marketplace seller — the customer of Payability and the central entity of the application, keyed by supplierKey.

Supplier site

Which branded self-service front end the supplier logs into (supplierSite, e.g. supplier, supplier4, volusion, neweggcapital). The allowed values are in environment.supplierSiteVersions.

UCC

A Uniform Commercial Code lien filing recorded during underwriting, with a TransUnion lookup flow. See Underwriting.

Underwriting (initial / daily)

Initial underwriting decides whether to fund at all; daily underwriting re-evaluates an active supplier. Both are tabs of the supplier workspace.

Win-back

A campaign to re-activate a cancelled supplier.

Write-off

Recognising an unrecoverable balance (writeoff on the supplier record; MANAGE_BAD_DEBT permission).

Codebase vocabulary

Action (NgRx)

A hand-written class with readonly type referencing an exported string constant. NgRx 4 style — no createAction. See state management.

Action (event rule)

Something an event rule does when it fires: create-task, send-email, edit-supplier, push-to-event-bridge (and a disabled notify-on-slack). See events.

Actions Tools

The actionstools backend service that stores CRM activity (notes, tasks, files) and global settings. Base URL actionsToolsUrl.

AppConfigService

The single source of runtime configuration: version, theme and the whole environment object. Provided by factory in app.module.ts.

CRM item / stream

A note, task, file, event, email or batch email attached to a target UUID (usually a supplier key). Streams are the per-type uuid lists in CrmStateModel (all, notes, tasks, events, emails, batchEmails, files, pinnedNotes). See CRM.

EVA

A separate Payability front end embedded in Internal Admin via iframes and driven by a typed postMessage protocol. Base URL evaApiUrl. See iframe messaging and EVA.

Event logger

The eventlogger backend that stores the domain event stream and the Elasticsearch-backed changelog. Base URL eventLoggerUrl.

Event rule

A stored rule that reacts to a domain event, filters it and runs actions. Two generations exist (manage/event-rules and manage/event-rules-2). See events.

Feature flag

A build- or runtime-toggled capability name from the FEATURE_FLAGS enum, applied via FeatureFlagsService, FeatureFlagGuard or the appEnabledByFeatureFlag directive. See feature flags.

Formgroup key / model part

The supplier workspace edits the supplier record in parts: each editable card has a formGroupKey, and the store tracks per-part in-edit / saved / error maps (supplierModelPartInEdit, …Saved, …Errors). See partial editing.

GCI

A build-time correlation id (workflowGciId) generated by deployment/generate_gci.py and sent to the B2B task manager.

Lookup / utils slice

Reference data (timezones, funding periods, US states, countries) fetched once and cached in localStorage via lscache under the utils state slice.

pyb-material

A wrapper module that re-exports the Angular Material modules the app uses, so a component or a spec imports one module instead of thirty.

Session token

The JWT held in the auth state and sent as the X-Session-Token header by AuthInterceptor. See authentication.

Target UUID

The CRM’s notion of "what this activity is about" — sent as X-Actions-TargetUUID / X-EventLogger-TargetUUID. For supplier pages it is the supplier key.

Task manager (B2B workflow)

The b2btaskmanager backend that runs long jobs (earnings/remittance loads) and streams progress over server-sent events. See real-time streams.