{
  "id": "avf_DjkdemgTQfqRD",
  "account_id": "acc_yVf3mkzbhz9tj",
  "status": "pending",
  "error": null,
  "type": "pre_auth",
  "pre_auth": {
    "exp_year": "xxxx",
    "exp_month": "xx",
    "exp_check": null,
    "cvv": null,
    "cvv_check": null,
    "billing_zip_code": "xxxxx",
    "billing_zip_code_check": null,
    "number": "xxxxxxxxxxxxxxxx",
    "pre_auth_check": null
  },
  "created_at": "2024-03-14T02:02:24.862Z",
  "updated_at": "2024-03-14T02:02:24.862Z"
}

The account verification manages required verification to enable products for ACH or Liability accounts.

For example, ACH Accounts require a verified AccountVerificationSession before they can be used as a source for Payments.

​
AccountVerificationSession Objects

​
id
string

Unique identifier for the AccountVerificationSession.

​
account_id
string

The ID of the associated Account.

​
status
enum

Status of the AccountVerificationSession.

​
type
enum

The type of the AccountVerificationSession. See Verification Types.

​
micro_deposits
object | null

This object will be populated if the AccountVerificationSession is of type micro_deposits

​
plaid
object | null

This object will be populated if the AccountVerificationSession is of type plaid.

​
mx
object | null

This object will be populated if the AccountVerificationSession is of type mx.

​
teller
object | null

This object will be populated if the AccountVerificationSession is of type teller.

​
auto_verify
object | null

This object will be populated if the AccountVerificationSession is of type auto_verify.

​
trusted_provisioner
object | null

This object will be populated if the AccountVerificationSession is of type trusted_provisioner.

​
standard
object | null

This object will be populated if the AccountVerificationSession is of type standard.

​
pre_auth
object | null

This object will be populated if the AccountVerificationSession is of type pre_auth.

​
error
object | null

An object representing an error that occurred while processing this AccountVerificationSession. See AccountVerificationSession errors.

​
created_at
string

Timestamp of when the AccountVerificationSession was created.

​
updated_at
string

Timestamp of when the AccountVerificationSession was last updated.

​
Verification Types

TypeDescription
micro_depositsTo verify a checking or savings account, two small amounts between $0.20 - $0.99 of money will be deposited into the ACH account, once received (within 1 - 3 business days) the account holder will then verify the amounts (in cents) that were deposited.
plaidThe ACH Account is verified by providing balance and transaction data from Plaid.
tellerThe ACH Account is verified by providing balance and transaction data from Teller.
mxThe ACH Account is verified by providing account and transaction data from MX.
trusted_provisionerThe ACH Account is auto verified based on whitelisted routing numbers for the team.
auto_verifyThe ACH account is verified automatically upon creation, if this configuration is enabled for the team.
standardThe Liability Account is verified in real-time by the isuser by providing the full account/card number.
pre_authThe Credit Card Account is verified in real-time by the issuer and card networks by providing the full card number, expiration date, and cvv.

​
Webhook Payload

The Webhook payload will contain the following information:

{
  "id": "string",
  "type": "account_verification_session.create" | "account_verification_session.update",
  "path": "/accounts/<acc_id>/verification_sessions/<avf_id>",
}

{
  "id": "avf_DjkdemgTQfqRD",
  "account_id": "acc_yVf3mkzbhz9tj",
  "status": "pending",
  "error": null,
  "type": "pre_auth",
  "pre_auth": {
    "exp_year": "xxxx",
    "exp_month": "xx",
    "exp_check": null,
    "cvv": null,
    "cvv_check": null,
    "billing_zip_code": "xxxxx",
    "billing_zip_code_check": null,
    "number": "xxxxxxxxxxxxxxxx",
    "pre_auth_check": null
  },
  "created_at": "2024-03-14T02:02:24.862Z",
  "updated_at": "2024-03-14T02:02:24.862Z"
}
Delete a SubscriptionCreate a Verification