---
title: "account-verification/bank-account/initiate"
method: POST
path: "/account-verification/bank-account/initiate"
tags: ["Account Verification Endpoints"]
---

# account-verification/bank-account/initiate

`POST /account-verification/bank-account/initiate`

## Request

- Base URL: `https://earthnode-dev.vopay.com/api/v2`
- URL: `https://earthnode-dev.vopay.com/api/v2/account-verification/bank-account/initiate`
- Auth: none declared

This endpoint is used to intiate the micro deposit transaction. The bank routing information required will vary depending on the country. Currently only US and Canada are supported.

## Request body `application/x-www-form-urlencoded`

- object
  - `AccountID` string, required: Your account ID
  - `Key` string, required: API key for the account
  - `Signature` string, required: Hashed signature for the request
  - `Country` string, required: Country for which the Micro Transaction should be initiated
  - `CompanyName` string, required: Company name of the account holder - required for associating the bank details
  - `FirstName` string, required: First name of the account holder - required for associating the bank details (optional if company name is present)
  - `LastName` string, required: Last name of the account holder - required for associating the bank details (optional if company name is present)
  - `Notes` string: An optional note to associate with the account verification request.
  - `ClientReferenceNumber` string: Reference number for the client
  - `InstitutionNumber` string: Financial Institution number - required for associating the bank details. Canada only.
  - `TransitNumber` string: Bank transit number - required for associating the bank details. Canada only.
  - `AccountNumber` string, required: Account number - required for associating the bank details.
  - `ABARoutingNumber` string: ABA routing number - required for associating the bank details. US only.
  - `SendEmail` boolean: This option is used to send the account verification initiation/expiration email. If you wish to send an email, then provide true. The default value is false.
  - `SenderEmailAddress` string, email: Account's email address - Must be a valid email. Required if SendEmail = true
  - `ReceiverEmailAddress` string, email: Recipient's email address - Must be a valid email. Required if SendEmail = true
  - `PhoneNumber` string: Customer's phone number. Digits only - no parentheses or dashes allowed. US only.
  - `Address1` string: Customer's address line 1. US only.
  - `City` string: Account's city - No abbreviation. US only.
  - `State` string: Customer's state specified using two character abbreviations (eg. CA, AZ). US only.
  - `ZipCode` string: Customer's zip code. US only.
  - `Token` string: The token identifying the bank account to be verified. If token is provided, bank routing info and address are not required.

## Response `200`

- object
  - `Success` boolean: True if the request was successful, false if it failed
  - `ErrorMessage` string: Contains a description of the error if the request failed
  - `VerificationRequestID` integer: Verification Request ID for the Bank Account to be verified
  - `Link` string: Link associated with the Account Verification Request ID

---

[API](https://skmtc.dev/vopay/apis/verification.md) - [All operations](https://skmtc.dev/vopay/apis/verification/llms.txt) - [OpenAPI document](https://skmtc.dev/vopay/apis/verification/revisions/a167619c0012?raw)