The account verification sessions endpoint
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
Unique identifier for the AccountVerificationSession.
The ID of the associated Account.
Status of the AccountVerificationSession.
The type of the AccountVerificationSession. See Verification Types.
This object will be populated if the AccountVerificationSession is of type micro_deposits
This object will be populated if the AccountVerificationSession is of type plaid
.
This object will be populated if the AccountVerificationSession is of type mx
.
This object will be populated if the AccountVerificationSession is of type teller
.
This object will be populated if the AccountVerificationSession is of type auto_verify
.
This object will be populated if the AccountVerificationSession is of type trusted_provisioner
.
This object will be populated if the AccountVerificationSession is of type standard
.
This object will be populated if the AccountVerificationSession is of type pre_auth
.
An object representing an error that occurred while processing this AccountVerificationSession. See AccountVerificationSession errors.
Timestamp of when the AccountVerificationSession was created.
Timestamp of when the AccountVerificationSession was last updated.
Verification Types
Type | Description |
---|---|
micro_deposits | To 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. |
plaid | The ACH Account is verified by providing balance and transaction data from Plaid. |
teller | The ACH Account is verified by providing balance and transaction data from Teller. |
mx | The ACH Account is verified by providing account and transaction data from MX. |
trusted_provisioner | The ACH Account is auto verified based on whitelisted routing numbers for the team. |
auto_verify | The ACH account is verified automatically upon creation, if this configuration is enabled for the team. |
standard | The Liability Account is verified in real-time by the isuser by providing the full account/card number. |
pre_auth | The 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>",
}