BillingCenter enhanced funds tracking

Enhanced Funds Tracking provides visibility into how funds flow through BillingCenter. At a high level, the feature tracks each inflow of money or credit as a funds source, maintaining its balance in the unapplied fund as one or more unapplied fund slices, and recording each debit or credit against a slice as a funds use event. You can trace how the balance of a specific funds source is used up by being applied, disbursed, written off, transferred, or reversed.

Enhanced Funds Tracking is an optional feature that must be enabled. When enabled, you can use Cloud API to access Enhanced Funds Tracking data of an account, producer, or suspense payment. There are cases in which requests or responses contain different fields based on whether the feature is enabled. For example, when creating account disbursements through Cloud API in a BillingCenter instance with Enhanced Funds Tracking enabled, you must provide unappliedFund and unappliedFundSlices fields.

For more information about Enhanced Funds Tracking from a business perspective, see the Application Guide.

When Enhanced Funds Tracking is not enabled, you cannot work with some features:
  • Unapplied funds slices
  • Enhanced funds use events
  • Enhanced funds use event groupings
  • Funds slice allocations
  • Enhanced funds sources (You can query for them, but BillingCenter always returns none)

Enhanced funds tracking endpoints

The following entities and endpoints contain Enhanced Funds Tracking data.

T-Accounts: A T-account owns the unapplied fund slices and links them to enhanced funds sources and enhanced funds use events. T-accounts are used in Enhanced Funds Tracking flows, but they are accessible even if Enhanced Funds Tracking is not enabled.

  • Get T-accounts for an account: GET /billing/v1/accounts/{accountId}/t-accounts
  • Get T-accounts for a producer: GET /billing/v1/producers/{producerId}/t-accounts
  • Get T-accounts for a suspense payment: GET /billing/v1/suspense-payments/{suspensePaymentId}/t-accounts
  • Get details for a T-account: GET /billing/v1/t-accounts/{tAccountId}

For information about T-accounts, see BillingCenter T-accounts.

Enhanced funds sources: Represent transactions that add money or credits into the unapplied fund.

  • List sources for an account: GET /billing/v1/accounts/{accountId}/enhanced-funds-sources
  • List sources for a producer: GET /billing/v1/producers/{producerId}/enhanced-funds-sources
  • Get details for a source: GET /billing/v1/enhanced-funds-sources/{enhancedFundsSourceId}

For information about enhanced funds sources, see Enhanced funds sources.

Unapplied fund slices: Contain the balance of a specific funds source within a specific unapplied fund.

  • List slices for a T-account: GET /billing/v1/t-accounts/{tAccountId}/unapplied-fund-slices
  • Get details for a slice: GET /billing/v1/t-accounts/{tAccountId}/unapplied-fund-slices/{unappliedFundSliceId}

For information about unapplied funds slices, see Unapplied fund slices.

Enhanced funds use events: Represent the transactions that have debited or credited an unapplied fund slice.

  • List use events for a slice: GET /billing/v1/t-accounts/{tAccountId}/unapplied-fund-slices/{unappliedFundSliceId}/enhanced-funds-use-events
  • Get details for a use event: GET /billing/v1/t-accounts/{tAccountId}/unapplied-fund-slices/{unappliedFundSliceId}/enhanced-funds-use-events/{enhancedFundsUseEventId}

Event grouping: Provides a collection of enhanced funds use events based on the associated transaction. For example, all funds use events created by a single credit distribution are included in a group. Each enhanced funds use event is associated with an event grouping, which is captured in the eventGrouping field.

  • Get details for a grouping: GET /billing/v1/enhanced-funds-use-event-groupings/{enhancedFundsUseEventGroupingId}
  • List funds use events for a grouping: GET /billing/v1/enhanced-funds-use-event-groupings/{enhancedFundsUseEventGroupingId}/enhanced-funds-use-events

For information about funds use events and funds use event groupings, see Enhanced funds use events and use event groupings.

Fund slice allocations: Provide information about which fund slices were used when creating disbursements. Use the following endpoints:

  • Funds slice allocations for a disbursement: GET /billing/v1/disbursements/{disbursementId}/funds-slice-allocations
  • Disbursement funds slice allocation details: GET /billing/v1/disbursements/{disbursementId}/funds-slice-allocations/{fundsSliceAllocationId}

For information about funds slice allocations, see Funds slice allocations.