Usage Info

The Bank Account entity stores essential banking details including routing information, account numbers, and account types. These entities can be linked to a Business entity. Use this method to modify financial information during application processes or when updating payment information for existing relationships.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

Parameter	Type	Required	Description
bank_account_id	string	Yes	The identifier of Bank Account entity to modify details for.
bank_account	object	No	The bank account parameter is defined in the table below.

Bank Account Parameters

Parameter	Type	Required	Nullable	Description
bank_account_ownership_type	string	No	Yes	The type of ownership of the bank account. Must be one of the BANK_ACCOUNT_OWNERSHIP_TYPES .
bank_account_type	string	No	Yes	The type of bank account. Must be one of the BANK_ACCOUNT_TYPES .
bank_routing_number	string	No	No	The routing number that identifies the bank where the account is. This field must be 9 characters long and only contain digits [0-9]. The last digit is a check digit and must pass validation according to the ABA routing number validation algorithm. For details on the check digit calculation, please refer to: https://en.wikipedia.org/wiki/ABA_routing_transit_number#Check_digit
bank_account_number	string	No	No	The account number for the bank account. This field must only contain digits [0-9].
bank_name	string	No	Yes	The name of the bank. Note: Some workflows, such as the Business-Application-type workflow, will override this value by using the bank_routing_number to find the publicly available bank name.

Note:

Nullable parameter unsets the value.
Nullable Parameters of type array removes all the items from the parameter.
Empty array for a parameter removes all the items

Example

{
  "bank_account_id": "ba_57WfSCnafMnxDiWMKcy3EW",
  "bank_account": {
    "bank_account_ownership_type": "BUSINESS",
    "bank_account_type": "CHECKING",
    "bank_routing_number": "021000021",
    "bank_account_number": "1234567890123",
    "bank_name": "Chase Bank"
  }
}

Response

Data

An empty data object is returned when the completion is successful.

Example

{
  "meta": {
    "status": "SUCCESS",
    "trace_id": "trc_6zNzQZHSf26V83BO3uW6dS",
    "version": "2025-03-24"
  },
  "data": {}
}

Errors

Error Code	HTTP Code	Possible Cause
BAD_REQUEST	400	Required parameters not provided. Invalid values provided. Enum value provided does not correspond to an available type.
ENTITY_NOT_FOUND	400	The `bank_account_id` provided does not exist.