Verification statuses

The bank account verification lifecycle is really simple and consists of the following stages:

Status	Description	Recommended action
`pending`	The bank account verification has been initiated.	Wait for the `status` to change.
`inconclusive`	The verification could not be completed (e.g., the file was too small or the image was too blurry). For more details, refer to the status codes section below.	Request a new file from your user, then initiate a new bank account verification.
`verified`	The bank account details has been successfully verified.	Proceed with accepting the request that required a bank account details verification.
`failed`	The bank account verification failed due to certain issues. For more details, refer to the status codes section below.	Reject the request that required a bank account verification. If needed, initiate a new bank account verification.

Status codes

If the verification is inconclusive or failed, the status codes can help diagnose the issue. A verification may include multiple reason codes.

STATUS: inconclusive

ℹ️
Unlike verified or failed statuses, an inconclusive verification does not incur a charge to the client.

Code	Type	Description
BAV_1103	File issue	The file is unreadable or cannot be processed (e.g., unsupported file type or format).
BAV_1104	File issue	The image width or height is too small (min WxH=320x256).
BAV_1107	File issue	The file contains too many pages.
BAV_1200	Image issue	The image is too blurry.
BAV_1201	Image issue	The image lacks sufficient contrast.
BAV_1202	Image issue	No text was detected in the image.
BAV_1203	Image issue	The resolution is too low (character height in pixels is insufficient for proper recognition).
BAV_1208	Image issue	The image is improperly framed.
BAV_1408	Image issue	The image does not represent bank account details.

STATUS: failed

Code	Type	Description
BAV_1501	Document issue	The document type is not accepted.
BAV_1502	Suspicious document	The document contains annotations (malicious PDF annotations can be used to hide or modify document content in an invisible manner).
BAV_1503	Suspicious document	The document contains signs of tampering (PDF editors can leave invisible artifacts in modified PDF files).
BAV_1601	Consistency issue	The declared IBAN was not found in the document or the IBAN found on the document is not consistent with the extracted BIC.
BAV_1602	Suspicious document	The IBAN format extracted from the document is incorrect.
BAV_1603	Suspicious document	The IBAN was found on a public website.
BAV_1604	Consistency issue	The declared BIC was not found in the document or the BIC found on the document is not consistent with the extracted IBAN.
BAV_1611	Consistency issue	The declared first name was not found in the document.
BAV_1612	Consistency issue	The declared last name was not found in the document.
BAV_1613	Consistency issue	The declared first name initial(s) were not found in the document (control skipped if the full first name was found instead).
BAV_1614	Consistency issue	The declared legal entity name was not found in the document.