Guides

Accounts Overview

Overview of our Accounts model.

Suggest Edits

Bond's account-centric model allows you to build features on top of ledger-accounts. Accounts can be used to store value (such as USD). Accounts are a flexible way for you to segment and control stored value. Accounts provide features, such as transfers (ACH and internal account-to-account), balance management, double-entry accounting using ISO-8583, and statement data.

The Accounts model is polymorphic via the type key. This uses inheritance in the JSON API structure to allow for multiple types of accounts. As our platform scales, we will be using this to add different types of accounts in the future. The example below illustrates our two current basic account types, deposit and credit accounts

{
    "account_id": "a2cbc90c-caeb-4137-8d95-3d1b64c10628",
    "date_updated": "2022-07-08T16:44:20.179543Z",
    "date_created": "2022-07-08T16:44:20.179543Z",
    "program_id": "84183869-461e-4e96-86b5-45b824aae569",
    "customer_id": "842ebd28-6d86-4d05-9630-b12cf9278875",
    "type": "deposit",
    "status": "active",
    "routing_number": "014175741",
    "account_number": "61286758183945",
    "description": "My First Deposit Account",
    "balance": {
        "previous_statement_balance": 97495,
        "available_balance": 97495,
        "current_balance": 97495,
        "currency": "USD"
    },
    "cards": [],
    "deposit": {}
}

{
  "account_id": "ed3dc85e-c3e8-4076-802f-56da7d5d66e2",
  "date_updated": "2022-07-08T16:44:20.179543Z",
  "date_created": "2022-07-08T16:44:20.179543Z",
  "program_id": "0adea755-90d3-47f4-9d44-4b73cbebaf3c",
  "customer_id": "db39e8e9-849d-435a-842c-7f4b3a49c5b3",
  "type": "credit",
  "status": "active",
  "description": "string",
  "routing_number": "547897762",
  "account_number": "574771265",
  "balance": {
      "current_balance": -500,
      "available_balance": -500,
    	"previous_statement_balance": 0,
    	"locked_balance": 0,
      "currency": "USD"
  },
  "credit": {
      "credit_limit": 10000,
      "security_deposit_account_id": "182c3a25-69e8-4e16-b1bc-7211fcc2583d"
  },
  "cards": [
      "6c65c025-40bf-48cd-93dd-169dbfd95659"
  ]
}

{
    "account_id": "c858b30f-83a3-4c9b-b476-b16e212b96c4",
    "program_id": "cf436dab-68c2-4934-b104-0e98aa314d6f",
    "customer_id": "1e4bfc12-63c5-4269-bb52-4fa93c971dd1",
    "description": "Security Deposit Account",
    "date_updated": "2023-06-29T19:12:44.097360Z",
    "date_created": "2023-06-29T19:12:44.097354Z",
    "type": "security_deposit",
    "status": "active",
    "routing_number": "123456789",
    "account_number": "1234567892838563",
    "balance": {
        "previous_statement_balance": 200000,
        "current_balance": 250000,
        "available_balance": 240000,
        "locked_balance": 500,
        "currency": "USD"
    },
    "security_deposit": {
        "credit_account_id": "387e10f2-c7d3-45f1-80e2-a6941576df6b",
        "all_credit_account_ids": [
          	"387e10f2-c7d3-45f1-80e2-a6941576df6b"
        ]
    },
    "cards": []
}

Notice the object deposit and credit which are derived by the account type. Each account will have a corresponding object of it's name within the Account API model. This allows for account-specific data to be provided in the API response.

❗️

External Accounts

Linking an external account is currently only supported by our v0 APIs.

Updated over 1 year ago

Next Steps