How overdraft works

Overdraft is a financial service that allows you to continue making transactions even if there are insufficient funds in your account. This feature provides a safety net for individuals and businesses, ensuring that essential payments and purchases can still be made despite temporary shortfalls in available funds. By permitting your transactions to proceed when funds are insufficient, overdraft helps mitigate the potential disruptions and financial stress that might otherwise occur.

Pismo's overdraft service enables your account to access a predetermined amount (the account overdraft limit) authorized by the financial institution to cover for insufficient funds. Interest is typically calculated on the negative balance, and fees can be applied based on how long the account remains overdrawn.

How to set up overdraft

Setting up overdraft involves these steps.

  1. Set overdraft limit
  2. Create interest plan
  3. Create overdraft product
  4. Attach overdraft product to account

Step 1: Set overdraft limit

Set your account overdraft limit by executing the Update account limits endpoint with the total_overdraft_limit field set to the value of the limit.

This ensures that the account has a predefined limit that can be used for overdraft transactions.

Step 2: Create interest plan

Use the Create interest plan endpoint to define how interest is calculated on an overdraft amount.

Step 3: Create overdraft product

Use the Create overdraft product endpoint to create an overdraft product. If the product is successfully created, the endpoint returns a 201 response, and an event is generated which contains the parameters of the new product.

Step 4: Attach overdraft product to account

Link the created overdraft product to an account using the Attach product to account endpoint.

When the linking is successful, a 2xx response is returned. If an error occurs, a 4xx error is returned with the reason for the error.

Detach overdraft product from account

To unlink an overdraft product from an account, use the Detach product from account endpoint.

Attach overdraft product to program

You can attach your overdraft product to a program using the Attach product to program endpoint. Make sure to include the relevant program and product IDs in your request.

Check detach status

Pismo detaches the overdraft product from your account upon receiving your request, you can check the detach status by calling Get limit config by account, and make sure that the response returns over_limit = enable: false.

Sample response
{
  "over_limit": {
    "enable": false
  }
}

Additional endpoints

These endpoints are also available for managing overdraft.

DescriptionEndpoint
Get account attachmentGet the overdraft product linked to the account ID
List productList all overdraft products created by organization
Get overdraft productGet specific product by product ID