In the sandbox environment, payrolls transition to the next phase of payroll processing automatically. Every 5 minutes, an automated job moves payrolls from one phase to the next. To start the process, you just need to create and approve a payroll.
The phases are in the following order:
- Payments sent
Once payments are sent, any ACH payments are immediately shifted to a terminal status (
failed). Wire payments are reconciled and marked as
completed every 5 minutes.
We provide a mechanism to incur and cause failed payments in our sandbox environment. Using designated company and employee names, you can simulate payrolls transitioning into a failed payment state.
To simulate a payroll that fails to due an NSF in sandbox, create a company with a
NSF Co. or
No Account Co.. The initial debit for payrolls on companies matching that trade name will immediately fail with a
INSUFFICIENT_FUNDS. Any retry attempts will immediately succeed.
To simulate a failed credit due to an
ACCOUNT_CLOSED failure in sandbox, create an employee with
first_name set to
last_name set to
BadAccount. The initial credit payment for payroll items matching that employee name will immediately fail with a
ACCOUNT_CLOSED. Any retry or refund attempts will immediately succeed.
|Company Name||Employee Name||Result|
|NSF Co. or No Account Co.||Anything other than Barry BadAccount||Payroll debit fails due to |
|NSF Co. or No Account Co.||Barry BadAccount||Payroll debit NSF, employee credit fails due to |
|Anything other than NSF Co. or No Account Co.||Barry BadAccount||Payroll debit succeeds, employee credit fails due to |
Testing employee closed account
In order for a payroll item with "Barry BadAccount" to fail, the payroll item will need to have a
manualpayroll items will always be marked as
paid. You will be required to create a bank account for the employee before you can set the payment method to
Updated 3 months ago