Bank Account Verification Document Requests

Bank account verification requests are a special type of Company Review Document Requests.

Certain companies will be asked to provide documentation to verify ownership of their bank account. Without the Requirements API, you can determine this state by looking for bank accounts with status as disabled_recoverable and disabled_reason as verification_pending. With the Requirements API, when a bank account verification document is required, you will receive a webhook for the creation of a new requirement.

Below is the webhook that you will receive for the creation of the Bank Account Verification requirement. This requirement can be fulfilled by uploading bank statement or bank letter to help prove that the owner has access to the account.

{
	"event": "created",
	"data": {
		"id": "req_123",
		"company": "com_kGYEICK22GEzj8trreH3",
		"requirement": "bank_account_verification",
		"categories": ["company_provided_documents"],
		"status": "not_provided",
		"errors": [],
		"guidance": {
        "document_options": [
            {
                "name": "bank_letter",
                "label": "Bank letter, on bank letterhead, including last four of the account number and account owner’s name",
            },
            {
                "name": "bank_statement",
                "label": "Full bank statement including bank name, account number, and account owner's name and address",
            }
        ],
      	"accepted_file_formats": [
      		"application/pdf",
          "image/jpeg",
          "image/png",
      	]
    }
  }
}

A Bank Account Identity Verification (along with the Bank Account Verification described above) will be requested for bank accounts whose ownership we could not associate to information in Check. The webhook for this requirement is found below. The account_owners field of the guidance data outlines the entities that were found to be owners of the account. An identifying document for any of the entities in account_owners can be uploaded to satisfy this requirement.

{
	"event": "created",
	"data": {
		"id": "req_123",
		"company": "com_kGYEICK22GEzj8trreH3",
		"requirement": "bank_account_identity_verification",
		"categories": ["company_provided_documents"],
		"status": "not_provided",
		"errors": [],
		"guidance": {
        "document_options": [
            {
                "name": "bank_account_owner_id",
                "label": "Non-expired government-issued photo ID for the owner of the bank account or an Articles of Incorporation or similar company registration document if the account is owned by a business",
            },
        ],
      	"accepted_file_formats": [
      		"application/pdf",
          "image/jpeg",
          "image/png",
      	],
        "account_owners": [
          "Scrooge McDuck",
          "McDuck Enterprises",
       	]
    }
  }
}

A document can then be uploaded through the Document Upload API, as described in Uploading Company Provided Documents. Once that document is uploaded, the requirement will transition to a status of pending, issuing a Requirements webhook of event type updated. The bank account will not experience any changes yet.

Once our Risk team has reviewed the document, the requirement will change in one of three ways depending on the results of verifications:

1. The document was accepted as verification for the bank account. The requirement transitions to status completed. The bank account will now have status ownership_verified. For accounts which have both a Bank Account Verification and Bank Account Identity Verification requirement, both requirements must be accepted in order for the bank account status to be moved to ownership_verified.
2. The document uploaded has errors. Documentation is re-requested for the same bank account. The requirement's status will transition to document_rejected and the requirement's errors list will contain more information on what was incorrect. The bank account will not change state.
3. The document shows that this bank account is not owned by the correct entity. In this situation, the requirement's status will be set to not_accepted and the bank account will transition to status disabled_irrecoverable.