[HOLD 91300] Support Validation_Failed bank account

src/CONST/index.ts

@@ -755,6 +755,7 @@ const CONST = {
             OPEN: 'OPEN',
             DELETED: 'DELETED',
             LOCKED: 'LOCKED',
+            VALIDATION_FAILED: 'VALIDATION_FAILED',
         },
         MAX_LENGTH: {
             FULL_SSN: 9,
@@ -792,6 +793,10 @@ const CONST = {
                 'resultcode.ssn.issued.prior.to.dob',
             ],
         },
+        NOC_CODE: {
+            INSUFFICIENT_FUNDS: ['R01', 'R09'] as string[],
+            DEBIT_BLOCKED: ['R05', 'R06', 'R07', 'R08', 'R10', 'R11', 'R16', 'R23', 'R29'] as string[],
+        },
     },
     CORPAY_DOCUMENT: {
         ALLOWED_FILE_TYPES: ['pdf', 'jpg', 'jpeg', 'png'],
@@ -954,6 +959,7 @@ const CONST = {
             OPEN: 'OPEN',
             DELETED: 'DELETED',
             LOCKED: 'LOCKED',
+            VALIDATION_FAILED: 'VALIDATION_FAILED',
         },
     },
     ENABLE_GLOBAL_REIMBURSEMENTS: {

src/ROUTES.ts

@@ -161,6 +161,19 @@ const DYNAMIC_ROUTES = {
         getRoute: (shouldSkipPurposeSelection?: boolean) => `add-bank-account/verify-account${shouldSkipPurposeSelection ? '?shouldSkipPurposeSelection=true' : ''}` as const,
         queryParams: ['shouldSkipPurposeSelection'],
     },
+    FIX_BANK_ACCOUNT: {
+        path: 'fix-bank-account/:bankAccountID',
+        entryScreens: [
+            SCREENS.SETTINGS.WALLET.ROOT,
+            SCREENS.WORKSPACE.WORKFLOWS,
+            SCREENS.RIGHT_MODAL.SEARCH_REPORT,
+            SCREENS.RIGHT_MODAL.EXPENSE_REPORT,
+            SCREENS.RIGHT_MODAL.SEARCH_MONEY_REQUEST_REPORT,
+            SCREENS.REPORT,
+            SCREENS.SEARCH.ROOT,
+        ],
+        getRoute: (bankAccountID: string) => `fix-bank-account/${bankAccountID}` as const,
+    },
     BANK_ACCOUNT_VERIFY_ACCOUNT: {
         path: 'verify-bank-account',
         entryScreens: [SCREENS.REIMBURSEMENT_ACCOUNT],

src/SCREENS.ts

@@ -92,6 +92,7 @@ const SCREENS = {
         HELP: 'Settings_Help',
         DYNAMIC_VERIFY_ACCOUNT: 'Dynamic_Verify_Account',
         DYNAMIC_ADD_BANK_ACCOUNT_VERIFY_ACCOUNT: 'Dynamic_Add_Bank_Account_Verify_Account',
+        DYNAMIC_FIX_BANK_ACCOUNT: 'Dynamic_Fix_Bank_Account',
         DYNAMIC_EXIT_SURVEY_CONFIRM: 'Dynamic_ExitSurvey_Confirm',
         DYNAMIC_EXIT_SURVEY_REASON: 'Dynamic_ExitSurvey_Reason',
         DYNAMIC_KEYBOARD_SHORTCUTS: 'Dynamic_Keyboard_Shortcuts',

src/components/Icon/chunks/illustrations.chunk.ts

@@ -41,6 +41,7 @@ import Hand from '@assets/images/hand.svg';
 import LaptopWithMembers from '@assets/images/illustration-laptop-members.svg';
 import LaptopOnDeskWithCoffeeAndKey from '@assets/images/laptop-on-desk-with-coffee-and-key.svg';
 import LaptopWithSecondScreenAndHourglass from '@assets/images/laptop-with-second-screen-and-hourglass.svg';
+import LaptopWithSecondScreenBank from '@assets/images/laptop-with-second-screen-bank.svg';
 import LaptopWithSecondScreenSync from '@assets/images/laptop-with-second-screen-sync.svg';
 import LaptopWithSecondScreenX from '@assets/images/laptop-with-second-screen-x.svg';
 // Multifactor Authentication Illustrations
@@ -99,6 +100,7 @@ import ValidateCode from '@assets/images/product-illustrations/validate-code.svg
 import WorkspaceScene from '@assets/images/product-illustrations/workspace-scene.svg';
 import ReceiptStack from '@assets/images/receipt-upload.svg';
 import RunningTurtle from '@assets/images/running-turtle.svg';
+import ScissorsCuttingMoney from '@assets/images/scissors-cutting-money.svg';
 import Shutter from '@assets/images/shutter.svg';
 // Simple Illustrations - Bucket 3 (Common)
 import Puzzle from '@assets/images/simple-illustrations/emptystate__puzzlepieces.svg';
@@ -264,6 +266,7 @@ const Illustrations = {
     Computer,
     ExpensifyCardImage,
     LaptopWithSecondScreenAndHourglass,
+    LaptopWithSecondScreenBank,
     LaptopWithSecondScreenSync,
     LaptopWithSecondScreenX,
     LaptopOnDeskWithCoffeeAndKey,
@@ -329,6 +332,7 @@ const Illustrations = {
     ReceiptStack,
     RunningTurtle,
     Shutter,
+    ScissorsCuttingMoney,
     TravelCVV,
     TurtleInShell,
 

src/components/SettlementButton/index.tsx

@@ -26,7 +26,8 @@ import useVerifyAccountAndResume from '@hooks/useVerifyAccountAndResume';
 import {createWorkspace, generateDefaultWorkspaceName, isCurrencySupportedForDirectReimbursement, isCurrencySupportedForGlobalReimbursement} from '@libs/actions/Policy/Policy';
 import {navigateToBankAccountRoute} from '@libs/actions/ReimbursementAccount';
 import {getLastPolicyBankAccountID, getLastPolicyPaymentMethod} from '@libs/actions/Search';
-import {isBankAccountPartiallySetup} from '@libs/BankAccountUtils';
+import {getBankAccountConnectionStatus, isBankAccountPartiallySetup} from '@libs/BankAccountUtils';
+import createDynamicRoute from '@libs/Navigation/helpers/dynamicRoutesUtils/createDynamicRoute';
 import Navigation from '@libs/Navigation/Navigation';
 import {isTrackOnboardingChoice} from '@libs/OnboardingUtils';
 import {formatPaymentMethods, getActivePaymentType, getBusinessBankAccountOptions, matchesCurrency} from '@libs/PaymentUtils';
@@ -51,7 +52,7 @@ import {navigateToConciergeChat} from '@userActions/Report';
 
 import CONST from '@src/CONST';
 import ONYXKEYS from '@src/ONYXKEYS';
-import ROUTES from '@src/ROUTES';
+import ROUTES, {DYNAMIC_ROUTES} from '@src/ROUTES';
 import type {AccountData, BankAccount, LastPaymentMethodType, Policy} from '@src/types/onyx';
 import type {PaymentMethodType} from '@src/types/onyx/OriginalMessage';
 import {isEmptyObject} from '@src/types/utils/EmptyObject';
@@ -195,6 +196,7 @@ function SettlementButton({
     const shouldShowPayWithExpensifyOption = !shouldHidePaymentOptions;
     const shouldShowPayElsewhereOption = !shouldHidePaymentOptions && !isInvoiceReport;
     const isBankAccountLocked = policy?.achAccount?.state === CONST.BANK_ACCOUNT.STATE.LOCKED;
+    const isBankAccountValidationFailed = policy?.achAccount?.state === CONST.BANK_ACCOUNT.STATE.VALIDATION_FAILED;
 
     function getLatestPersonalBankAccount() {
         return formattedPaymentMethods.filter((ba) => (ba.accountData as AccountData)?.type === CONST.BANK_ACCOUNT.TYPE.PERSONAL);
@@ -203,6 +205,14 @@ function SettlementButton({
     // The guards checked after the account-validation gate. Also re-checked when a payment
     // interrupted by account validation resumes, since the validation gate skipped them.
     const checkForPostValidationBlockers = () => {
+        if (isBankAccountValidationFailed && policy?.achAccount?.bankAccountID) {
+            const bankConnectionStatus = getBankAccountConnectionStatus(bankAccountList?.[policy.achAccount.bankAccountID]?.accountData);
+            if (bankConnectionStatus?.requiresFixHandler) {
+                Navigation.navigate(createDynamicRoute(DYNAMIC_ROUTES.FIX_BANK_ACCOUNT.getRoute(policy.achAccount.bankAccountID.toString())));
+                return true;
+            }
+        }
+
         if (isBankAccountLocked) {
             showConfirmModal({
                 title: translate('bankAccount.lockedBankAccount'),

src/languages/de.ts

@@ -2602,6 +2602,19 @@ const translations: TranslationDeepObject<typeof en> = {
             confirmTestTransactions: 'Bitte bestätigen Sie Testtransaktionen',
             accountRequiresAttention: 'Dieses Konto erfordert Ihre Aufmerksamkeit',
             unlock: 'Entsperren',
+            debitBlocked: 'Ihre Bank hat Testtransaktionen auf dieses Konto blockiert',
+            insufficientFunds: 'Testtransaktionen sind aufgrund unzureichender Deckung fehlgeschlagen',
+            validationFailedFallback: 'Ihre Bank hat Testtransaktionen auf dieses Konto blockiert. <concierge-link>Kontaktieren Sie Concierge</concierge-link>',
+        },
+        fixBankAccount: {
+            title: 'Bankkonto beheben',
+            debitBlockedBody:
+                'Ihre Bank hat die Testtransaktionen auf dieses Konto blockiert.<br/><br/>Bitte lassen Sie die folgenden ACH-IDs von Expensify auf die Whitelist setzen:<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>Senden Sie anschließend die unten stehenden Testtransaktionen erneut.',
+            insufficientFundsBody: 'Testtransaktionen sind aufgrund unzureichender Deckung fehlgeschlagen. Sobald wieder Geld verfügbar ist, verwenden Sie die Schaltfläche unten.',
+            resendButton: 'Transaktionen erneut senden',
+            successTitle: 'Transaktionen gesendet!',
+            successBody: 'Prüfen Sie Ihr Bankkonto in den nächsten 1–2 Werktagen.',
+            successButton: 'Verstanden',
         },
     },
     cardPage: {

src/languages/el.ts

@@ -2659,6 +2659,19 @@ const translations: TranslationDeepObject<typeof en> = {
             confirmTestTransactions: 'Παρακαλούμε επιβεβαιώστε τις δοκιμαστικές συναλλαγές',
             accountRequiresAttention: 'Αυτός ο λογαριασμός χρειάζεται προσοχή',
             unlock: 'Ξεκλείδωμα',
+            debitBlocked: 'Η τράπεζά σας μπλόκαρε τις δοκιμαστικές συναλλαγές σε αυτόν τον λογαριασμό',
+            insufficientFunds: 'Οι δοκιμαστικές συναλλαγές απέτυχαν λόγω ανεπαρκών χρημάτων',
+            validationFailedFallback: 'Η τράπεζά σας μπλόκαρε τις δοκιμαστικές συναλλαγές σε αυτόν τον λογαριασμό. <concierge-link>Επικοινωνήστε με το Concierge</concierge-link>',
+        },
+        fixBankAccount: {
+            title: 'Διόρθωση τραπεζικού λογαριασμού',
+            debitBlockedBody:
+                'Η τράπεζά σας μπλόκαρε τις δοκιμαστικές συναλλαγές σε αυτόν τον λογαριασμό.<br/><br/>Παρακαλούμε ζητήστε τους να προσθέσουν στις εξαιρέσεις τα ACH IDs της Expensify:<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>Έπειτα, στείλτε ξανά τις παρακάτω δοκιμαστικές συναλλαγές.',
+            insufficientFundsBody: 'Οι δοκιμαστικές συναλλαγές απέτυχαν λόγω ανεπαρκών κεφαλαίων. Μόλις υπάρχουν διαθέσιμα κεφάλαια, χρησιμοποιήστε το παρακάτω κουμπί.',
+            resendButton: 'Επαναποστολή συναλλαγών',
+            successTitle: 'Οι συναλλαγές στάλθηκαν!',
+            successBody: 'Ελέγξτε τον τραπεζικό σας λογαριασμό μέσα στις επόμενες 1–2 εργάσιμες ημέρες.',
+            successButton: 'Το κατάλαβα',
         },
     },
     cardPage: {

src/languages/en.ts

@@ -2662,6 +2662,19 @@ const translations = {
             confirmTestTransactions: 'Please confirm test transactions',
             accountRequiresAttention: 'This account requires attention',
             unlock: 'Unlock',
+            debitBlocked: 'Your bank blocked test transactions to this account',
+            insufficientFunds: 'Test transactions failed due to insufficient funds',
+            validationFailedFallback: 'Your bank blocked test transactions to this account. <concierge-link>Contact Concierge</concierge-link>',
+        },
+        fixBankAccount: {
+            title: 'Fix bank account',
+            debitBlockedBody:
+                "Your bank blocked the test transactions to this account.<br/><br/>Please have them whitelist Expensify's ACH IDs:<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>Then, resend the test transactions below.",
+            insufficientFundsBody: 'Test transactions failed due to insufficient funds. Once funds are available, use the button below.',
+            resendButton: 'Resend transactions',
+            successTitle: 'Transactions sent!',
+            successBody: 'Check your bank account in the next 1-2 business days.',
+            successButton: 'Got it',
         },
         assignedCards: 'Cards',
         assignedCardsDescription: 'Transactions from assigned cards sync automatically.',

src/languages/es.ts

@@ -2523,6 +2523,19 @@ const translations: TranslationDeepObject<typeof en> = {
             confirmTestTransactions: 'Confirma las transacciones de prueba',
             accountRequiresAttention: 'Esta cuenta requiere atención',
             unlock: 'Desbloquear',
+            debitBlocked: 'Tu banco bloqueó las transacciones de prueba a esta cuenta',
+            insufficientFunds: 'Las transacciones de prueba fallaron por fondos insuficientes',
+            validationFailedFallback: 'Tu banco bloqueó las transacciones de prueba a esta cuenta. <concierge-link>Contacta con Concierge</concierge-link>',
+        },
+        fixBankAccount: {
+            title: 'Corregir cuenta bancaria',
+            debitBlockedBody:
+                'Tu banco bloqueó las transacciones de prueba a esta cuenta.<br/><br/>Pídeles que agreguen a la lista blanca los ID de ACH de Expensify:<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>Luego, vuelve a enviar las transacciones de prueba de abajo.',
+            insufficientFundsBody: 'Las transacciones de prueba fallaron por fondos insuficientes. Cuando haya fondos disponibles, utiliza el botón de abajo.',
+            resendButton: 'Reenviar transacciones',
+            successTitle: '¡Transacciones enviadas!',
+            successBody: 'Revisa tu cuenta bancaria en los próximos 1-2 días hábiles.',
+            successButton: 'Entendido',
         },
     },
     cardPage: {

src/languages/fr.ts

@@ -2607,6 +2607,19 @@ const translations: TranslationDeepObject<typeof en> = {
             confirmTestTransactions: 'Veuillez confirmer les transactions de test',
             accountRequiresAttention: 'Ce compte nécessite une attention particulière',
             unlock: 'Déverrouiller',
+            debitBlocked: 'Votre banque a bloqué les transactions de test vers ce compte',
+            insufficientFunds: 'Les transactions de test ont échoué en raison de fonds insuffisants',
+            validationFailedFallback: 'Votre banque a bloqué les transactions de test vers ce compte. <concierge-link>Contacter Concierge</concierge-link>',
+        },
+        fixBankAccount: {
+            title: 'Corriger le compte bancaire',
+            debitBlockedBody:
+                'Votre banque a bloqué les transactions de test vers ce compte.<br/><br/>Veuillez leur demander d’ajouter les identifiants ACH d’Expensify à leur liste blanche :<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>Puis, renvoyez les transactions de test ci-dessous.',
+            insufficientFundsBody: 'Les transactions de test ont échoué en raison de fonds insuffisants. Une fois les fonds disponibles, utilisez le bouton ci-dessous.',
+            resendButton: 'Renvoyer les transactions',
+            successTitle: 'Transactions envoyées !',
+            successBody: 'Vérifiez votre compte bancaire dans un délai de 1 à 2 jours ouvrables.',
+            successButton: 'Compris',
         },
     },
     cardPage: {

src/languages/it.ts

@@ -2595,6 +2595,19 @@ const translations: TranslationDeepObject<typeof en> = {
             confirmTestTransactions: 'Conferma le transazioni di prova',
             accountRequiresAttention: 'Questo conto richiede attenzione',
             unlock: 'Sblocca',
+            debitBlocked: 'La tua banca ha bloccato le transazioni di prova su questo conto',
+            insufficientFunds: 'Le transazioni di prova non sono riuscite per fondi insufficienti',
+            validationFailedFallback: 'La tua banca ha bloccato le transazioni di prova su questo conto. <concierge-link>Contatta Concierge</concierge-link>',
+        },
+        fixBankAccount: {
+            title: 'Correggi conto bancario',
+            debitBlockedBody:
+                'La tua banca ha bloccato le transazioni di prova verso questo conto.<br/><br/>Chiedi loro di inserire nella whitelist gli ID ACH di Expensify:<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>Poi reinvia le transazioni di prova qui sotto.',
+            insufficientFundsBody: 'Le transazioni di prova non sono andate a buon fine per fondi insufficienti. Quando i fondi saranno disponibili, usa il pulsante qui sotto.',
+            resendButton: 'Invia nuovamente le transazioni',
+            successTitle: 'Transazioni inviate!',
+            successBody: 'Controlla il tuo conto bancario entro 1-2 giorni lavorativi.',
+            successButton: 'Ricevuto',
         },
     },
     cardPage: {

src/languages/ja.ts

@@ -2572,6 +2572,19 @@ const translations: TranslationDeepObject<typeof en> = {
             confirmTestTransactions: 'テスト取引を確認してください',
             accountRequiresAttention: 'このアカウントには対応が必要です',
             unlock: 'ロック解除',
+            debitBlocked: 'この口座へのテスト取引は銀行によってブロックされました',
+            insufficientFunds: '残高不足のためテスト取引に失敗しました',
+            validationFailedFallback: 'この口座へのテスト取引は銀行によってブロックされました。<concierge-link>Concierge に連絡する</concierge-link>',
+        },
+        fixBankAccount: {
+            title: '銀行口座を修正',
+            debitBlockedBody:
+                'この口座へのテスト取引が銀行によってブロックされました。<br/><br/>銀行に依頼して、Expensify の ACH ID をホワイトリストに登録してもらってください。<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>その後、以下のテスト取引を再送してください。',
+            insufficientFundsBody: '残高不足のためテスト取引に失敗しました。残高が利用可能になりましたら、下のボタンを使用してください。',
+            resendButton: '取引を再送信',
+            successTitle: '取引を送信しました！',
+            successBody: '1〜2営業日以内に銀行口座をご確認ください。',
+            successButton: '了解しました',
         },
     },
     cardPage: {

src/languages/nl.ts

@@ -2596,6 +2596,19 @@ const translations: TranslationDeepObject<typeof en> = {
             confirmTestTransactions: 'Bevestig testtransacties alsjeblieft',
             accountRequiresAttention: 'Deze account vereist aandacht',
             unlock: 'Ontgrendelen',
+            debitBlocked: 'Je bank heeft testtransacties naar deze rekening geblokkeerd',
+            insufficientFunds: 'Testtransacties mislukt vanwege onvoldoende saldo',
+            validationFailedFallback: 'Je bank heeft testtransacties naar deze rekening geblokkeerd. <concierge-link>Neem contact op met Concierge</concierge-link>',
+        },
+        fixBankAccount: {
+            title: 'Bankrekening herstellen',
+            debitBlockedBody:
+                "Je bank heeft de testtransacties naar deze rekening geblokkeerd.<br/><br/>Vraag hen om de ACH-ID's van Expensify op de whitelist te zetten:<bullet-list><bullet-item>1270239450</bullet-item><bullet-item>2270239450</bullet-item><bullet-item>4270239450</bullet-item></bullet-list>Stuur daarna de testtransacties hieronder opnieuw.",
+            insufficientFundsBody: 'Testtransacties zijn mislukt vanwege onvoldoende saldo. Zodra er voldoende saldo is, gebruik dan de knop hieronder.',
+            resendButton: 'Transacties opnieuw verzenden',
+            successTitle: 'Transacties verzonden!',
+            successBody: 'Controleer je bankrekening in de komende 1–2 werkdagen.',
+            successButton: 'Begrepen',
         },
     },
     cardPage: {