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.
Possible enum values
Possible enum values
pending
The AccountVerificationSession is pending. For micro_deposits
type, this state indicates that the micro-deposit transactions have not yet been sent. For all other types, this means that the verification session has been created but not yet updated with any data.
in_progress
The AccountVerificationSession is in progress. For micro_deposits
type, this state indicates that the micro-deposit transactions have been sent and the session can be updated with the amounts to complete verification. This state is irrelevant for all other types.
verified
The AccountVerificationSession has been successfully verified.
failed
The AccountVerificationSession has failed verification based on the provided data. See error
for details.
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
.
This object will be populated if the AccountVerificationSession is of type network
.
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. |
network | 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: