Home / Guides/ Onboard Accounts
In some cases, an Application may be flagged for manual review because additional verification information is needed from the Account Holder to confirm the identity of the Person or Business and comply with Know-Your-Customer (KYC) or Know-Your-Business (KYB) regulations.
If your customer’s Application enters IN_REVIEW
, you may need to collect additional documentation to complete the process. An Application with a status of IN_REVIEW
will contain details on the need for additional verification. If documents are required, you can use the Highnote API to generate upload URLs and allow customers to provide documents from your UI. If an application is IN_REVIEW
but does not require identity documents, you can simply notify your customer that their application is under review.
Once your Account Holder has uploaded their verification documents, a Highnote agent will review the documents and take the following actions:
Documents must not be expired and supporting documents must be dated within 60 days. If the document appears forged, is outdated, and/or is otherwise invalid, the Application will be DENIED
.
Depending on the response, the Account Holder must provide one of relevant document(s) listed below. When there are multiple response codes, the Account Holder may need to provide multiple documents.
Response | Document Required |
---|---|
ADDRESS_MISMATCH | Valid Driver’s License |
Utility Bill (water bill, gas bill, or light bill dated within 60 days) | |
Current Lease Agreement | |
Any document must have the current address listed. | |
DOB_MISMATCH | Birth Certificate |
Valid Driver’s License | |
Valid Country Issued Passport | |
NAME_MISMATCH | Valid Driver’s License |
Valid Country Issued Passport | |
Utility Bill (dated within 60 days) | |
Pay Stub (dated within 60 days) | |
SSN_MISMATCH | SSN card |
Taxpayer Identification (TIN) | |
PHONE_MISMATCH | Recent Phone Bill (dated within 60 days) |
Depending on the response, the Account Holder must provide one of relevant document(s) listed below. When there are multiple response codes, the Account Holder may need to provide multiple documents.
Response | Document Required |
---|---|
ADDRESS_MISMATCH | Business Registration |
Business Operating Agreement | |
Articles of Incorporation/Organization | |
Tax Registration Document | |
Certificate of Formation | |
Lease Agreement | |
Business License Application with exact business name | |
Utility Bill (water bill, gas bill, or light bill dated within 60 days) | |
Any document must have the current address and should be related to legal entity address that's registered with the Federal Government. | |
BUSINESS_NAME_MISMATCH | SS4 or EIN Letter 147c |
Business Articles Of Incorporation/Organization | |
Business Operating Agreement | |
Business License | |
Certificate of Formation | |
FEIN_MISMATCH | SS4 document |
EIN Letter 147c | |
REPRESENTATIVE_MISMATCH | Articles of Incorporation/Organization |
Tax Registration Document | |
Business Operating Agreement | |
Business License | |
Business Registration |
For Sole Proprietors, given an FEIN document may not available, only one of the following documents would need to be uploaded:
In the case an Application has been flagged for manual review and verification documents are required, you can use the Highnote API to generate upload URLs and allow customers to provide documents from your UI.
One or more documents may be required based on the type of documentation they are providing.
A document upload session expires 30 days from creation. If the Account Holder does not provide the required documentation within 30 days, the application will be DENIED
.
To begin the process of uploading your user’s documents to Highnote’s secure document store, use the startDocumentUploadSession
. A session allows you to upload multiple documents within a given time frame.
A session will also indicate to you any requirements that may need to be enforced by your system when uploading the file.
Note: To make requests direct from your client, you will first need to generate a Client Token.
Document upload links expire 5 minutes after creation.
Create a secure upload link for each file the applicant wishes to upload to Highnote’s secure document store. Each link represents a single file to be uploaded. The response contains a field called documentUploadSecureLink
which you can use to stream the file upload.
Type | File Formats Accepted |
---|---|
Image | .jpg , .png , .pdf |
Once your user has confirmed that they have uploaded all required documents, call endDocumentUploadSession
to end the session. When a session is ended, the status of the session will be reflected as SUBMITTED
. A Highnote agent will review the provided documents and decision the application once the status of the session is SUBMITTED
.
Note: No other actions can be taken against this session once the status is reflected as SUBMITTED
. If it is determined that more documentation is required, a new session must be started to upload the additional documents.
Highnote will not return a public link to access the content of the documents to best protect the Account Holder's privacy.
You can check the requiredDocuments
status on the application to see if the document upload was completed by the applicant.
You can check the uploadedDocuments
field on the requiredDocuments
for the document types that were uploaded by the applicant.
Once verification documents have been uploaded, you can query for the status.
Verification documents are reviewed by a Highnote agent. You can query for the review status.
The Test Environment does not run KYB (Know Your Business) and KYC (Know Your Customer) checks on Applications. When testing, you can simulate Application failure under a variety of scenarios by creating Account Holders with specific attribute values. The simulation will produce Tags associated with the application decision and provide information as to why an Application outcome was APPROVED
, IN_REVIEW
, or DENIED
.
For KYC, regulation requires that we collect the person’s name, address, date of birth, and identification number (e.g. SSN). For KYB, regulation requires that we collect a Business' EIN / FEIN, the Business name, Business address, and identifying information of any Ultimate Beneficial Owners (UBOs).
Note: All values, except failure values, will trigger the attributes associated with Pass Tags.
The following fields and associated values will simulate DENIED
and IN_REVIEW
application states.
Field | Value | Tag | Application Status |
---|---|---|---|
FIRST NAME | FORCE-DECLINE | NAME_MISMATCH | DENIED |
ADDRESS LINE 1 | 123 Manual Review St. | ADDRESS_MISMATCH | IN_REVIEW |
The following fields and associated values will simulate various tags associated with the application decision.
Field | Failure Value | Failure Tag | Pass Tag |
---|---|---|---|
FIRST NAME | DECLINE | NAME_MISMATCH | NAME_MATCH |
FIRST NAME | IN-REVIEW | WATCHLIST_HIT | NAME_MATCH |
DATE OF BIRTH | 1900-12-12 | DOB_MISMATCH | DOB_MATCH |
ADDRESS LINE 1 | 123 Decline St. | ADDRESS_MISMATCH | ADDRESS_MATCH |
ADDRESS POSTAL CODE | 66666 or 11111 | ADDRESS_MISMATCH | ADDRESS_MATCH |
PHONE NUMBER | 6666666666 | PHONE_MISMATCH | PHONE_MATCH |
SSN | 666-66-6666 or 111-11-1111 or 111-11-1211 | SSN_MISMATCH | SSN_MATCH |
The following fields and associated values will simulate DENIED
and IN_REVIEW
application states.
Field | Value | Tag | Application Status |
---|---|---|---|
BUSINESS LEGAL NAME | FORCE-DECLINE | BUSINESS_NAME_MISMATCH | DENIED |
BUSINESS ADDRESS LINE 1 | 123 Manual Review St. | ADDRESS_MISMATCH | IN_REVIEW |
The following fields and associated values will simulate various tags associated with the application decision.
Field | Failure Value | Failure Tag | Pass Tag |
---|---|---|---|
BUSINESS LEGAL NAME | DECLINE | BUSINESS_NAME_MISMATCH | BUSINESS_NAME_MATCH |
BUSINESS ADDRESS LINE 1 | 123 Decline St. | ADDRESS_MISMATCH | ADDRESS_MATCH |
BUSINESS ADDRESS POSTAL CODE | 66666 or 11111 | ADDRESS_MISMATCH | ADDRESS_MATCH |
EMPLOYER IDENTIFICATION NUMBER | 66-6666666 or 11-1111111 or 11-1111211 | FEIN_MISMATCH | FEIN_MATCH |
AUTHORIZED PERSON FIRST NAME | MISMATCH | REPRESENTATIVE_MISMATCH | REPRESENTATIVE_MATCH |
PRIMARY AUTHORIZED PERSON FIRST & GIVEN NAME | IN-REVIEW | WATCHLIST_HIT | NAME_MATCH |
Business Verification Score | Passing 3 or more of the failure values above | BUSINESS_VERIFICATION_SCORE_FAILED | BUSINESS_VERIFICATION_SCORE_PASSED |
Please see Identity Verification Overview for more information on customer identity programs, application outcomes, and onboarding tags.
Once an Application for a Person Account Holder, Primary Authorized Person, Ultimate Beneficial Business Owner (UBO) or Business has entered Manual Review with a status of IN_REVIEW
, you can begin a document upload session to simulate adding supporting documents:
Once you've closed the document upload session, you can simulate the outcome of the Document Review as if each document was reviewed by a Highnote Agent by assigning a new status of APPROVED
or DENIED
.
In some cases, the document(s) provided by the Account Holder may be insufficient to approve the application. If the Account Holder needs to upload additional documents after documents were previously submitted, a new document upload session will be created for the Account Holder to upload a new document type(s).
In the Test Environment, you can simulate requesting a second document upload session for an application. The request input will need to include specific document types.
Once the request is simulated, the status of the application will be DOCUMENT_UPLOAD_REQUIRED
. Multiple applicants under the same application can be selected and multiple document types can be requested for each applicant.
A second upload session will trigger the CARD_PRODUCT_APPLICATION_DOCUMENT_UPLOAD_REQUESTED
notification event. The event allows you to create a unique communication template to your Account Holders when documents are requested a second time for their application versus the first time documents are requested.
Once you've uploaded supporting documents for an Identity and simulated a review of each document, you can simulate the outcome of Identity Verification as if reviewed by a Highnote Agent. This will transition the Identity Verification from a status of IN_REVIEW
to PASSED
, DENIED
or DOCUMENT_UPLOAD_REQUIRED
if you want to test your flow for requiring additional documents.
You may also simulate the outcome of an entire Application without the document upload or identity verification steps and transition the Application's status from IN_REVIEW
directly to APPROVED
or DENIED
.