> 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/credit-faq.md).

# Credit FAQ & troubleshooting

Answers to common credit questions — why a buyer can't check out, why they don't see their credit, what counts toward a balance, and more.

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

## Checkout

### Why can't a buyer check out, even by card?

Because their order would take them over a credit limit, or their account is on hold. **By default, an over-limit buyer can't place the order by any payment method.** The check doesn't look at how they pay.

Check, in this order:

1. **A hold.** The account page shows **On hold**. A hold on the company or location stops its contacts too.
2. **A Block rule.** For example **Block when an invoice is overdue**.
3. **Each limit.** The customer's own limit (or the global default), the location's and the company's. The checkout error names which one: "your available credit", "the location credit limit" or "the company credit limit".

To let over-limit buyers pay upfront instead, add the **Require payment upfront when over limit** rule. See [Over-limit rules](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/over-limit-rules.md#templates).

### The cart card looked fine, but checkout refused the order

The cart card uses the cart subtotal. Checkout checks the total with shipping and tax. A cart just under the limit can go over once shipping and tax are added.

### A buyer with a $1,500 limit and nothing owed can't place an $1,800 order

That's expected. A limit also caps the size of a single order, whatever the payment method. Raise the limit, or add a rule that lets the order through.

### Can buyers add to cart while over their limit?

Yes. The check runs only at checkout. A held or over-limit buyer can still change or empty their cart.

### I raised a customer's limit, but they're still refused

A lower limit above them wins. If Ana's own limit is $8,000 and her location's is $6,000, she can owe only $6,000. The Limits table shows **capped by** and the parent's name. Raise the location or company limit instead.

### Why does the checkout error show "1800.00 USD" instead of "$1,800.00"?

Shopify shows the checkout error with a number and currency code. The cart card, checkout block and account page use your store's money format.

## What buyers see

### Why does a buyer see no credit card in their cart?

* The **Credit status in cart** app embed isn't switched on in your published theme. See [Cart card](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/what-buyers-see.md#cart-card-credit-status).
* The buyer isn't signed in.
* The buyer has no limit: no limit of their own, no company or location limit, and no global default that applies to them.
* The buyer was tagged or given a limit a moment ago. Select **Sync now** on the Overview.

### A warning rule matches, but the buyer sees nothing at checkout

Warnings show in the cart card. In checkout they show only in the checkout block, which needs Shopify Plus. See [Checkout block](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/what-buyers-see.md#checkout-block-shopify-plus).

### The buyer's Credit & statements page shows an error

* "This is a preview — credit appears once a buyer signs in…" — you're looking at it in the editor. Sign in as a test buyer to see real figures.
* "Credit data can't load yet — the app is missing Shopify's customer data permission on this store…" — contact us.
* The page isn't added in the accounts editor, or the menu link is missing. Both are needed. See [Credit & statements](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/what-buyers-see.md#credit-and-statements-customer-account-page). It needs the current customer accounts, not legacy accounts.

### An adjustment I posted on the company doesn't show in the buyer's statement

The statement shows the buyer's own entries. Post the adjustment on the contact too. See [Adjust balance](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/set-up-credit-limits.md#adjust-balance).

## Balances

### What counts toward a balance?

| Event                            | Effect                                                            |
| -------------------------------- | ----------------------------------------------------------------- |
| Order placed on terms            | Adds the full order total, shipping and tax included              |
| Payment recorded in Shopify      | Takes the payment off                                             |
| Refund or order edit             | Brings the order back in line with what Shopify says is still due |
| Order cancelled                  | Takes off the part still unpaid                                   |
| Adjust balance / balances import | Adds or takes off the amount you post                             |

An order is "on terms" when it has Shopify payment terms, or when the customer carries one of your [net-term tags](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/net-terms.md). Other orders don't count, and neither do orders without a customer.

### Why is one company order counted three times?

A company order counts against the contact, the location and the company — the full total at each level — so each limit can be checked. The ledger shows three entries. The Overview's **Outstanding** counts it once.

### Orders placed before I set up credit aren't counted

The app starts counting once you save your first limit, rule, hold or net-term tag. It doesn't go back through older orders. Import what buyers already owe as [opening balances](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/import-and-export.md#opening-balances).

### A tagged customer paid by card. Why did the order show on their credit?

Every order from a customer with a net-term tag counts on credit. The card payment is taken off again as soon as Shopify captures it, so the balance ends where it started.

### Do draft orders count?

Yes, when the draft order has payment terms or the customer has a net-term tag. For an order you complete yourself in admin, the app checks the limit after the order is created. If it puts the account over, the order goes to [Needs review](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/review-orders-and-activity.md#needs-review).

### What about orders in another currency?

Limits and balances are in your store's currency. An order in another currency is converted at that order's own exchange rate, and its payments at the same rate. The checkout check uses Shopify's current rate.

The checkout block may show a foreign-currency cart as using no credit until your store has had one order in that currency. The checkout check itself isn't affected.

### Days past due didn't change today

**Days past due** is the age of the oldest unpaid invoice. The figure that rules use at checkout updates overnight, and whenever the account changes. So a **Block when an invoice is overdue** rule can start up to a day later than you expect. An invoice **due on fulfillment** is never overdue before it ships.

## Review and payment

### Does Needs review stop the order from shipping?

No. The app doesn't hold fulfilment. Hold the order's fulfilment in Shopify if you don't want it to ship before you decide. Find these orders by the tags `credit-over-limit` and `credit-requires-payment`. See [Review orders](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/review-orders-and-activity.md#your-three-choices).

### Does Cancel order refund the buyer?

No. It cancels and restocks the order and takes the unpaid part off the balance. Refund anything already paid in Shopify.

### Does Approve order raise the limit?

No. It accepts that one order. The account stays over its limit, so their next order is refused until they pay down.

## Setup

### Do I need Shopify B2B companies?

No. Without companies, give customers a [net-term tag](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/net-terms.md#tag-based-net-terms) and a limit (their own, or the global default).

### Does the app create payment terms in Shopify?

No. Set payment terms on company locations in Shopify. For tagged buyers, offer a way to check out without paying, such as a manual payment method.

### Is the global default applied to all my customers?

No. Only to buyers on terms who have no limit of their own: customers with a net-term tag, and contacts at locations with payment terms. Retail customers, companies and locations never get it.

### A customer has two net-term tags. Which one applies?

The one you created first in the app. Keep one net-term tag per customer.
