Home / Guides/ Handle Transactions

Deliver Statements

Overview

Providing your customers with billing statements is recommended whenever your product assesses fees and may be required for certain products, such as Consumer Credit. Highnote provides the data necessary to create a statement, which you can leverage to populate your own statement template. This guide will walk you through how to retrieve a Financial Accounts' billing data for your customers.

For questions on your product’s billing statement requirements or regulatory requirements, please contact the Highnote team.

You may opt to be notified when new billing statements are available for Financial Accounts so you can generate statements to provide to your account holders. To learn more on how to subscribe to Events, please see Notifications.

Generate Current Billing Statement

Billing statement data is created on Financial Accounts and becomes available at the end of a billing cycle. For Credit Card products, the billing period end date may vary across Financial Accounts on your portfolio. Statement data is typically available within 48 hours of a billing period end date.

You can query the latest billing statement data for a Financial Account to generate the Account’s statement in the latestClosedStatement. Billing statements will only include posted transactions and the associated balances for a given billing period. Transactions for the Financial Account’s current billing period and their next, upcoming due date can be found in the currentOpenStatement.

When there is a balance due on the Financial Account, the currentAmountDue will be updated based on credits (e.g. payments, refunds) to the Financial Account between the billing period end date and the due date. You’ll need to reference the type of CreditPayInFullCardFinancialAccountStatementSnapshot or SecuredDepositCommercialCreditCardFinancialAccountStatementSnapshot to retrieve the current amount due, based on your Card Product. You can present this balance to your customer outside of the statement itself so they are informed on the remaining amount owed since their last statement was generated.

Find Billing Statement History

You can also search for the history of billing statements on a Financial Account based on a date range for your customers to view. Up to 24 months of billing statement history can provided. The results will be empty if statement data is not yet available for the Financial Account. You can query by periodStart and/or periodEnd.

Fetch a Statement by ID

You can search for a statement’s details with a provided statement ID.

Statement Entries Pagination

Statement entries are paginated and can be filtered by their post date and whether they are credit or debit.

Simulate Shifting the Current Open Statement’s End Period in Test

In the Test Environment, you can end a Financial Account’s billing period early so you can simulate a billing period’s statement without waiting for the billing period to end. The new period must be at least 60 seconds in the future, and if the periodBoundary is not supplied, the statement endPeriod will be set to 60 seconds in the future.

Simulate Rolling Over to the Next Billing Cycle in Test

In the Test Environment, you can roll over a Financial Account’s billing period to the next billing cycle so you can simulate ending and starting a new billing cycle for a Financial Account. You’ll need to reference the type of CreditPayInFullCardFinancialAccountStatementSnapshot or SecuredDepositCommercialCreditCardFinancialAccountStatementSnapshot to retrieve the simulated, current amount due, based on your Card Product.

Provide Feedback

Was this content helpful?