Skip to main content
Complete verification for a bank account by submitting the two micro-deposit amounts that were sent to it. When the amounts match what Cleo Pay deposited, the account status transitions to verified and becomes eligible for payments. This step confirms that your business has access to the bank account.

​
HTTP Request

​
Authentication

Include your bearer token on every request:

​
Path Parameters

​
bankAccountId
string
required
The unique identifier of the bank account to verify. This is the id returned when the account was created.

​
Request Body

​
amount1
string
required
The first micro-deposit amount in dollars (not cents). For example, "0.05" represents five cents. Check the account holder’s bank statement for the exact value.
​
amount2
string
required
The second micro-deposit amount in dollars (not cents). For example, "0.07" represents seven cents. Check the account holder’s bank statement for the exact value.

​
Response Fields

On success, the API returns the updated bank account object with status set to verified.
​
id
string
required
Unique identifier for the bank account.
​
status
string
required
The updated verification status. Set to verified on a successful call, or unverified if the maximum number of attempts has been exceeded.
​
type
string
required
The bank account type: checking or savings.
​
connectionType
string
required
How the account was connected. Always manual for accounts created via the API.
​
name
string | null
The display name assigned to this account.
​
institutionName
string | null
The name of the financial institution.
​
accountNumberLast4
string | null
The last four digits of the account number.
​
routingNumberLast4
string | null
The last four digits of the routing number.
​
isDefault
boolean
required
Whether this account is the default account for your business.
​
microDepositsInitiatedAt
datetime | null
The timestamp at which micro-deposits were initiated.
​
microDepositsCompletedAt
datetime | null
The timestamp at which micro-deposits landed in the account.
​
verificationAttempts
number
required
The cumulative number of failed verification attempts. On a successful verification this value is not incremented. The maximum is 3.

​
Example Request

​
Example Response

You have a maximum of 3 attempts to submit the correct amounts. Each incorrect submission increments verificationAttempts. If all 3 attempts are exhausted, the account status permanently transitions to unverified and can no longer be verified. You will need to delete it and link a new account.
Submit amounts in dollars, not cents. For example, use "0.05" — not "5". Submitting amounts in cents is a common mistake that will count as a failed attempt.
You can only call this endpoint after microDepositsCompletedAt is non-null on the account, which indicates that the deposits have arrived. Check the account status using GET /v1/bank-accounts/ before attempting verification.