1. Guides
2. Developer tools

The test data on this page can be used in test mode to simulate various transfer scenarios. For more thorough instructions, visit our main test mode guide or our Dashboard test mode guide.

Link cards & card acceptance

See the postal and CVV sections below for additional test verification scenarios. Also note that test cards will expire once your chosen expiration date passes.

Name verification

The card link POST endpoint and PATCH endpoint offer an optional verifyName field, which uses Visa's ANI verification as a check against the supplied holderName. Use the following combinations of correct and incorrect names in the holderName field to test results.

Correct name: Alex Nora Irwin

If ANI is not supported, you'll receive unavailable for all results.

Postal code verification

CVV verification

Push & pull from card

The expiration date can be any future date. CVV can be any 3 numbers for Visa and Mastercard. Since push and pull card transfers require verifications, test cards always return a successful match for CVV, postal code, and (if requested) name verification, regardless of the values provided. To test negative verification results, use the test values in the CVV verification, postal code verification, and name verification sections.

Tap to Pay

Test mode allows you to verify your Tap to Pay integration on iOS and Android before processing live payments. The terminal configuration fetched from the Moov API determines whether the SDK operates in test or production mode. When using a test configuration, the SDK simulates card tap scenarios using these test cards:

When testing Tap to Pay on mobile with test cards, you don't need to enter a CVV, expiration date, or postal code. For platform-specific details, refer to the SDK documentation:

• Tap to Pay on iPhone
• Tap to Pay on Android

Declined card transfers

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 only appears for bank accounts with routing numbers that are RTP eligible.

Use 021000021 as an RTP-enabled routing number in test mode.

You can simulate RTP failures and rejections by using these specific transfer amounts. These amounts result in real time failures and the linked bank account entering an errored state.

If you would prefer to use the API to simulate a failure, you can trigger the RTP failure in test mode by entering any of the return amount codes as the value. For example, to simulate an invalid account, enter 7703 as the value.

{
  "amount": {
    "currency": "USD",
    "value": 7703
  },
  "facilitatorFee": {
    "total": 0
  }
}

ACH returns

You can simulate a few ACH return scenarios during different transfer stages. Trigger ACH returns in test mode by entering any of the return amount codes listed below as the value when creating a transfer. For example, to simulate insufficient funds, enter 5501 as the value.

{
  "amount": {
    "currency": "USD",
    "value": 5501
  },
  "facilitatorFee": {
    "total": 0
  }
}

A return is 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 results in a regular test transfer, not a test return.

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

Disputes

Dispute evidence

Bank accounts

To simulate an instant micro-deposit verification in test mode, enter 0001 as the instant verification code.

To simulate traditional 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 won't complete.

Plaid

To test linking bank accounts with Plaid, pass env: "sandbox" into the payload in the Moov.js initialization. You can pass any token as the processor token and Moov links default account data:

  RoutingNumber: "011401533",
  AccountNumber: "1111222233330000",
  AccountType:   "checking",
  Mask:          "0000"