> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/what-buyers-see.md).

# What buyers see

Show buyers their credit in the cart, at checkout and in their account, put credit cards on your admin pages, and edit the wording buyers read.

{% hint style="info" %}
**Plan:** Credit limits & net terms are available on the Founding plan.
{% endhint %}

**Limits apply at checkout whether or not you add anything here.** These blocks let buyers *see* their credit before they hit a limit, and let your team see it on admin pages.

Open **Dollarlabs B2B → Credit → Settings → Where buyers see their credit**. The **Add app blocks** page lists each place with a status: **Live**, **Not added** or **Unknown**. Select **Set up** for step-by-step instructions.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-5d0c5b5af6855829def5e6cce1392a3330f6c5b6%2Fcredit-blocks-page-annotated.png?alt=media" alt="Where buyers see their credit page with Credit status, Credit status at checkout (Shopify Plus), Credit &#x26; statements and Credit summary on customer pages, each with a Set up button."><figcaption><p>Each place a buyer can see their credit, and whether you have set it up.</p></figcaption></figure>

| Place                                | Where                                            | Needs                                                                          |
| ------------------------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------ |
| **Credit status**                    | Cart drawer and cart page                        | Theme app embed                                                                |
| **Credit status at checkout**        | Checkout                                         | Shopify Plus                                                                   |
| **Credit & statements**              | A page in the buyer's customer account           | Add the page in the accounts editor, then link it in the customer account menu |
| **Credit summary on customer pages** | Your admin: customer, company and location pages | Pinning the block on each page type                                            |

The app detects the cart embed on your published theme. For the other three, Shopify doesn't always tell the app where blocks are placed. If a status doesn't update, mark it as set up yourself on its **Set up** page.

## Cart card (Credit status)

A card in the cart drawer and on the cart page that shows a signed-in buyer their credit: **Already used**, **This order** and **Left after**, with a meter. It updates as they change quantities. It shows only to signed-in buyers who have a limit.

To turn it on:

1. In Shopify admin, go to **Online Store → Themes**, and on your published theme choose **⋯ → Customize**.
2. Open **App embeds** at the bottom-left of the sidebar.
3. Find **Credit status in cart** and switch it on.
4. Select **Save**. It applies to every page at once; there's nothing to place.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-a76bd4ba1c9ce3d870a600739a41dc1c852c8e3c%2Fstore-cart-states-annotated.png?alt=media" alt="Three cart credit cards: Credit available with $300 left after the order; a warning that the buyer is close to their limit; and Order blocked with the Check out button turned off."><figcaption><p>The cart card when credit is available, near the limit and over it.</p></figcaption></figure>

| State                | Headline              | Default message                                                                       |
| -------------------- | --------------------- | ------------------------------------------------------------------------------------- |
| Room left            | Credit available      | Credit available after this order: {available\_limit\_post\_order} of {total\_limit}. |
| Warning rule matches | Heads up              | This order leaves {available\_limit\_post\_order} of {total\_limit} credit.           |
| Payment rule matches | Full payment required | Full payment is required for this order.                                              |
| Over the limit       | Order blocked         | This order exceeds your available credit ({available\_limit} of {total\_limit}).      |
| On hold              | Account on hold       | Your account is on hold. Please contact us to place orders.                           |

When the order is over the limit or the account is on hold, the card also disables the cart's checkout button. To let buyers reach checkout and be refused there instead, open **Set up** on **Credit status** in the app and untick **Disable checkout when the order is over the limit**. Shopify refuses the order at checkout either way.

{% hint style="info" %}
**The cart card uses the cart subtotal. Checkout uses the total with shipping and tax.** A cart that fits on the card can still be refused at checkout. The card tells buyers so: "Your limit is checked against the final total, including shipping and tax."
{% endhint %}

## At checkout

### The checkout error

This is the actual limit check. It needs no setup. When an order is refused, Shopify checkout shows one of these:

| Why                       | Default text                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------- |
| Account on hold           | Your account is on hold. Please contact us to place orders.                                             |
| A Block rule matches      | The rule's message, or "This order is blocked by a credit rule."                                        |
| Over the customer's limit | This order exceeds your available credit. Available {available\_limit}, order total {order\_total}.     |
| Over the location's limit | This order exceeds the location credit limit. Available {available\_limit}, order total {order\_total}. |
| Over the company's limit  | This order exceeds the company credit limit. Available {available\_limit}, order total {order\_total}.  |

Amounts in this error show as a number and currency code, for example "1800.00 USD".

### Checkout block (Shopify Plus)

On Shopify Plus, the **Credit status** checkout block shows the buyer's credit during checkout, and is the only way to show a **Warn** rule's message in checkout.

1. In Shopify admin, go to **Settings → Checkout → Customize**.
2. Add **Credit status** from the app section, where you want it.
3. Select **Save**. If the app's **Set up** page doesn't show the block as **Live** by itself, select **Mark as set up** there.

| State                | Heading               | Text                                                                                   |
| -------------------- | --------------------- | -------------------------------------------------------------------------------------- |
| Room left            | Credit available      | {available\_limit} of {total\_limit} credit available.                                 |
| Warning rule matches | Heads up              | Heads up — this order leaves {available\_limit\_post\_order} of {total\_limit} credit. |
| Payment rule matches | Full payment required | Full payment is required for this order.                                               |
| Over the limit       | Order blocked         | This order exceeds your available credit ({available\_limit} of {total\_limit}).       |
| On hold              | Account on hold       | Your account is on hold. Please contact us to place orders.                            |

The block is for information only. The checkout error above is what actually refuses the order.

## Credit & statements (customer account page)

A page in the buyer's customer account with their credit and full history. It needs the current Shopify customer accounts, not legacy accounts. Setting it up takes two parts: add the page in the accounts editor, then link it from the account menu.

{% hint style="danger" %}
**Both parts are required.** A menu link alone is not enough. Until the page is added in the accounts editor, buyers see "There's a problem loading this page" when they open **Credit & statements**.
{% endhint %}

#### Part 1: Add the page in the accounts editor

1. In Shopify admin, go to **Settings → Customer accounts**.
2. Under **Configurations**, select **Customize**. The checkout and accounts editor opens.
3. Select the **Apps** icon in the editor's left toolbar.
4. Under **Dollarlabs B2B → Credit**, find **Credit & statements** and select **⊕**. Then select **Add page to → Accounts**.
5. Select **Save**. If Shopify asks you to save before you add the page to navigation, select **Save** again.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-17d9496c107dcb680e5bbd60cf761b4fbd9be59d%2Fcredit-accounts-editor-apps-annotated.png?alt=media" alt="Checkout and accounts editor, Apps panel: under Dollarlabs B2B, Credit status, Credit &#x26; statements and My quotes each show a check mark." width="347"><figcaption><p>A check mark next to <strong>Credit &#x26; statements</strong> means the page is added.</p></figcaption></figure>

#### Part 2: Link the page in the customer account menu

The quickest way is from the accounts editor, right after Part 1:

1. In the editor's notice, select **Add to menu**. Shopify opens the customer account menu your buyers see, with a new item already linked to **Credit & statements**.
2. Type a label, such as `Credit & statements`.
3. Select **Save**. The app's **Set up** page usually finds the link by itself. If it doesn't, select **I've added the link — mark as done**.

To do it from the menu list instead:

1. In Shopify admin, go to **Content → Menus**.
2. Open your customer account menu. It is called **Customer account main menu**, or **Store default: Customer account main menu**.
3. Select **Add menu item**, type a label, then in the **Link** field open **Apps** and pick **Credit & statements**.
4. Select **Save**.

{% hint style="warning" %}
**Do you see both menus in Content → Menus?** Buyers see only one of them. Use **Add to menu** in the accounts editor: it always opens the menu your buyers see.
{% endhint %}

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-adf9cc8ba749b4b64f0fd6d391122648d06697b4%2Fcredit-accounts-menu-item-annotated.png?alt=media" alt="Customer account main menu with Orders, Profile, My quotes and a new item labelled Credit &#x26; statements linked to the Credit &#x26; statements app page." width="552"><figcaption><p>The new menu item: the label buyers see, and the app page it opens.</p></figcaption></figure>

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-4e101b00a4b29164b5d6ce036feeac23e480edf5%2Fcredit-accounts-credit-page-live-annotated.png?alt=media" alt="Customer account with Credit &#x26; statements in the menu and the page showing Credit summary and Financial ledger."><figcaption><p>After both parts, the page appears in the account menu and loads.</p></figcaption></figure>

What buyers see on the page:

* **Credit summary** — **Available to spend**, **Total limit** and **Used**, with a badge when they're days past due. Company buyers can switch between **Individual**, **Company** and **Location** when those limits are set and not [hidden from buyers](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/set-up-credit-limits.md#hide-a-company-or-location-limit-from-buyers).
* **Payment summary** — **Amount due** and **Due date**, or "Nothing due — you're all paid up."
* **Account summary** — **Total purchases**, **Total payments**, **Order count**.
* **Financial ledger** — every order, payment, refund and adjustment, filterable by **All**, **Charges** and **Payments**.
* **Download statement (CSV)** — the buyer's own ledger as a spreadsheet.

{% hint style="info" %}
**The statement and ledger show the buyer's own entries.** An adjustment you post only on a company or location doesn't appear there. Post it on the contact as well. See [Adjust balance](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/set-up-credit-limits.md#adjust-balance).
{% endhint %}

A held account sees "Account on hold" at the top of the page, even if its limits are hidden.

## Credit cards on your admin pages

The **Credit** card shows your team an account's credit on its Shopify admin page: **Available to spend**, used of limit with a bar, days past due, any hold, and which limit is tightest. **Manage credit** opens the app's Limits page.

Shopify asks you to pin admin blocks once per page type:

1. Open any customer in your admin (**Customers** → pick one).
2. Scroll to the **Blocks** section near the bottom and choose **Add block**.
3. Pick **Credit summary (customer)** from this app's list, then use the pin icon to keep it on the page.
4. Repeat on a **company** page (**Credit summary (company)**) and a **location** page (**Credit summary (location)**).

Once pinned, every page of that type shows it.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-8a3358016e288a51c6d100f1da26b1216133f852%2Fcredit-admin-card-annotated.png?alt=media" alt="Credit card on a Shopify customer page showing $350.00 available to spend, $150.00 used of $500.00, the tightest limit and a Manage credit button." width="722"><figcaption><p>The Credit card on a customer page in Shopify admin.</p></figcaption></figure>

There's no credit card on the order page. Orders that went over a limit carry the [order tags](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/review-orders-and-activity.md#order-tags) `credit-over-limit` or `credit-requires-payment` instead.

## What buyers read

Change the default wording under **Credit → Settings → What buyers read about their credit**. Each field starts with the built-in wording; clear it to go back. Select a variable chip to insert the buyer's real figures.

| Section                   | Where it shows                   | Default                                                                                                  |
| ------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Credit available**      | Green cart card                  | Credit available / Credit available after this order: {available\_limit\_post\_order} of {total\_limit}. |
| **Heads up**              | Amber cart card                  | Heads up / This order leaves {available\_limit\_post\_order} of {total\_limit} credit.                   |
| **Order blocked**         | Red cart card                    | Order blocked / This order exceeds your available credit ({available\_limit} of {total\_limit}).         |
| **Over the credit limit** | The checkout error (no headline) | This order exceeds your available credit. Available {available\_limit}, order total {order\_total}.      |
| **Account on hold**       | Cart, checkout and account page  | Account on hold / Your account is on hold. Please contact us to place orders.                            |

A rule's own message wins over **Order blocked** and **Heads up**. In **Account on hold** you can use `{outstanding}` and `{days_past_due}`.

Unedited fields stay translated into each buyer's language. Once you edit a field, your text shows in every language. Select **Save** in the bar at the top; the page doesn't show a confirmation, so check the **Settings** list, which shows how many messages you've customised.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-fa4e87fcc713054c47af8a002e1b3274f01199a3%2Fcredit-messages-page-annotated.png?alt=media" alt="What buyers read about their credit page with the Credit available headline and message, and variable chips such as {available_limit}."><figcaption><p>Each message starts with the built-in wording. Variables become the buyer’s real numbers.</p></figcaption></figure>
