Home / Issuing / Manage Credit
Your card product's delinquency credit policy is set by the Highnote team during card product configuration.
A financial account's delinquency state differs from its status.
CURRENT, DELINQUENT, CLOSING, CLOSED.ACTIVE, SUSPENDED, UNDER_REVIEW, PENDING_CLOSURE, CLOSED.Receivables are purchases that must be paid back and are represented by the account holder's outstanding account balance.
When an account holder borrows against a line of credit, receivables are created against their account. When the account holder does not make the minimum payment on their billing statement by the due date, the receivables can become delinquent.
An account holder’s financial account displays the following fields for delinquencies:
| Field | Description |
|---|---|
delinquencyStartedOn | The due date of the oldest, delinquent billing statement on the financial account |
totalDaysDelinquent | The number of days since the oldest, delinquent billing statement’s due date, as of today |
totalAmount | The total delinquent amount on the financial account, as of today |
totalNumberOfCycles | The number of billing cycles the financial account has been delinquent, as of today |
Financial accounts also display billing cycles. A billing cycle displays the following information for delinquencies:
| Field | Description |
|---|---|
daysDelinquent | The number of days delinquent for the billing cycle, as of today |
amount | The past due amount for the cycle’s billing statement, as of today |
state | The state of the billing cycle at the periodEnd |
Financial account attributes indicate the reason the account meets or exceeds your credit policy so that you can take action.
When a financial account’s totalDaysDelinquent meets or exceeds your card product’s delinquency policy, an attribute is added.
You can manage credit risk by notifying customers of delinquencies, performing collections, or suspending financial account authorizations.
To automate cardholder communications and send push alerts or notifications to account holders, use the financial account attributes notification events.
The following table provides an overview of supported financial account attributes with test environment default settings. Settings in the live environment may vary depending on your card product's delinquency policy:
| Attribute | Description | Test Environment Default Setting |
|---|---|---|
DELINQUENT | The financial account is considered delinquent based on your card product’s policy; no restrictions have been placed on the financial account. | totalDaysDelinquent >= 30 days |
DELINQUENT_SUSPENDED | The financial account is excessively delinquent based on your card product’s policy and the financial account’s status is SUSPENDED; authorizations are blocked on all associated payment cards. | totalDaysDelinquent >= 90 days |
CHARGE_OFF | The financial account has failed to make the minimum payment for X days, based on your card product's policy, and will be closed. The financial account attribute of CHARGE_OFF is added and the financial account status is set to SUSPENDED | totalDaysDelinquent >= 180 days |
When a payment is made and a financial account’s totalDaysDelinquent no longer exceeds your delinquency policy, Highnote removes the financial account attributes and updates the account to current.
The following diagram is a high-level view demonstrating how a cardholder can get into and out of delinquency with a card that has been configured with Highnote delinquency attributes.
The diagram shows the relationship of a financial account's delinquency state and status. The exact day when an account's receivables become delinquent varies depends on your configured policy.
The following scenarios show two ways to clear a delinquency and restore a suspended card to an active status.
Scenario: A minimum payment of $10 is past due for an initial card fee. The financial account delinquency state = DELINQUENT and status = SUSPENDED.
Workflow:
CURRENT (and clears from Dashboard view).ACTIVE.Scenario: A minimum payment of $25 is past due ($10 initial fee plus minimum payment of $15 for a $100 transaction). The financial account delinquency state = DELINQUENT and status = SUSPENDED.
Workflow:
DELINQUENT and account status stays SUSPENDED.CURRENT (and clears from Dashboard view).ACTIVE.You can view the totalDaysDelinquent and totalAmount on an individual financial account. You can also view the daysDelinquent and amount delinquent for an individual billing statement.
If the financial account is current or newly created and does not have a closed billing cycle, Highnote returns no delinquency data.
You can use the following query to find a financial account's delinquency status:
We recommend notifying the account holder if their account is being closed due to charge off.
When a financial account's receivable balance is uncollectible based on your card product's credit policy, the balance is charged off as a write-off expense.
A credit card balance is typically charged off when the account holder has not met the billing statement's minimum payment for 120 to 180 days. In the live environment, this length of time will be determined by your card product's credit policy.
When a charge-off occurs, the following events take place:
CHARGE_OFF attribute and the FinancialAccountStatus is updated to SUSPENDED, UNDER_REVIEW, or PENDING_CLOSURE. If the account receivables are delinquent for more than the configured charge_off_days, the Delinquency State is updated to CLOSING.CLOSED.To receive charge off notifications, subscribe to financial account attribute charge off events.
To simulate delinquency in the test environment, see Simulate Delinquency.