Link a bank account
Link a bank account to an existing Moov account.
To use this endpoint from the browser, you’ll need to specify the /accounts/{accountID}/bank-accounts.write
scope when generating a token.
It is strongly recommended that callers include the X-Wait-For
header, set to payment-method
, if the newly linked
bank-account is intended to be used right away. If this header is not included, the caller will need to poll the List Payment
Methods
endpoint to wait for the new payment methods to be available for use.
|
|
|
|
{
"bankAccountID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
"bankAccountType": "checking",
"bankName": "Chase Bank",
"exceptionDetails": {
"achReturnCode": "R02",
"description": "string",
"rtpRejectionCode": "AC03 - Account Invalid"
},
"fingerprint": "9948962d92a1ce40c9f918cd9ece3a22bde62fb325a2f1fe2e833969de672ba3",
"holderName": "Jules Jackson",
"holderType": "individual",
"lastFourAccountNumber": "7000",
"paymentMethods": [
{
"paymentMethodID": "9506dbf6-4208-44c3-ad8a-e4431660e1f2",
"paymentMethodType": "ach-debit-fund"
},
{
"paymentMethodID": "3f9969cf-a1f3-4d83-8ddc-229a506651cf",
"paymentMethodType": "ach-debit-collect"
}
],
"routingNumber": "string",
"status": "new",
"statusReason": "bank-account-created",
"updatedOn": "2019-08-24T14:15:22Z"
}
- Unable to get bank name for routing number
- Duplicate bank account
Response headers
X-Retry-In
string
<duration>
Headers
X-Wait-For
string
Optional header to wait for certain events, such as the creation of a payment method, to occur before returning a response.
When this header is set to payment-method
, the response will include any payment methods that were created for the newly
linked card in the paymentMethods
field. Otherwise, the paymentMethods
field will be omitted from the response.
payment-method
Path parameters
accountID
string
<uuid>
required
Body
account
object
Show child attributes
accountNumber
string
required
bankAccountType
string<enum>
required
checking
,
savings
,
unknown
holderName
string
required
holderType
string<enum>
required
individual
,
business
routingNumber
string
required
plaidLink
object
sandbox
- (requires Plaid reseller setup with Moov) When linking a bank account to a sandbox
account using a Plaid public token it will utilize Plaid’s sandbox environment. The Plaid public token provided must be generated from Plaid’s sandbox environment. Please see Plaid’s sandbox documentation for more details.
Show child attributes
publicToken
string
plaid
object
The details of a Plaid processor integration for a linked funding source.
sandbox
- When linking a bank account to a sandbox
account using a Plaid processor token a default bank account response will be used. The following default data will be used to generate the bank account in this flow:
|
|
Show child attributes
token
string
Describes the account to link to the Moov account using a MX processor token.
sandbox
- When linking a bank account to a sandbox
account using an MX authorization token a default bank account routing number will be used. The following default data will be used to generate the bank account in this flow:
|
|
mx
object
sandbox
- When linking a bank account to a sandbox
account using a MX authorization code it will utilize MX’s sandbox environment. The MX authorization code provided must be generated from MX’s sandbox environment.
Show child attributes
authorizationCode
string
Response
bankAccountID
string<uuid>
<=36 characters
Pattern
bankAccountType
string<enum>
checking
,
savings
,
unknown
bankName
string
exceptionDetails
object
errored
or verificationFailed
bank account status.
Show child attributes
achReturnCode
string<enum>
R02
,
R03
,
R04
,
R05
,
R07
,
R08
,
R10
,
R11
,
R12
,
R13
,
R14
,
R15
,
R16
,
R17
,
R20
,
R23
,
R29
,
R34
,
R38
,
R39
description
string
errored
or verificationFailed
bank account status.
rtpRejectionCode
string<enum>
AC03 - Account Invalid
,
AC04 - Account Closed
,
AC06 - Account Blocked
,
AC14 - Creditor Account Type Invalid
,
AG01 - Transactions Forbidden On Account
,
AG03 - Transaction Type Not Supported
,
MD07 - Customer Deceased
fingerprint
string
<=100 characters
holderName
string
holderType
string<enum>
individual
,
business
lastFourAccountNumber
string
paymentMethods
array
Includes any payment methods generated for a newly created bank account, removing the need to call the List Payment Methods endpoint following a successful Create BankAccount request.
NOTE: This field is only populated for Create BankAccount requests made with the X-Wait-For
header.
Show child attributes
paymentMethodID
string<uuid>
<=36 characters
Pattern
paymentMethodType
string<enum>
moov-wallet
,
ach-debit-fund
,
ach-debit-collect
,
ach-credit-standard
,
ach-credit-same-day
,
rtp-credit
,
card-payment
,
apple-pay
,
push-to-card
,
pull-from-card
routingNumber
string
status
string<enum>
new
,
verified
,
verificationFailed
,
pending
,
errored
statusReason
string<enum>
bank-account-created
,
verification-initiated
,
micro-deposit-attempts-exceeded
,
micro-deposit-expired
,
max-verification-failures
,
verification-successful
,
ach-debit-return
,
ach-credit-return
,
rtp-credit-failure
,
micro-deposit-return
,
admin-action
,
other
updatedOn
string<date-time>
<=24 characters