Partner Notification types: Bank Error

Partner notification type reference rows for bank_error notifications.

Use this table to see all the current notification types with a brief description on what the messaging will include, the contents of its resource array, what triggers it, whether it is actionable or not, whether it is payroll blocking, and whether it expires.

Category	Title	Message	Resource entity types	Trigger	Actionable	Action Item	Payroll Blocking	Resolves?	Expires?	Template Variables
bank_error.company_ach_debit_failure	Unblock %{payroll_type} payroll for %{payment_check_date}	We were unable to debit sufficient funds from %{company_name}‘s bank account due to the following bank error: %{bank_error} for the %{payroll_type} payroll on %{payment_check_date}. Please update the company bank account details and re-run payroll, so that employees can be paid by direct deposit.	entity_type: “Payroll”	Due to a bank error, a debit failed to the company’s bank account for the 4-day payroll	yes	Update company bank account details to resolve the provided bank error and re-run payroll	no	Yes, it resolves after the payroll is re-run and finished processing	No	{payroll_type}, {payment_check_date}, {company_name}, {bank_error}
bank_error.compensation_credit_failure	Unable to deposit funds to %{beneficiary_name}	We were unable to deposit a recent paycheck to %{beneficiary_name}‘s bank account, so these funds of %{amount} will be returned to %{company_name}‘s bank account. Once the funds are received, the payment should be made directly to %{beneficiary_name}.	entity_type: “Contractor” or “Employee”	Due to a bank error, Gusto was unable to deposit funds to an employee or contractor. Because Gusto is unable to hold these funds legally, we have credited the funds to the company bank account.	yes	Credited compensation to the company’s bank account should be made directly the contractor	no	No	No	{beneficiary_name}, {amount}, {company_name}
bank_error.contractor_ach_credit_failure	Update %{contractor_name}‘s bank account details	We were unable to deposit a recent paycheck to %{contractor_name}‘s bank account due to the following bank error: %{bank_error}. After their bank account details are updated, we will attempt to redeposit the funds in the next business day.‘	entity_type: “BankAccount”, reference_type: “Contractor”	Due to a bank error, Gusto was unable to credit funds to the contractor’s bank account	yes	Update contractor bank account details	no	Yes, it resolves after the contractor has updated their bank account details	No	{contractor_name}, {bank_error}
bank_error.contractor_ach_debit_failure	Failed to debit funds from %{contractor_name}	We were unable to debit funds from %{contractor_name}‘s bank account due to the following bank error: %{bank_error}.	entity_type: “BankAccount”, reference_type: “Contractor”	Due to a bank error, Gusto was unable to debit funds from a contractor’s bank account. This is usually related to a contractor payment reversal.	no	N/A - informational	no	No	No	{contractor_name}, {bank_error}
bank_error.employee_ach_credit_failure	Update %{employee_name}‘s bank account details	We were unable to deposit a recent paycheck to %{employee_name}‘s bank account due to the following bank error: %{bank_error}. After their bank account details are updated, we will attempt to redeposit the funds in the next business day.	entity_type: “BankAccount”, reference_type: “Employee”	Due to a bank error, Gusto was unable to credit funds to the employee’s bank account	yes	Update employee bank account	no	Yes, it resolves after the employee has updated their bank account details	No	{employee_name}, {bank_error}
bank_error.employee_ach_debit_failure	Failed to debit funds from %{employee_name}	We were unable to debit funds from %{employee_name}‘s bank account due to the following bank error: %{bank_error}. Please recover these funds directly from %{employee_name}, as we cannot retry the debit.	entity_type: “BankAccount”, reference_type: “Employee”	Due to a bank error, Gusto was unable to debit funds from the employee’s bank account. This is usually related to a payroll reversal.	yes	Recover funds directly from the employee	no	no	no	{employee_name}, {bank_error}
bank_error.fast_payroll_ach_debit_r01_first_failure	Unable to debit sufficient funds for %{payment_check_date} payroll	Payroll for %{payment_check_date} processed successfully, but we were unable to debit sufficient funds from the associated bank account. A redebit attempt will be made on %{next_attempt_date}.	entity_type: “Payroll”	Due to an insufficient funds bank error, Gusto was unable to debit payroll funds from the company bank account. This occurs when a company is on faster payment speed.	yes	Add sufficient funds to the company’s bank account. Gusto will attempt another redebit at the end of the business day.	no	no	yes - It expires at the end of the day, either same day as the notification was created, or the next business day.	{payment_check_date}, {next_attempt_date}
bank_error.fast_contractor_payment_ach_debit_r01_first_failure	Unable to debit sufficient funds for %{payment_check_date} contractor payment	Contractor payment for %{payment_check_date} processed successfully, but we were unable to debit sufficient funds from the associated bank account. A redebit attempt will be made on %{next_attempt_date}.	entity_type: “ContractorPayment”	Due to an insufficient funds bank error, Gusto was unable to debit contractor payment funds from the company bank account. This occurs when a company is on faster payment speed.	yes	Add sufficient funds to the company’s bank account. Gusto will attempt another redebit at the end of the business day.	no	no	yes - It expires at the end of the day, either same day as the notification was created, or the next business day.	{payment_check_date}, {next_attempt_date}
bank_error.reconciliation_payroll_ach_debit_failure	Unable to debit funds for %{payment_check_date} reconciliation payroll	We were unable to debit funds from %{company_name}‘s bank account due to the following bank error: %{bank_error} for the reconciliation payroll on %{payment_check_date}. We are unable to retry the debit, so please make the tax payments directly.	none	Due to a bank error, Gusto was unable to debit funds from the company bank account for a recent reconciliation payroll.	yes	Contact support to determine what tax payments need to be made to what agencies	no	no	no	{company_name}, {bank_error}, {payment_check_date}
bank_error.company_bank_verification_needs_review	Review the recent bank verification test transactions	We completed a bank verification test transaction with company bank account %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.	entity_type: “BankAccount”	A test transaction to the company’s bank account completed but returned an error	yes	Update company bank account details	no	yes	no	{bank_account_last_four_digits}, {bank_error}
bank_error.company_bank_verification_failure	Unblock future company transactions	We attempted a test transaction with company bank account %{bank_account_last_four_digits}. The transaction failed with message %{bank_error}. This critical error will prevent future payments. Please update the company’s bank account details.	entity_type: “BankAccount”	Due to a bank error, A test transaction to the company’s bank account failed	yes	Update company bank account details	yes	yes	no	{bank_account_last_four_digits}, {bank_error}
bank_error.company_bank_transaction_needs_review	Review the recent company transaction details	We completed a transaction with company bank account %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.	entity_type: “BankAccount”	A transaction to the company’s bank account completed but returned an error	yes	Update company bank account details	no	yes	no	{bank_account_last_four_digits}, {bank_error}
bank_error.company_bank_transaction_failure	Unblock future company transactions	We attempted a transaction with company bank account %{bank_account_last_four_digits}. The transaction failed with message %{bank_error}. This critical error will prevent future payments. Please update the company’s bank account details.	entity_type: “BankAccount”	Due to a bank error, A transaction to the company’s bank account failed	yes	Update company bank account details	yes	yes	no	{bank_account_last_four_digits}, {bank_error}
bank_error.contractor_ach_transaction_needs_review	Review %{contractor_name}‘s recent bank transaction details	We completed a transaction with %{contractor_name}‘s bank account ending in %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.	entity_type: “BankAccount”, reference_type: “Contractor”	A transaction to the contractor’s bank account completed but returned an error	yes	Update contractor bank account details	no	yes	no	{contractor_name}, {bank_account_last_four_digits}, {bank_error}
bank_error.employee_ach_transaction_needs_review	Review %{employee_name}‘s recent bank transaction details	We completed a transaction with %{employee_name}‘s bank account ending in %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.	entity_type: “BankAccount”, reference_type: “Employee”	A transaction to the employee’s bank account completed but returned an error	yes	Update employee bank account details	no	yes	no	{employee_name}, {bank_account_last_four_digits}, {bank_error}
bank_error.continue_instant_verification	Payroll is blocked: Verify bank account	We’ll use this bank account to pay both employees and taxes. Payroll can’t be run until this is done.	none	resolving all pending items for funding method	yes	Verify company bank account	yes	yes	no	None
bank_error.employee_bank_verification_failure	Unblock future employee transactions	We attempted a bank verification test transaction with %{employee_name}‘s bank account %{bank_account_last_four_digits}. The transaction failed with message %{bank_error}. This critical error will prevent future payments. Please update the employee’s bank account details.	entity_type: “BankAccount”, reference_type: “Employee”	Failed test bank transaction for employee	yes	Update employee bank account details	yes	yes	no	{employee_name}, {bank_account_last_four_digits}, {bank_error}
bank_error.contractor_bank_verification_failure	Unblock future contractor transactions	We attempted a bank verification test transaction with %{contractor_name}‘s bank account %{bank_account_last_four_digits}. The transaction failed with message %{bank_error}. This critical error will prevent future payments. Please update the contractor’s bank account details.	entity_type: “BankAccount”, reference_type: “Contractor”	Failed test bank transaction for contractor	yes	Update contractor bank account details	no	yes	no	{contractor_name}, {bank_account_last_four_digits}, {bank_error}