You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[Due for payment 2026-06-17] Add KYB document uploads when checks fail #75707
When automated checks fail when a user is attempting to add a business bank account, we need to collect documents from them to verify that it is indeed their bank account and they are who they say they are.
Right now we collect all the documents through concierge, but we want users to be able to upload the documents themselves based on the failed checks to eliminate back and forth
We need to update the bank account flow such that when we make the call to create the bank account, if the response if that some checks failed (the bank account is not OPEN) then we need to go to the upload documents screen as shown below.
If the checks succeed then we keep the same flow.
We're basically conditionally adding a last step to the bank account flow.
These are the documents that we collect for each type of failure:
TINCheck:
IRS TIN/EIN Assignment Letter
IRS TIN/EIN Application confirmation (Normally states “Congratulations! The EIN has been successfully assigned”)
IRS tax exemption letter that lists your company name and EIN
Name Change Document (in addition to one of the above), if your company’s name has changed since filing for the TIN/EIN
LexisNexis Company Address (must be a physical address - no MailDrop):
Recent utility bill showing company name and address
Bank Statement showing company name and address
Current Lease/Rental Agreement including the signature page showing your company name and current address
Insurance Statement showing company name and address
TIN assignment doc showing company name and address
Business tax return (most current) showing company name and address
IDology :
This one is a bit trickier. The doc needed depends on the error IDology returns.
For Requestor we recently stopped asking for a doc if the error pertains to their address or DOB - if they uploaded a DL in Onfido since this can likely resolve the issue.
But for Beneficial Owners and all other Requestor fails:
Address - Voter Registration Card, Drivers License, Bank Statement, Utility Bill
DOB - US Issued ID
SSN - We shouldn’t ask them for this, flag for Ops review incase we don’t need it since it’s sensitive.
FAIL ID NOT LOCATED - All of the above
All the checks data are located in the achData of the bank account under verifications
Input 1:
Filename: companyTaxID
Title "Tax ID Verification"
Help:
Please upload one of the following files:
IRS TIN/EIN Assignment Letter
IRS TIN/EIN Application confirmation (Normally states “Congratulations! The EIN has been successfully assigned”)
IRS tax exemption letter that lists your company name and EIN
Input 2:
Filename: nameChangeDocument
Title "Name Change Document"
Help: If your company’s name has changed since filing for the TIN/EIN we need this document to verify the Tax ID number you provided
Input 3:
Filename: companyAddressVerification
Title "Company Address verfication"
Help:
Please upload one of the following files:
Recent utility bill showing company name and address
Bank Statement showing company name and address
Current Lease/Rental Agreement including the signature page showing your company name and current address
Insurance Statement showing company name and address
TIN assignment doc showing company name and address
Business tax return (most current) showing company name and address
Input 4:
Filename: userAddressVerification
Title "Address verification"
Help:
Please upload one of the following files:
Voter Registration Card
Drivers License
Bank Statement
Utility Bill
Input 5:
Filename: userDOBVerification
Title: "Date of Birth Verification"
Help: Please upload a US issued ID
The solution for this issue has been 🚀 deployed to production 🚀 in version 9.4.1-6 and is now subject to a 7-day regression period 📆. Here is the list of pull requests that resolve this issue:
No checklist is needed because this is a new feature, it can't be tested on staging plus there's no consistently reproducible steps. How we tested was using a mock bank account with errors prefilled. cc @madmax330 Would you add the regression test yourself later because this seems to be part of a project?
Activity
MrMuzyk commentedon Nov 24, 2025
Hey @madmax330, you can assign me to it and I'll start soon :)
If any questions arise I'll probably bring them up on slack in a fresh thread
madmax330 commentedon Nov 25, 2025
Here are the inputs that we need:
Input 1:
Filename: companyTaxID
Title "Tax ID Verification"
Help:
Please upload one of the following files:
Input 2:
Filename: nameChangeDocument
Title "Name Change Document"
Help: If your company’s name has changed since filing for the TIN/EIN we need this document to verify the Tax ID number you provided
Input 3:
Filename: companyAddressVerification
Title "Company Address verfication"
Help:
Please upload one of the following files:
Input 4:
Filename: userAddressVerification
Title "Address verification"
Help:
Please upload one of the following files:
Input 5:
Filename: userDOBVerification
Title: "Date of Birth Verification"
Help: Please upload a US issued ID
madmax330 commentedon Nov 25, 2025
For the achData we will find the results for each under the following keys:
TINCheck
achData.verifcations.externalApiResponses.companyTaxID.status= 'pass'LexisNexis
achData.verifcations.externalApiResponses.lexisNexisInstantIDResult.status= 'pass'Onfido
achData.verifcations.externalApiResponses.requestorIdentityID.status= 'pass'MrMuzyk commentedon Nov 25, 2025
And if something will fail, then we will get what failed in this field or it will be separate field?
MrMuzyk commentedon Nov 27, 2025
@madmax330 Kind bump and one more question :)
madmax330 commentedon Nov 27, 2025
And these are the different errors:
Now I'm not sure if we need all of them, I will check and get back to you on those
MrMuzyk commentedon Nov 28, 2025
Ok, that helps just a little. Having example response in JSON format would be nice :)
If any of these status field has different value than 'pass' then we need to gatter KYB files, right?
madmax330 commentedon Nov 28, 2025
Here:
This is the best I have 😄
madmax330 commentedon Nov 28, 2025
That's correct. Then for the
requestorIndentityIDif it's not pass we need to check the errorsMrMuzyk commentedon Dec 8, 2025
I will get back to it tomorrow most likely. We don't have fully ready BE so I was tending to other work I have in progress in the meantime
50 remaining items
melvin-bot commentedon Jun 10, 2026
The solution for this issue has been 🚀 deployed to production 🚀 in version 9.4.1-6 and is now subject to a 7-day regression period 📆. Here is the list of pull requests that resolve this issue:
If no regressions arise, payment will be issued on 2026-06-17. 🎊
For reference, here are some details about the assignees on this issue:
melvin-bot commentedon Jun 15, 2026
@madmax330, @MrMuzyk Eep! 4 days overdue now. Issues have feelings too...
VickyStash commentedon Jun 16, 2026
PR was merged and deployed to prod last week!
gijoe0295 commentedon Jun 16, 2026
No checklist is needed because this is a new feature, it can't be tested on staging plus there's no consistently reproducible steps. How we tested was using a mock bank account with errors prefilled. cc @madmax330 Would you add the regression test yourself later because this seems to be part of a project?
melvin-bot commentedon Jun 16, 2026
Triggered auto assignment to @mallenexpensify (
Awaiting Payment)melvin-bot commentedon Jun 16, 2026
Payment Summary
Upwork Job
BugZero Checklist (@mallenexpensify)
mallenexpensify commentedon Jun 18, 2026
Payment Summary
Contributor+: @gijoe0295 due $250 via NewDot
@gijoe0295 , looks like you reviewed the PR, plz complete the BZ checklist and tag me in a post once you have. Thx
gijoe0295 commentedon Jun 19, 2026
I left the comment here #75707 (comment) cc @madmax330 again for thoughts
madmax330 commentedon Jun 19, 2026
Yeah no need for regression tests 👍🏽
JmillsExpensify commentedon Jun 21, 2026
$250 approved for @gijoe0295