Resolves account.virtual-account.v1 activation for a specific entity
(the ledger account's owning identity or organization). The route engine
derives the customer's programIds from customerId and
sourceWalletType from ledgerAccountId.
Pass providerType to signal creation/mutation intent — the matcher only
enforces Dart-parity preconditions when virtualAccountProvider === "VICTOR"
(see migration 20260418004128_virtual_account_victor_preconditions).
OptionalaccountNumbers?: string[]OptionalbankIds?: string[]Filter by the linked bank's externalId.
OptionalblockTime?: DateSnapshot point for the balance lookup. Defaults to the latest known balance.
OptionalcreatedAt?: DbTimestampCriteriaOptionalcustomerIds?: string[]Filter by the owning customer's externalId.
OptionalentityIds?: string[]Filter by the owning entity (identity or organization) externalId.
Optionalids?: string[]OptionalincludeDeleted?: booleanDefaults to false — deleted rows are hidden unless explicitly included.
OptionalledgerAccountAddresses?: Address[]OptionalledgerAccountIds?: string[]OptionalorderBy?: DbOrderByCriterion<Defaults to createdAt DESC when omitted.
Optionalpage?: numberDefaults to 1.
OptionalpageSize?: numberRows per page, default 50 (clamped to 200). Results are always paginated.
total is the full match count regardless of pageSize, so pageSize: 1
counts matches cheaply without materializing every row.
OptionalproviderTypes?: ("VICTOR" | "BIVO" | "ROUTE_FUSION" | "ZENUS" | "MANUAL")[]Optionalq?: stringCase-insensitive substring match on account name or account number. Whitespace-only values are a no-op.
OptionalrouteFusionEntityIds?: string[]Matches the RouteFusion entity id stored on data->>'entityId'.
OptionalrouteFusionProgramIds?: string[]Matches the RouteFusion program id stored on data->>'programId'. NOT
index-backed — this seq-scans virtual_account.
OptionalrouteFusionWalletIds?: string[]Matches the routefusion_wallet_id column, served by the partial index
virtual_account_routefusion_wallet_id_idx.
Optionalstatuses?: ("PENDING" | "ACTIVE" | "FAILED" | "INACTIVE")[]OptionalupdatedAt?: DbTimestampCriteria
The process default: built from each dependency's own
instance().