This guide describes endpoints, webhooks, and <<glossary:CST>> functionality for managing overdraft accounts in your own system.

## Using the Get Overdraft Balance endpoint

The <a href="ref:post_getoverdraftbalance" target="_blank">Get Overdraft Balance</a> endpoint retrieves information about an overdraft account and its linked primary account. Information returned by this endpoint includes balances, fees, limits, and frozen status. When you call the Get Overdraft Endpoint, pass the PRN or PAN for the primary account through the `accountNo` field.

This table describes the fields returned by the Get Overdraft Balance endpoint.

FieldDescription
`OverdraftAccountNo`The overdraft account number that is linked to the primary account passed through the endpoint.
`Available`The overdraft line of credit that is currently available to the account holder.
`Payback`The amount that the account holder has drawn on the overdraft account.
`PaybackWithPendingFees`The total amount owed by the account holder, including the amount drawn on the overdraft account and fees.
`ActualWithPrimary`The combined balance of the primary account and overdraft account.
`Limit`The amount that the account holder may draw on the overdraft account if nothing is owed. The amount in this field accounts for overdraft fees.
`RawLimit`The total credit set on the overdraft account. The `Limit` field may be less than this amount if there are overdraft fees.
`Frozen`The value `I` in this field indicates that the overdraft account is frozen.

## Events API webhooks for overdraft

This table describes Events API webhooks that are specific to overdraft account activity.

EventTriggerNext step
<a href="ref:api-reference-events-api-overdraft-authorization" target="_blank">`ODAA: overdraft_authorization`</a>An authorization drives the DDA balance negative and the DDA draws on its overdraft account.If the amount drawn on the overdraft account meets or exceeds the _de minimis_ threshold, a fee is applied, or, if configured, the grace period starts.
<a href="ref:api-reference-events-api-overdraft-credit-limit-change" target="_blank">`ODCL: overdraft_credit_limit_change`</a>An overdraft account meets requirements for a credit limit adjustment and the overdraft credit limit is adjusted.The adjusted credit limit is effective immediately.
<a href="ref:api-reference-events-api-overdraft-start-grace-period" target="_blank">`ODGP: overdraft_start_grace_period`</a>A transaction meets or exceeds the overdraft transaction _de minimis_ and a grace-period timer starts.If there is an overdraft fee, the account holder can pay the full amount drawn on the overdraft account and reverse the fee before the grace period ends.
<a href="ref:api-reference-events-api-overdraft-opt-in" target="_blank">`ODIN: overdraft_opt_in`</a>An account becomes eligible to use overdraft or an overdraft account is created.If the overdraft account was created and the account is eligible, the DDA can draw on the overdraft account.
<a href="ref:api-reference-events-api-overdraft-negative-balance" target="_blank">`ODNB: overdraft_negative_balance`</a>A DDA draws on its overdraft account for the first time since the primary account balance was positive.While the primary account remains negative, any later authorizations that draw on the overdraft account trigger the `ODAA: overdraft_authorization` event.
<a href="ref:api-reference-events-api-overdraft-opt-out" target="_blank">`ODOT: overdraft_opt_out`</a>A DDA loses access to the overdraft line of credit.The overdraft account remains closed until a process determines that the account holder is eligible for overdraft.
<a href="ref:api-reference-events-api-overdraft-status-change" target="_blank">`ODSC: overdraft_status_change`</a>An overdraft account status changes.Status changes are applied to the overdraft account. If the account is frozen or suspended, the `ODSK: overdraft_suspended` event is also triggered.
<a href="ref:api-reference-events-api-overdraft-suspended" target="_blank">`ODSK: overdraft_suspended`</a>An overdraft account is suspended or frozen.The overdraft account remains closed until a process determines that the account holder is eligible for overdraft.
<a href="ref:api-reference-events-api-overdraft-limit-change" target="_blank">`ODSN: overdraft_limit_change`</a>An overdraft account became active, usually because it was unfrozen.The primary account can draw on its overdraft account.

## Viewing overdraft accounts in the CST

To view a customer’s overdraft activity In the <<glossary:CST>>:

  1. Go to the **Account** tab, open the **Client Info** section and select the customer’s overdraft product from the dropdown.

  2. Go to the _Overdraft Information_ page located in the **Account Info** section.

The _Overdraft Information_ page contains:

  • Overdraft summary

  • Line of credit

  • Fees

  • Deposit history

  • Opt-in/opt-out status

  • Account configuration