API Testing - MX Documentation

Using various test values (aka, sentinel values), you may simulate some common scenarios you’ll encounter so you can effectively test your code. Every potential error payload returned by the API can also be simulated to demonstrate the life cycle of a microdeposit. Those sentinel values, and how to use them, will be described in each section below. These test scenarios only work in our integrations environment, not in production. Producing the scenario is just a matter of using the given inputs when start

Input field	Format
First name	Must be less than or equal to 50 characters and contain no special characters, e.g., Dave but not D#ve.
Last name	Must be less than or equal to 50 characters and contain no special characters. e.g., Smith but not Sm_th.
Email	Must be in standard email format, e.g., example@email.com.
Routing number	Must follow standard American Banking Association rules for routing numbers, e.g., 091000019 but not 222222226 or 021000021.
Account number	Any integer that begins with 3333 (e.g. 333312345) will be interpreted as a valid account number. Valid account numbers produce an `INITIATED` status for the microdeposit object that is created, followed by a `REQUESTED` status; `REQUESTED` will change to `DEPOSITED` after two minutes.
Microdeposit amounts	Specific amounts correspond to specific scenarios, described below.

Validation Errors

Validation errors prevent a microdeposit from being created. The following table explains the validation rules for every relevant field for testing.

Field	Rule
`first_name`	Must be a value between 1 and 50 characters. It cannot contain any matches to the following regular expression:
`last_name`	Must be a value between 1 and 50 characters. It cannot contain any matches to the following regular expression:
`email`	Must match the following regex for valid email addresses:
`account_name`	Must be a value between 1 and 50 characters.
`account_number`	Must be a value between 1 and 17 characters.
`account_type_name`	Must be either `CHECKING` or `SAVINGS`.
`routing_number`	Must be a valid routing number with a valid checksum.

Field-Level Validation

Field-level validations can be tested using any data that triggers validation rules to admit an error. This example shows a request with an invalid email address.

Request
Response

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
    "micro_deposit": {
      "account_name": "My Test Account",
      "account_number": "123456",
      "account_type_name": "checking",
      "email": "dave",
      "first_name": "Joshy",
      "last_name": "Groban",
      "routing_number": "091000019"
    }
  }'

{
"error": {
"code": 4220,
"message": "Email is invalid",
"status": "unprocessable_entity"
}
}

All Possible Validation Errors

Field	Value	Status	Code	Message
`account_name`	`""`	`bad_request`	`4001`	`"param is missing or the value is empty: account_name"`
`account_type_name`	`""`	`bad_request`	`4001`	`"param is missing or the value is empty: account_type_name"`
`email`	`""`	`bad_request`	`4001`	`"param is missing or the value is empty: email"`
`first_name`	`""`	`bad_request`	`4001`	`"param is missing or the value is empty: first_name"`
`last_name`	`""`	`bad_request`	`4001`	`"param is missing or the value is empty: last_name"`
`routing_number`	`""`	`bad_request`	`4001`	`"param is missing or the value is empty: routing_number"`

Request with Invalid Email

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
  -H 'Accept: application/vnd.mx.nexus.v1+json' \
  -H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
  -H 'Content-Type: application/json' \
  -d '{
        "micro_deposit": {
          "account_name": "My Test Account",
          "account_number": "123456",
          "account_type_name": "checking",
          "email": "dave",
          "first_name": "Joshy",
          "last_name": "Groban",
          "routing_number": "091000019"
        }
      }'

Example When a Required Field is Empty, or When Required Values Aren’t Submitted:

{
  "error": {
    "code": 4001,
    "message": "param is missing or the value is empty: first_name",
    "status": "bad_request"
  }
}

Example When a Given Value is Present But Triggers a Data Validation Rule:

{
  "error": {
    "code": 4220,
    "message": "Email is invalid",
    "status": "unprocessable_entity"
  }
}

The following errors can occur when given values that trigger validation rules. Note that the given values aren’t special — any value provided which breaks the validation rules will trigger these errors: Here’s the updated table with code ticks in the first column:

Field	Value	Status	Code	Message
`account_name`	Anything greater than 50 characters.	unprocessable_entity	4220	”Account name is too long (maximum is 50 characters)“
`account_number`	`"1"`	unprocessable_entity	4220	”Account number is too short (minimum is 4 characters)“
`account_number`	Anything greater than 17 characters.	unprocessable_entity	4220	”Account number is too long (maximum is 17 characters)“
`account_type_name`	`"invalid"`	unprocessable_entity	4224	”Account type is invalid”
`email`	`"dave"`	unprocessable_entity	4222	”Email is invalid”
`first_name`	Anything greater than 50 characters.	unprocessable_entity	4222	”First name is too long (maximum is 50 characters)“
`last_name`	Anything greater than 50 characters.	unprocessable_entity	4222	”Last name is too long (maximum is 50 characters)“
`routing_number`	`"9"` (any value less than 9 characters).	unprocessable_entity	4222	”Routing number is the wrong length (should be 9 characters), Routing number invalid checksum, Routing number invalid format”
`routing_number`	`"091000018"` (any value that produces an incorrect checksum).	unprocessable_entity	4222	”Routing number invalid checksum”

Duplicate Microdeposit Errors

To produce a duplicate microdeposit error, use the following steps:

Create a valid microdeposit, keeping track of the routing and account number. Attempt to create a microdeposit for the same user, using the same routing and account number.
The result will be an error with the message A MicroDeposit (MIC-a1b2-c3d4) with the same combination of routing and account number already exists.

Create Valid Microdeposit

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "account_name": "My Test Account",
        "account_number": "123412623",
        "account_type_name": "checking",
        "email": "joshyboy2@example.com",
        "first_name": "Joshy",
        "last_name": "Groban",
        "routing_number": "091000019"
      }
    }'

Attempt to Create Another with the Same Account/Routing

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "account_name": "My Test Account",
        "account_number": "123412623",
        "account_type_name": "checking",
        "email": "joshyboy2@example.com",
        "first_name": "Joshy",
        "last_name": "Groban",
        "routing_number": "091000019"
      }
    }'

Expected Error Response

{
  "error": {
    "code": 4223,
    "message": "A MicroDeposit (MIC-12345abc-1731-4b4f-9da9-40a89d5f9152) with the same combination of routing and account number already exists.",
    "status": "unprocessable_entity"
  }
}

Throttling Errors

To produce a throttling error, use the following steps:

For a single user, create three valid microdeposits.
Attempt to create a fourth microdeposit no later than three days from when the first microdeposit was created. The expected response should be an error with the message “Create too many created within acceptable window.”

To test that new microdeposits can be made after the three-day window, you can either:

Wait three days
Delete one of the three microdeposits

{
  "error": {
    "code": 4229,
    "message": "Create too many created within acceptable window",
    "status": "unprocessable_entity"
  }
}

Lifecycle Testing

ACH Errors

In a real-world scenario, a microdeposit won’t immediately return an ACH error. ACH errors occur only when deposits are attempted, and deposits can take several hours or several days to arrive. When producing ACH errors for testing purposes, microdeposits immediately change from a status of INITIATED to ERRORED. In the real world, a microdeposit will transition from INITIATED to REQUESTED and then to ERRORED. ACH errors R01 through R26 can be triggered by using special test values for the first_name field: testACHErrorA through testACHErrorZ. Create microdeposit with testACHError

Create microdeposit with testACHError

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "account_name": "My Test Account",
        "account_number": "12345678",
        "account_type_name": "checking",
        "email": "joshyboy2@example.com",
        "first_name": "testACHError",
        "last_name": "Groban",
        "routing_number": "091000019"
      }
    }
'

Response

{
  "micro_deposit": {
    "account_name": "My Test Account",
    "account_number": "12345678",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T17:57:48+00:00",
    "email": "joshyboy2@example.com",
    "error_code": null,
    "error_message": null,
    "first_name": "testACHError",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 0,
    "status_name": "INITIATED",
    "updated_at": "2023-08-30T17:57:48+00:00",
    "verified_at": null
  }
}

Check the Microdeposit Status

curl -L 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g'

Response ERROED status

{
  "micro_deposit": {
    "account_name": "My Test Account",
    "account_number": "12345678",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T18:01:42+00:00",
    "email": "joshyboy2@example.com",
    "error_code": "R01",
    "error_message": "Insufficient Funds",
    "first_name": "testACHError",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 4,
    "status_name": "ERRORED",
    "updated_at": "2023-08-30T18:01:44+00:00",
    "verified_at": null
  }
}

To test specific ACH error codes:

Create a microdeposit using testACHError (or any other valid test name for a given error) as the first_name. The initial response will look like a normal, valid microdeposit.
Check the status of the microdeposit. The ACH error_code and error_message can now be seen, and the status is now ERRORED. Note that specific ACH errors can be tested by adding a letter to the first_name value.

Invalid Verification Value Error

Note that “invalid” verification values aren’t the same as “incorrect” values. Using non-numeric or blank verification values will trigger validation errors. To test an invalid verification error:

Create a valid microdeposit using a special account number. Account numbers that begin with 3333 will automatically transition from REQUESTED to DEPOSITED 2 minutes after creating the microdeposit.
Once 2 minutes have passed, check the microdeposit to ensure that the status is now DEPOSITED.
Attempt to verify the microdeposit using invalid deposit amounts. You should see an error message describing the invalid verification amounts.

Create Microdeposit with Special Account Number

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "account_name": "My Test Account",
        "account_number": "333312623",
        "account_type_name": "checking",
        "email": "joshyboy2@example.com",
        "first_name": "Joshy",
        "last_name": "Groban",
        "routing_number": "091000019"
      }
    }'

Response

{
  "micro_deposit": {
    "account_name": "My Test Account",
    "account_number": "333312623",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T19:19:18+00:00",
    "email": "joshyboy2@example.com",
    "error_code": null,
    "error_message": null,
    "first_name": "Joshy",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 0,
    "status_name": "INITIATED",
    "updated_at": "2023-08-30T19:19:18+00:00",
    "verified_at": null
  }
}

Check the Status

curl -L 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g'

Response with DEPOSITED Status

{
    "micro_deposit": {
        "account_type": 1,
        "account_type_name": "CHECKING",
        "account_name": "My Test Account",
        "account_number": "333312623",
        "created_at": "2023-08-30T19:19:18+00:00",
        "email": "joshyboy2@example.com",
        "error_code": null,
        "error_message": null,
        "first_name": "Joshy",
        "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
        "institution_name": null,
        "last_name": "Groban",
        "routing_number": "091000019",
        "status": 2,
        "status_name": "DEPOSITED",
        "updated_at": "2023-08-30T19:22:49+00:00",
        "verified_at": null
    }
}

Verify with Invalid Amounts

curl -L -X PUT 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152' \
-H 'MD-SESSION-TOKEN: application/vnd.mx.nexus.v1+json' \
-H 'Accept: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "deposit_amount_1": "invalid1",
        "deposit_amount_2": "o.o1"
      }
    }'

Error Response

{
  "error": {
    "code": 4225,
    "message": "Invalid deposit amount",
    "status": "unprocessable_entity"
  }
}

Incorrect Verification Value Error

Note that “incorrect” verification values aren’t the same as “invalid” values. Incorrect verification values will trigger a microdeposit verification error. End users are allowed three attempts to enter the correct verification amounts. On the third failed attempt, the microdeposit will move to a PREVENTED status, and is considered complete. Note that PREVENTED indicates a legitimate failure for the end user to verify their account. A PREVENTED status doesn’t indicate a problem with the verification process. To test an incorrect verification value error:

Create a valid microdeposit using a special account number. Account numbers that begin with 3333 will automatically transition from REQUESTED to DEPOSITED 2 minutes after creating the microdeposit.
Wait at least 2 minutes, then check the status to ensure that the status is now DEPOSITED.
Now that the microdeposit is ready to verify, use 0.02 for both values.
Check the status of the microdeposit. It should now be DENIED.

Create Microdeposit with Special Account Number

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "account_name": "My Test Account",
        "account_number": "333312623",
        "account_type_name": "checking",
        "email": "joshyboy2@example.com",
        "first_name": "Joshy",
        "last_name": "Groban",
        "routing_number": "091000019"
      }
    }'

Response

{
  "micro_deposit": {
    "account_name": "My Test Account",
    "account_number": "333312623",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T19:27:16+00:00",
    "email": "joshyboy2@example.com",
    "error_code": null,
    "error_message": null,
    "first_name": "Joshy",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 1,
    "status_name": "REQUESTED",
    "updated_at": "2023-08-30T19:27:18+00:00",
    "verified_at": null
  }
}

Check the Status after 2 Minutes

curl -L 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g'

Response with DEPOSITED status

{
  "micro_deposit": {
    "account_name": "My Test Account",
    "account_number": "333312623",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T19:27:18+00:00",
    "email": "joshyboy2@example.com",
    "error_code": null,
    "error_message": null,
    "first_name": "Joshy",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 2,
    "status_name": "DEPOSITED",
    "updated_at": "2023-08-30T19:29:49+00:00",
    "verified_at": null
  }
}

Verify with with Values 0.02

curl -L -X PUT 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152/verify' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "deposit_amount_1": 0.02,
        "deposit_amount_2": 0.02
      }
    }'

Check the Microdeposit Status

curl -L 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g'

Response with DENIED Status

{
  "micro_deposit": {
    "account_name": "1",
    "account_number": "333312623",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T23:17:18+00:00",
    "email": "joshyboy2@example.com",
    "error_code": null,
    "error_message": "Wrong deposit amount(s).",
    "first_name": "Joshy",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 5,
    "status_name": "DENIED",
    "updated_at": "2023-08-30T23:20:53+00:00",
    "verified_at": null
  }
}

Early Verification Error

To test an early verification error:

Create a valid microdeposit.
Attempt to verify the microdeposit using any deposit amounts. An error indicating that it’s too early to verify should be present in the response.

Create a Microdeposit

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "account_name": "My Test Account",
        "account_number": "123412623",
        "account_type_name": "checking",
        "email": "joshyboy2@example.com",
        "first_name": "Joshy",
        "last_name": "Groban",
        "routing_number": "091000019"
      }
    }'
{
  "micro_deposit": {
    "account_name": "My Test Account",
    "account_number": "123412623",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T19:33:06+00:00",
    "email": "joshyboy2@example.com",
    "error_code": null,
    "error_message": null,
    "first_name": "Joshy",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 0,
    "status_name": "INITIATED",
    "updated_at": "2023-08-30T19:33:06+00:00",
    "verified_at": null
  }
}

Verify Using Any Amounts

curl -L -X PUT 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152/verify' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "deposit_amount_1": 0.09,
        "deposit_amount_2": 0.09
      }
    }'

Error Response

{
  "error": {
    "code": 4226,
    "message": "MicroDeposit is not ready for verification",
    "status": "unprocessable_entity"
  }
}

Verifying Multiple Times Error

To test a multiple verification error:

Create a valid microdeposit using any special 3333xxx account number.
Wait at least 2 minutes.
Check the microdeposit status.
Once the status shows as DEPOSITED:
- Verify the microdeposit using 0.09 for both deposit amounts. This simulates a successful verification.
Attempt to verify again.
- The response should indicate that the microdeposit couldn’t be verified again.

Create Microdeposit with Special Account Number

curl -L 'https://int-data.moneydesktop.com/micro_deposits' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "account_name": "My Test Account",
        "account_number": "333312623",
        "account_type_name": "checking",
        "email": "joshyboy2@example.com",
        "first_name": "Joshy",
        "last_name": "Groban",
        "routing_number": "091000019"
      }
    }'

Response

{
  "micro_deposit": {
    "account_name": "My Test Account",
    "account_number": "333312623",
    "account_type": 1,
    "account_type_name": "CHECKING",
    "created_at": "2023-08-30T19:33:06+00:00",
    "email": "joshyboy2@example.com",
    "error_code": null,
    "error_message": null,
    "first_name": "Joshy",
    "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
    "institution_name": null,
    "last_name": "Groban",
    "routing_number": "091000019",
    "status": 0,
    "status_name": "INITIATED",
    "updated_at": "2023-08-30T19:33:06+00:00",
    "verified_at": null
  }
}

Check the Status after 2 Minutes

curl -L 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g'

Response with DEPOSITED Status

{
    "micro_deposit": {
        "account_type": 1,
        "account_type_name": "CHECKING",
        "account_name": "My Test Account",
        "account_number": "123412623",
        "created_at": "2023-08-30T19:33:06+00:00",
        "email": "joshyboy2@example.com",
        "error_code": null,
        "error_message": null,
        "first_name": "Joshy",
        "guid": "MIC-12345abc-1731-4b4f-9da9-40a89d5f9152",
        "institution_name": null,
        "last_name": "Groban",
        "routing_number": "091000019",
        "status": 2,
        "status_name": "DEPOSITED",
        "updated_at": "2023-08-30T19:37:45+00:00",
        "verified_at": null
    }
}


curl -L -X PUT 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152/verify' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "deposit_amount_1": 0.09,
        "deposit_amount_2": 0.09
      }
    }'

Attempt to Verify Again with Amounts 0.09

curl -L -X PUT 'https://int-data.moneydesktop.com/micro_deposits/MIC-12345abc-1731-4b4f-9da9-40a89d5f9152/verify' \
-H 'MD-SESSION-TOKEN: de2uS4jEwSYN7W0eoF_ZiLJQ7rtQaDbA9NkCZr_U4gujctbMw_WZYz7u6q3NMDlTYYCSSR7O3ec1fOP2wArN0g' \
-H 'Accept: application/vnd.mx.nexus.v1+json' \
-H 'Content-Type: application/json' \
-d '{
      "micro_deposit": {
        "deposit_amount_1": 0.09,
        "deposit_amount_2": 0.09
      }
    }'

Error Response

{
  "error": {
    "code": 4227,
    "message": "MicroDeposit is already verified",
    "status": "unprocessable_entity"
  }
}

​Validation Errors

​Field-Level Validation

​All Possible Validation Errors

​Request with Invalid Email

​Example When a Required Field is Empty, or When Required Values Aren’t Submitted:

​Example When a Given Value is Present But Triggers a Data Validation Rule:

​Duplicate Microdeposit Errors

​Throttling Errors

​Lifecycle Testing

​ACH Errors

​Invalid Verification Value Error

​Incorrect Verification Value Error

​Early Verification Error

​Verifying Multiple Times Error

Validation Errors

Field-Level Validation

All Possible Validation Errors

Request with Invalid Email

Example When a Required Field is Empty, or When Required Values Aren’t Submitted:

Example When a Given Value is Present But Triggers a Data Validation Rule:

Duplicate Microdeposit Errors

Throttling Errors

Lifecycle Testing

ACH Errors

Invalid Verification Value Error

Incorrect Verification Value Error

Early Verification Error

Verifying Multiple Times Error