Initiaite Matching Service and Challenge Deposit

v1.0.0

The post verification service is used to initiate the matching service (MS) and the challenge deposit account verification (CDV) process to verify account ownership.
The MS and CDV process can verify ownership of only bank accounts (i.e., checking and savings).
The MS verification can be initiated only for an already aggregated account or a providerAccount.
The prerequisite for the MS verification process is to request the ACCT_PROFILE dataset with the HOLDER_NAME attribute.
In the MS verification process, a string-match of the account holder name with the registered user name is performed instantaneously. You can contact the Yodlee CustomerCare to configure the full name or only the last name match.
Once the CDV process is initiated Yodlee will post the microtransaction (i.e., credit and debit) in the user's account. The CDV process takes 2 to 3 days to complete as it requires the user to provide the microtransaction details.
The CDV process is currently supported only in the United States.
The verificationId in the response can be used to track the verification request.

Notes:

This endpoint cannot be used to test the CDV functionality in the developer sandbox or test environment. You will need a money transmitter license to implement the CDV functionality and also require the Yodlee Professional Services team's assistance to set up a dedicated environment.

Input

{
  "type": "object",
  "required": [
    "verification"
  ],
  "properties": {
    "verification": {
      "type": "object",
      "properties": {
        "account": {
          "type": "object",
          "required": [
            "accountNumber",
            "accountType",
            "bankTransferCode"
          ],
          "properties": {
            "accountName": {
              "type": "string"
            },
            "accountNumber": {
              "type": "string"
            },
            "accountType": {
              "type": "string",
              "enum": [
                "SAVINGS",
                "CHECKING"
              ]
            },
            "bankTransferCode": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The FI's branch identification number.Additional Details: The routing number of the bank account in the United States. For non-United States accounts, it is the IFSC code (India), BSB number (Australia), and sort code (United Kingdom). <br><b>Account Type</b>: Aggregated<br><b>Applicable containers</b>: bank, investment<br><b>Endpoints</b>:<br><ul><li>GET accounts</li><li>GET accounts/{accountId}</li><li>POST verification</li></ul>"
                },
                "type": {
                  "type": "string",
                  "description": "The bank transfer code type varies depending on the region of the account origination. <br><b>Account Type</b>: Aggregated<br><b>Applicable containers</b>: bank, investment<br><b>Endpoints</b>:<br><ul><li>GET accounts</li><li>GET accounts/{accountId}</li><li>POST verification</li></ul><b>Applicable Values</b><br>",
                  "enum": [
                    "BSB",
                    "IFSC",
                    "ROUTING_NUMBER",
                    "SORT_CODE"
                  ]
                }
              }
            }
          }
        },
        "accountId": {
          "type": "integer",
          "format": "int64",
          "description": "Unique identifier for the account.<br><br><b>Endpoints</b>:<ul><li>POST verification</li><li>GET verification</li><li>PUT verification</li></ul>"
        },
        "providerAccountId": {
          "type": "integer",
          "format": "int64",
          "description": "Unique identifier for the provider account.<br><br><b>Endpoints</b>:<ul><li>POST verification</li><li>GET verification</li><li>PUT verification</li></ul>"
        },
        "reason": {
          "type": "string",
          "description": "The reason the account verification failed.<br><br><b>Endpoints</b>:<ul><li>POST verification</li><li>GET verification</li><li>PUT verification</li></ul>",
          "enum": [
            "DATA_NOT_AVAILABLE",
            "ACCOUNT_HOLDER_MISMATCH",
            "FULL_ACCOUNT_NUMBER_AND_BANK_TRANSFER_CODE_NOT_AVAILABLE",
            "FULL_ACCOUNT_NUMBER_NOT_AVAILABLE",
            "BANK_TRANSFER_CODE_NOT_AVAILABLE",
            "EXPIRED",
            "DATA_MISMATCH",
            "INSTRUCTION_GENERATION_ERROR"
          ]
        },
        "verificationDate": {
          "type": "string",
          "description": "The date of the account verification.<br><br><b>Endpoints</b>:<ul><li>POST verification</li><li>GET verification</li><li>PUT verification</li></ul>"
        },
        "verificationId": {
          "type": "integer",
          "format": "int64",
          "description": "Unique identifier for the verification request.<br><br><b>Endpoints</b>:<ul><li>POST verification</li><li>GET verification</li><li>PUT verification</li></ul>"
        },
        "verificationStatus": {
          "type": "string",
          "description": "The status of the account verification.<br><br><b>Endpoints</b>:<ul><li>POST verification</li><li>GET verification</li><li>PUT verification</li></ul><br><b>Applicable Values</b>",
          "enum": [
            "INITIATED",
            "DEPOSITED",
            "SUCCESS",
            "FAILED"
          ]
        },
        "verificationType": {
          "type": "string",
          "description": "The account verification type.<br><br><b>Endpoints</b>:<ul><li>POST verification</li><li>GET verification</li><li>PUT verification</li></ul><br><b>Applicable Values</b>",
          "enum": [
            "MATCHING",
            "CHALLENGE_DEPOSIT"
          ]
        }
      }
    }
  }
}

Output

{
  "type": "object",
  "additionalProperties": true
}