Skip to content

QuickBooks: Void or refund an e Check — request body — body bank Account

Void or refund an eCheck: request body, field body / bankAccount. Complete fields and constraints for contract 2026-10-20.

API reference · Contract 2026-10-20

SDK schema: Void or refund an e Check — request body — body bank Account

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
accountNumberstringRequired within parentThe number of the bank account. For privacy and security, Account numbers that are 6 digits or less: all but the last 2 digits are masked Account numbers that are 7 digits or longer: all but the last 4 digits are masked Account Number masking changes are available in Sandbox companies currently and will be available from July 11th, 2022 for Production companies.
accountTypestringRequired within parentThe type of bank account. Valid values: PERSONAL_CHECKING : Use for personal checking accounts. PERSONAL_SAVINGS : Use for personal savings accounts. BUSINESS_CHECKING : Use for business checking accounts. BUSINESS_SAVINGS : Use for business savings accounts.
bankCodestringOptionalFor US : This should also be the routing number for the bank associated with the account.
countrystringOptionalThe ISO-standard country code. Refer to the ISO Country Code List .
Maximum length: 2
createdstringOptionalThe time the object was originally created. In ISO 8601 date-time format. It appears as YYYY-MM-DDTHH:MM:SSZ .
Read only: true
defaultJSONOptionalIndicates if the bank account is the default. When users set a default, the account flag is true . This is the bank account QuickBooks uses when another isn’t specified. The flag defaults to false . When a bank account flag is true , all other stored bank accounts are automatically set to false .
default (anyOf 1)booleanAlternative
default (anyOf 2)stringAlternativeOne of: true, false
idstringOptionalThe unique identifier of a bank account object. The id is required for update or delete operations.
Conditionally required
inputTypestringOptionalSpecifies the input type. Valid values: KEYED : Indicates a manually-entered key. SCANNED
namestringRequired within parentThe name of the bank account owner.
Maximum length: 64
phonestringRequired within parentThe phone number associated with the bank account.
routingNumberstringRequired within parentThe routing number for the bank associated with the account. For privacy and security, we only display the last four digits of the routing number.
updatedstringOptionalThe time the object was last updated. In ISO 8601 date-time format. It appears as YYYY-MM-DDTHH:MM:SSZ .
Conditionally required
Read only: true
entityIdstringOptionalThe ID of the entity the bank account is associated with.
entityTypestringOptionalThe entity or user type the bank account is associated with. Example values: Customer , Employee , Vendor or Company

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.