Skip to content

[Due for payment 2026-06-17] Add KYB document uploads when checks fail #75707

Closed

Description

@madmax330

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.

Image

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

Issue OwnerCurrent Issue Owner: @gijoe0295

Activity

  1. self-assigned this
    on Nov 20, 2025
  2. MrMuzyk commented on Nov 24, 2025

    @MrMuzyk
    Contributor

    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

  3. madmax330 commented on Nov 25, 2025

    @madmax330
    ContributorAuthor

    Here are the inputs that we need:

    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

  4. madmax330 commented on Nov 25, 2025

    @madmax330
    ContributorAuthor

    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'

  5. MrMuzyk commented on Nov 25, 2025

    @MrMuzyk
    Contributor

    And if something will fail, then we will get what failed in this field or it will be separate field?

  6. MrMuzyk commented on Nov 27, 2025

    @MrMuzyk
    Contributor

    @madmax330 Kind bump and one more question :)

  7. madmax330 commented on Nov 27, 2025

    @madmax330
    ContributorAuthor
    Image

    And these are the different errors:

    Image

    Now I'm not sure if we need all of them, I will check and get back to you on those

  8. MrMuzyk commented on Nov 28, 2025

    @MrMuzyk
    Contributor

    Ok, that helps just a little. Having example response in JSON format would be nice :)

    TINCheck achData.verifcations.externalApiResponses.companyTaxID.status = 'pass'
    LexisNexis achData.verifcations.externalApiResponses.lexisNexisInstantIDResult.status = 'pass'
    Onfido achData.verifcations.externalApiResponses.requestorIdentityID.status = 'pass'

    If any of these status field has different value than 'pass' then we need to gatter KYB files, right?

  9. madmax330 commented on Nov 28, 2025

    @madmax330
    ContributorAuthor

    Here:

    This is the best I have 😄

    Image
  10. madmax330 commented on Nov 28, 2025

    @madmax330
    ContributorAuthor

    If any of these status field has different value than 'pass' then we need to gatter KYB files, right?

    That's correct. Then for the requestorIndentityID if it's not pass we need to check the errors

  11. MrMuzyk commented on Dec 8, 2025

    @MrMuzyk
    Contributor

    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

  12. 50 remaining items

  13. melvin-bot commented on Jun 10, 2026

    @melvin-bot

    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:

    • @MrMuzyk requires payment (Needs manual offer from BZ)
  14. melvin-bot commented on Jun 15, 2026

    @melvin-bot

    @madmax330, @MrMuzyk Eep! 4 days overdue now. Issues have feelings too...

  15. VickyStash commented on Jun 16, 2026

    @VickyStash
    Contributor

    PR was merged and deployed to prod last week!

  16. gijoe0295 commented on Jun 16, 2026

    @gijoe0295
    Contributor

    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?

  17. melvin-bot commented on Jun 16, 2026

    @melvin-bot

    Triggered auto assignment to @mallenexpensify (Awaiting Payment)

  18. melvin-bot commented on Jun 16, 2026

    @melvin-bot

    Payment Summary

    Upwork Job

    • ROLE: @MrMuzyk paid $(AMOUNT) via Upwork (LINK)

    BugZero Checklist (@mallenexpensify)

    • I have verified the correct assignees and roles are listed above and updated the necessary manual offers
    • I have verified that there are no duplicate or incorrect contracts on Upwork for this job (https://www.upwork.com/ab/applicants//hired)
    • I have verified the PR was not reverted
    • I have applied any discounts due to bugs/regressions introduced by this PR
    • I have paid out the Upwork contracts or cancelled the ones that are incorrect
    • I have verified the payment summary above is correct
  19. mallenexpensify commented on Jun 18, 2026

    @mallenexpensify
    Contributor

    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

  20. gijoe0295 commented on Jun 19, 2026

    @gijoe0295
    Contributor

    I left the comment here #75707 (comment) cc @madmax330 again for thoughts

  21. madmax330 commented on Jun 19, 2026

    @madmax330
    ContributorAuthor

    Yeah no need for regression tests 👍🏽

  22. JmillsExpensify commented on Jun 21, 2026

    @JmillsExpensify
    Contributor

    $250 approved for @gijoe0295

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions