Test mode

Simulate account and transfer scenarios on Moov’s platform without using real money.

Moov has pre-populated your test account with sample business details and accounts. You aren’t required to enter anything for your test account to receive the verified status. In test mode, requirements for all capabilities have been satisfied, so they are automatically enabled for you. You’ll have full access to the following capabilities:

While you don’t need to request capabilities for test mode, for production mode, you’ll need to request capabilities. You can do this at the same time you create your account, or request additional capabilities later.

Switch to test mode

After you’ve completed your business profile and Moov has approved your production account, you can switch between production and test mode in the Moov Dashboard by using the Account dropdown in the upper left hand corner.

Toggle for test account in Moov Dashboard

Invite team members

Use the account switcher in the Moov Dashboard to switch to test mode. While in test mode, you can invite team members to your test account. Inviting team members to your test account does not enable them to use your production account. If you’d also like to invite team members to your production account, you will need to do that separately in production mode.

API keys

You will need to create an API key specific to the test account. We suggest naming the API key something that will help you remember that it’s for testing purposes.

Create API key for test account modal in Moov Dashboard

Transfers

Transfers in test mode won’t move any real money. For the timing of transfers in test mode, note that:

  • Wallet to wallet transfers complete almost instantly
  • ACH transfers in test mode will complete in about an hour (see the processing speed guide for production mode)

If you would like to see how Moov handles failures in production, view the transfer failures guide.

Micro-deposits

To simulate micro-deposit verification in test mode, enter 0 for both amounts: [0,0], and the bank account verification will succeed. If you input any other amount, the bank account verification will not complete.

Bank accounts

We’ve already added sample payment methods for you in test mode, including bank accounts and cards. If you’d like to add an additional test bank account, you must include a valid routing number. For example:

1
322271627

The account number can be any number, for example:

1
12345654321

ACH returns

You can simulate a few ACH return scenarios during different transfer stages. To see any of the return scenarios in action, create a new test transfer in the Moov Dashboard. In the Amount input in the Create test transfer modal, enter the return amount of the return type you want to simulate (listed below).

Return amount Return type Return transfer stage
5501 R01 / Insufficient funds Debit has originated, but not completed
5502 R02 / Account closed Debit has originated, but not completed
5503 R03 / No account/Unable to locate account Credit has completed
5508 R08 / Payment stopped Debit has completed

Create test return transfer

If you would prefer to use the API to simulate a return, you can trigger the ACH returns in test mode by entering any of the return codes as the value.

1
2
3
4
5
6
7
8
9
{
  "amount": {
    "currency": "USD",
    "value": 5501
  },
  "facilitatorFee": {
    "total": 0,
  }
}

A return will be only triggered if the transfer type (for example, wallet-to-bank) is applicable to the particular return scenario and amount entered. For example, an R01 in test mode always occurs on the debit leg, after the transfer stage of debit origination. Accordingly, an R01 return cannot be triggered on a wallet-to-bank transfer, as that transfer type only consists of a credit leg. Creating a return scenario that does not apply to a corresponding transfer type will result in a regular test transfer, not a test return.

Once you have created a transfer with an appropriate return code, Moov will update the transfer to failed or reversed based on the transfer stage (see ACH returns and exceptions for more information). The bank account status will also be updated accordingly.

The ACH returns and exceptions guide also includes the full ACH return code list.

Plaid

To test linking bank accounts with Plaid, simply pass env: "sandbox" into the payload in the Moov.js initialization. You can pass in any token as the processor token and Moov will link default account data that looks like the following:

1
2
3
4
  RoutingNumber: "011401533",
  AccountNumber: "1111222233330000",
  AccountType:   "checking",
  Mask:          "0000"

RTP

To simulate an RTP transfer in test mode, create a transfer with moov-wallet as the source payment method and rtp-credit as the destination. The rtp-credit payment method will only appear for bank accounts with routing numbers that are RTP eligible.

Refer to The Clearing House’s RTP page for the latest list of RTP-enabled routing numbers.

Card acceptance

We only support specific test cards for simulating card transfers. The expiration date field for all test cards can be set to any future date.

To simulate card transfers, use the following card numbers:

Card brand Test card number CVV
Visa 4111111111111111 Any 3 numbers
Mastercard 5555555555554444 Any 3 numbers
Discover 6011111111111117 Any 3 numbers
American Express 371111111111114 Any 4 numbers

Push to card & pull from card

For simulating a push to card transfer, use the following fast-funds eligible test card:

Card brand Completed transfer Failed transfer
Visa 4111 1000 1000 2000 4111 1000 5000 7000
Mastercard 5200 8282 8282 8210 5200 8211 1111 1114

The expiration date can be any future date. CVV can be any 4 numbers for Amex and any 3 numbers for all other card brands.

Declined card transfers

To simulate a declined card-payment transfer, use the following card number:

4000020000000000

The expiration date can be any future date. CVV can be any 4 numbers for Amex and any 3 numbers for all other card brands.

Disputes

To simulate disputes, use the following card numbers:

Card brand Test card number Phase Reason code
Visa 4000 2000 2000 2000 Chargeback 10.4
Mastercard 5555 4444 0000 4444 Chargeback 4860
Discover 6011 2222 2222 0000 Chargeback C05
American Express 3710 1000 2000 123 Chargeback F29
American Express 3720 2000 2000 188 Inquiry 21

The expiration date can be any future date. CVV can be any 4 numbers for Amex and any 3 numbers for all other card brands.

Summary Beta