> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Balances

> Learn what balances are and how they work.

export const CtaCallout = props => {
  const {title, buttonLabel, href, trackingEvent, buttonTarget, rel = "noopener noreferrer", children} = props;
  const handleCtaClick = () => {
    if (typeof window === "undefined" || !trackingEvent) {
      return;
    }
    try {
      window.dispatchEvent(new CustomEvent("blnk:docs-cta", {
        detail: {
          name: trackingEvent,
          href
        }
      }));
    } catch {}
    try {
      window.posthog?.capture?.(trackingEvent, {
        href
      });
    } catch {}
    const gaPayload = {
      cta_href: href
    };
    try {
      window.gtag?.("event", trackingEvent, gaPayload);
    } catch {}
    try {
      window.dataLayer = window.dataLayer || [];
      window.dataLayer.push({
        event: trackingEvent,
        ...gaPayload
      });
    } catch {}
  };
  const isExternal = typeof href === "string" && (/^https?:\/\//i).test(href);
  const target = buttonTarget ?? (isExternal ? "_blank" : undefined);
  const linkRel = isExternal ? rel : undefined;
  return <section className="cta-callout not-prose relative my-8 w-full min-w-0 overflow-hidden rounded-xl border border-zinc-200 p-5 dark:border-white/10">
      <div className="cta-callout-noise" aria-hidden="true" />
      <div className="cta-callout-layout">
        {title ? <div className="cta-callout-title-row">
            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 28 28" width="14" height="14" className="cta-callout-icon shrink-0 text-zinc-800 dark:text-zinc-200" aria-hidden="true">
              <g fill="none" fillRule="nonzero">
                <path d="M28 0v28H0V0h28ZM14.691833333333335 27.134333333333334l-0.012833333333333334 0.0023333333333333335 -0.08283333333333333 0.04083333333333334 -0.023333333333333334 0.004666666666666667 -0.016333333333333335 -0.004666666666666667 -0.08283333333333333 -0.04083333333333334c-0.011666666666666667 -0.004666666666666667 -0.022166666666666668 -0.0011666666666666668 -0.028000000000000004 0.005833333333333334l-0.004666666666666667 0.011666666666666667 -0.019833333333333335 0.49933333333333335 0.005833333333333334 0.023333333333333334 0.011666666666666667 0.015166666666666667 0.12133333333333333 0.08633333333333333 0.0175 0.004666666666666667 0.014000000000000002 -0.004666666666666667 0.12133333333333333 -0.08633333333333333 0.014000000000000002 -0.018666666666666668 0.004666666666666667 -0.019833333333333335 -0.019833333333333335 -0.4981666666666667c-0.0023333333333333335 -0.011666666666666667 -0.0105 -0.019833333333333335 -0.019833333333333335 -0.021Zm0.3091666666666667 -0.13183333333333336 -0.015166666666666667 0.0023333333333333335 -0.21583333333333335 0.1085 -0.011666666666666667 0.011666666666666667 -0.0035000000000000005 0.012833333333333334 0.021 0.5016666666666667 0.005833333333333334 0.014000000000000002 0.009333333333333334 0.008166666666666668 0.23450000000000004 0.1085c0.014000000000000002 0.004666666666666667 0.026833333333333334 0 0.03383333333333334 -0.009333333333333334l0.004666666666666667 -0.016333333333333335 -0.03966666666666667 -0.7163333333333334c-0.0035000000000000005 -0.014000000000000002 -0.011666666666666667 -0.023333333333333334 -0.023333333333333334 -0.025666666666666667Zm-0.8341666666666667 0.0023333333333333335a0.026833333333333334 0.026833333333334334 0 0 0 -0.0315 0.007000000000000001l-0.007000000000000001 0.016333333333333335 -0.03966666666666667 0.7163333333333334c0 0.014000000000000002 0.008166666666666668 0.023333333333333334 0.019833333333333335 0.028000000000000004l0.0175 -0.0023333333333333335 0.23450000000000004 -0.1085 0.011666666666666667 -0.009333333333333334 0.004666666666666667 -0.012833333333333334 0.019833333333333335 -0.5016666666666667 -0.0035000000000000005 -0.014000000000000002 -0.011666666666666667 -0.011666666666666667 -0.21466666666666667 -0.10733333333333334Z" strokeWidth="1.1667" />
                <path fill="currentColor" d="M14 2.916666666666667A1.75 1.75 0 0 1 15.750000000000002 4.666666666666667v6.302333333333334L21.207666666666668 7.816666666666667a1.75 1.75 0 0 1 1.75 3.031L17.5 14l5.457666666666667 3.151166666666667a1.75 1.75 0 0 1 -1.75 3.031l-5.457666666666667 -3.1500000000000004V23.333333333333336a1.75 1.75 0 0 1 -3.5 0v-6.302333333333334L6.792333333333334 20.183333333333337a1.75 1.75 0 1 1 -1.75 -3.031L10.5 14 5.042333333333334 10.848833333333333a1.75 1.75 0 0 1 1.75 -3.031l5.457666666666667 3.1500000000000004V4.666666666666667A1.75 1.75 0 0 1 14 2.916666666666667Z" strokeWidth="1.1667" />
              </g>
            </svg>
            <p className="cta-callout-title min-w-0 font-semibold text-zinc-800 dark:text-zinc-200">
              {title}
            </p>
          </div> : null}
        <div className={`cta-callout-body text-sm leading-normal text-zinc-800 dark:text-zinc-200${title ? " cta-callout-body--indented" : ""}`}>
          {children}
        </div>
        <a href={href} target={target} rel={linkRel} onClick={handleCtaClick} data-docs-cta={trackingEvent || undefined} className="cta-callout-button inline-flex items-center justify-center gap-1 rounded-full bg-white px-3 py-1.5 text-sm font-semibold transition hover:bg-zinc-100 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-white/50 dark:bg-white dark:hover:bg-zinc-200">
          {buttonLabel}
          <span className="cta-callout-button-arrow" aria-hidden="true">
            →
          </span>
        </a>
      </div>
    </section>;
};

Balances represent stores of value in your ledger. They can be bank accounts, wallets, cards, store points, finance accounts, and more. When recording transactions, balances specify the source (where the amount comes from) and destination (where the amount goes to).

There are two types of balances in Blnk:

* [Internal balances](/balances/internal-balances): Balances grouped in the General Ledger and identified with the `@` icon indicator in your workspace.

* Application balances: Balances that you or your application create. Each has a unique balance ID and can be linked to identities on Cloud.

***

## Create balances

To create a new balance:

<Steps>
  <Step title="Open the create balance flow">
    Go to `Balances`. In the top-right corner of the table, click `Create balance`, or press `⌥ + B` (`Alt + B` on Windows).

    <Frame>
      <img src="https://mintcdn.com/blnk/4bG_EwgREaz5d5o1/cloud/img/balances/create-balance-open.png?fit=max&auto=format&n=4bG_EwgREaz5d5o1&q=85&s=99a2bd61b1fd949a063ee246cdfa35ee" alt="Balances table with the Create balance control in the header" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/create-balance-open.png" />
    </Frame>
  </Step>

  <Step title="Choose a ledger">
    Select the ledger where the balance should live. Type the ledger name and pick it from the dropdown, or paste the ledger ID.

    <Frame>
      <img src="https://mintcdn.com/blnk/4bG_EwgREaz5d5o1/cloud/img/balances/create-balance-ledger.png?fit=max&auto=format&n=4bG_EwgREaz5d5o1&q=85&s=6dbad8f29ff4cf949fc23ac36f623fe4" alt="Create balance form with the ledger field selected" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/create-balance-ledger.png" />
    </Frame>

    Application balances usually live in a ledger such as `Customer Wallets`, not the General Ledger.
  </Step>

  <Step title="Enter the currency">
    Enter the currency for the balance:

    * Use the ISO 4217 code for fiat currencies.
    * Use the ticker symbol for crypto.
    * Use a unique identifier for custom assets.

    <Frame>
      <img src="https://mintcdn.com/blnk/4bG_EwgREaz5d5o1/cloud/img/balances/create-balance-currency.png?fit=max&auto=format&n=4bG_EwgREaz5d5o1&q=85&s=36f3c78e44272ff26d323a06533d9d17" alt="Create balance form with the currency field filled in" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/create-balance-currency.png" />
    </Frame>
  </Step>

  <Step title="Enable lineage tracking (optional)">
    Under `Advanced options`, enable `Enable lineage tracking` to tag incoming funds and track how they are spent over time.

    * Select `Allocation` (for example, `FIFO`) to control how tagged funds are used when the balance is debited.
    * Enabling lineage automatically turns on `Assign an owner to this balance`. Choose an identity in the next step.

    <Frame>
      <img src="https://mintcdn.com/blnk/QE3MtslbSNhotdzX/cloud/img/balances/create-balance-lineage.png?fit=max&auto=format&n=QE3MtslbSNhotdzX&q=85&s=d44eadcebcd6b644d738d8fda029b338" alt="Create balance form with Enable lineage tracking, Allocation, and Assign an owner enabled" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/create-balance-lineage.png" />
    </Frame>
  </Step>

  <Step title="Assign an owner (optional)">
    To link the balance to an identity, enable `Assign an owner to this balance`, then search by name and select from the list, or paste an identity ID. This is required while lineage tracking is enabled.

    <Frame>
      <img src="https://mintcdn.com/blnk/QE3MtslbSNhotdzX/cloud/img/balances/create-balance-assign-identity.png?fit=max&auto=format&n=QE3MtslbSNhotdzX&q=85&s=ebbdc9a9b09ffbed1e524c5af4c8522a" alt="Create balance form with Assign an owner to this balance and Identity selected" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/create-balance-assign-identity.png" />
    </Frame>
  </Step>

  <Step title="Create the balance">
    Click `Create balance`. The new balance appears in the `Balances` table and you can open it for details.

    <Frame>
      <img src="https://mintcdn.com/blnk/4bG_EwgREaz5d5o1/cloud/img/balances/create-balance-result.png?fit=max&auto=format&n=4bG_EwgREaz5d5o1&q=85&s=a612c5676e3b93df0b72dfb2015882ac" alt="Balances table or balance details showing a newly created balance" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/create-balance-result.png" />
    </Frame>
  </Step>
</Steps>

<Tip>To create a balance that is automatically linked to an identity, navigate to the identity details page and click `New > New balance` in the top-right corner.</Tip>

***

## Working with balances

All records in Blnk are immutable. This means that once a balance is created, it cannot be deleted or directly modified.

### Balances table

The `Balances` table shows a list of all balances in your workspace. For each balance, you can see:

<img src="https://mintcdn.com/blnk/4bG_EwgREaz5d5o1/cloud/img/balances/balances-table.png?fit=max&auto=format&n=4bG_EwgREaz5d5o1&q=85&s=f6adbffa24e4aa0a703a1836ecffcb1d" alt="Balances table showing all balance information" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/balances-table.png" />

* `Currency`: The type of asset being stored.
* `Balance`: The actual balance amount.
* `Inflight balance`: The net amount waiting to be added or deducted from the balance.
* `Owner`: The identity the balance is linked to, or its indicator if it is an internal balance. Application balances with no linked identity are empty.
* `Created at`: The date and time the balance was created.

<Tip>Click the `Refresh` button on the `Balances` table to get the latest balance data from your instance.</Tip>

### View balance details

Click a balance to see its summary details, including the balance amount, currency, health, etc.

<img src="https://mintcdn.com/blnk/QE3MtslbSNhotdzX/cloud/img/balances/balance-details-full-info-quick-actions.png?fit=max&auto=format&n=QE3MtslbSNhotdzX&q=85&s=896a99d86d5a33e30882ef95e39aeae3" alt="Balance details page showing Full info and Quick Actions with View transactions" className="rounded-lg" width="1366" height="768" data-path="cloud/img/balances/balance-details-full-info-quick-actions.png" />

For a complete view, select `Full info` in the top-right corner of the summary or press `E` to expand the details.

To view all transactions performed on the balance, go to the `Quick Actions` section at the bottom of the summary and click `View transactions`.

***

## Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).

<CtaCallout title="Need help with your product?" href="https://blnkfinance.com/contact/us?utm_source=blnk_docs&utm_medium=documentation&utm_campaign=home%2Finstall" buttonLabel="Speak with us" trackingEvent="clicked_pro_support">
  Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.
</CtaCallout>
