Account Collection Flows

An account_collection_flow is an object that can be used to embed a pre-built Account Collection UI in your application. The properties configured on the account_collection_flow dictate which fields to collect from your end-user. Account collection flows currently only support collecting domestic US account information, but in the future, global payments will be supported.

Check out our Embed Account Collection guide to learn how to embed this pre-built UI in your application.

AttributeDescription
id
string
The ID of the account collection flow.
client_token
string
The client token of the account collection flow. This token is used to embed an account collection UI in your client-side application.
status
string
One of pending, completed, expired, or cancelled.

The current status of the account collection flow.
counterparty_id
string
The ID of a counterparty. An external account created with this flow will be associated with this counterparty.
external_account_id
string
If present, the ID of the external account created using this flow.
payment_types
array
An array of payment types. An external account created with this flow must support ALL of these payment types. Note this is currently restricted to domestic US rails (ach, wire or check).
{
  "id": "454e874b-ff1d-46e8-9d22-0464615cf1e0",
  "object": "account_collection_flow",
  "live_mode": true,
  "client_token": "ac-live-QVj2yTSt6qRNAzXQGKLHS9qfLF7Gs5JcCYHT5xztgjucGRbS6VfrJBpaNo5SrmfZ",
  "status": "pending",
  "payment_types": ["ach"],
  "counterparty_id": "c03581a8-c948-41a9-889a-e5228390fd80",
  "external_account_id": null,
  "created_at": "2023-02-18T03:23:48Z",
  "updated_at": "2023-02-18T03:23:48Z"
}