Verify an External Bank Account

You can verify the details for an external bank Financial Account, such as the account number and routing number. Verifying the account ensures this information is valid and correct, reducing the risk of failed transactions.

You can verify external bank Financial Accounts that meet the following criteria:

state is ACTIVE
category is EXTERNAL
type is BANK
subtype is CHECKING

The account will be verified using an ACH prenote. This is an automated process that sends a $0 test transaction to the financial institution. The verification process takes approximately three days to complete.

Note External bank Financial Accounts that belong to a Customer must be verified before the Financial Account can be used in as the debit Financial Account in an ACH request transaction.

Endpoint

POST /v1/financial-accounts:verify

Authorization Header

Authorization: Bearer <access_token>

Request Body

method REQUIRED

string enum, values: PRENOTE

Method used to verify the bank account. Value must be PRENOTE.

financialAccountIds REQUIRED

array of strings (UUIDs)

List of Financial Account IDs to verify. These accounts must belong to the Business Account associated with the request access token.

Returns

Returns an array of Financial Account Verification objects. This object contains the Financial Account ID and verification status.

SAMPLE REQUEST

				
					{
  "method": "PRENOTE",
  "financialAccountIds": [
    "8ca5ca8c-1332-405a-aaf2-096077b5f087",
    "5f3fa985-d400-4daa-877f-8705c7ac4819"
  ]
}

SAMPLE RESPONSE

				
					{
  "method": "PRENOTE",
  "financialAccountIds": [
    {
      "financialAccountId": "8ca5ca8c-1332-405a-aaf2-096077b5f087",
      "status": "PENDING"
    },
    {
      "financialAccountId": "5f3fa985-d400-4daa-877f-8705c7ac4819",
      "status": "APPROVED"
    }
  ]
}