Skip to main content
POST
Start company bank-account setup

Authorizations

Authorization
string
header
required

Bearer token authentication

Body

application/json
instrument_setup
object
required

Response

SetupIntent created or safely replayed.

instrument_setup
object
required
authorization
object
required
authorizations
object
required

The approved agreement for each rail offered, by version and fingerprint. Every company is offered every rail with an approved agreement.

allowed_instrument_types
enum<string>[]
required

The rails this company can set up now, which is every rail with an approved agreement.

Available options:
us_bank_account,
card
publishable_key
string
required
authorized_bank_account_ids
integer[]
required

Saved company bank accounts whose earlier ACH authorization still applies. Switching debits onto one of these needs no new acceptance.

Required range: x >= 1
saved_cards
object[]
required

Saved cards other than the one in use, newest first. Their earlier card authorization still applies, so switching onto one needs no new acceptance. The expiry is the one recorded at setup; the switch asks Stripe whether the card can still be charged.

client_secret
string
required
status
integer
required
meta
object
required