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.
`approved`	The bank account details has been successfully verified.	Proceed with accepting the request that required a bank account details verification.
`declined`	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 declined, the status codes can help diagnose the issue. A verification may include multiple reason codes.

STATUS: inconclusive

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

Code	Type	Description
1103	File issue	The file is unreadable or cannot be processed (e.g., unsupported file type or format).
1104	File issue	The image width or height is too small (min WxH=320x256).
1107	File issue	The file contains too many pages.
1200	Image issue	The image is too blurry.
1201	Image issue	The image lacks sufficient contrast.
1202	Image issue	No text was detected in the image.
1203	Image issue	The resolution is too low (character height in pixels is insufficient for proper recognition).
1208	Image issue	The image is improperly framed.
1408	Image issue	The image does not represent bank account details.

STATUS: declined

Code	Type	Description
1501	Document issue	The document type is not accepted.
1502	Suspicious document	The document contains annotations (malicious PDF annotations can be used to hide or modify document content in an invisible manner).
1503	Suspicious document	The document contains signs of tampering (PDF editors can leave invisible artifacts in modified PDF files).
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.
1602	Suspicious document	The IBAN format extracted from the document is incorrect.
1603	Suspicious document	The IBAN was found on a public website.
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.
1611	Consistency issue	The declared first name was not found in the document.
1612	Consistency issue	The declared last name was not found in the document.
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).
1614	Consistency issue	The declared legal entity name was not found in the document.