external_bank_account.updated

wbhk

Occurs when an external bank account is updated.

Payload

event_type

const

enum

required

The type of event that occurred.

Allowed:

token

uuid

required

A globally unique identifier for this record of an external bank account association. If a program links an external bank account to more than one end-user or to both the program and the end-user, then Lithic will return each record of the association

owner

string

required

Legal Name of the business or individual who owns the external account. This will appear in statements

routing_number

string

required

Routing Number

last_four

string

required

The last 4 digits of the bank account. Derived by Lithic from the account number passed

name

string | null

The nickname for this External Bank Account

currency

string

required

currency of the external account 3-character alphabetic ISO 4217 code

country

string

required

The country that the bank account is located in using ISO 3166-1. We will only accept USA bank accounts e.g., USA

account_token

uuid | null

Indicates which Lithic account the external account is associated with. For external accounts that are associated with the program, account_token field returned will be null

created

date-time

required

An ISO 8601 string representing when this funding source was added to the Lithic account.

company_id

string | null

Optional field that helps identify bank accounts in receipts

dob

date | null

Date of Birth of the Individual that owns the external bank account

doing_business_as

string | null

Doing Business As

user_defined_id

string | null

User Defined ID

verification_failed_reason

string | null

Optional free text description of the reason for the failed verification. For ACH micro-deposits returned, this field will display the reason return code sent by the ACH network

verification_attempts

integer

required

The number of attempts at verification

financial_account_token

uuid | null

The financial account token of the operating account to fund the micro deposits

type

string

enum

required

Allowed:

verification_method

string

enum

required

Allowed:

owner_type

string

enum

required

Allowed:

state

string

enum

required

Allowed:

verification_state

string

enum

required

Allowed:

address

Address

Response

200

Return a 200 status to indicate that the data was received successfully