> 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/review-orders-and-activity.md).

# Review orders & activity

Decide on orders that went through over a credit limit, find them by order tag, and follow every charge and payment in the ledger and trends.

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

Open **Dollarlabs B2B → Credit → Activity**. It has three tabs: **Needs review**, **Trends** and **Ledger**.

## Needs review

An order lands in **Needs review** when it was placed even though it put an account over its limit. That happens when:

* a [rule](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/over-limit-rules.md#let-these-orders-through) with **Let these orders through even when over the limit** matched at checkout,
* an order was edited afterwards and its total went up,
* two checkouts from the same account landed at once, or
* you completed an order with payment terms yourself in admin, for example from a draft order.

When orders are waiting, the Credit pages show a red banner: "{n} orders waiting on a credit decision", with **Review orders**. You also get the **Needs review** email.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-8f4701fd1a6acc0136aa24237dd19b202f69cdaf%2Fcredit-review-open-annotated.png?alt=media" alt="Needs review tab with order #1005 for Cleo Marsh, over by USD 1400.00, and the Cancel order, Require payment and Approve order buttons."><figcaption><p>Orders waiting on a credit decision.</p></figcaption></figure>

### The queue

| Tab                  | Holds                                                              |
| -------------------- | ------------------------------------------------------------------ |
| **Open**             | Orders waiting on your decision                                    |
| **Payment required** | Orders you've asked to be paid in full, until they are             |
| **Resolved**         | Orders that were paid, approved or cancelled, with the **Outcome** |

**Over by** shows how far over the limit the account is now. After a payment it can read "Within limit now", or "Paid {x} of {y}". **Waiting** turns amber after 4 hours and red after 24 hours.

### Your three choices

| Action              | What it does                                                                                                                                          | What it doesn't do                                                                                                   |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Cancel order**    | Cancels the order in Shopify and restocks the items. The unpaid part of the order comes off the balance. The buyer gets the **Review decision** email | **Doesn't refund** anything already paid. Shopify doesn't send its own cancellation email. Can't be undone from here |
| **Require payment** | Adds the order tag `credit-requires-payment` and moves the order to **Payment required**. The buyer gets the **Review decision** email                | **Doesn't collect payment** or send an invoice. Collect payment for the order in Shopify                             |
| **Approve order**   | Accepts the order as it is, this once. The buyer gets the **Review decision** email                                                                   | **Doesn't change the limit.** The account stays over its limit, so their next order is refused until they pay down   |

Tick several rows to apply one action to all of them.

{% hint style="danger" %}
**The app doesn't hold fulfilment.** An order in **Needs review** or **Payment required** can still be fulfilled and shipped like any other order — even though the banner says "Nothing ships until you approve or decline." If you don't want these orders to ship before you decide or before they're paid, hold their fulfilment in Shopify on the order page. Filter your orders by the [tags below](#order-tags) to find them.
{% endhint %}

If a buyer had already paid part of an order you cancel, refund it in Shopify yourself.

### How orders leave the queue on their own

* **Paid in full** — when Shopify marks the order paid, it moves to **Resolved** and both order tags are removed. This applies to **Open** and **Payment required** orders.
* **Back under limit** — when a payment brings the account back under its limit, **Open** orders resolve. **Payment required** orders stay until they're paid in full, approved or cancelled.
* **Cancelled** — cancelling the order in Shopify also resolves it.

### Order tags

Orders that went over a limit carry a Shopify order tag, so you can find them in **Orders** with a tag filter:

| Tag                       | Added when                          |
| ------------------------- | ----------------------------------- |
| `credit-over-limit`       | The order lands in **Needs review** |
| `credit-requires-payment` | You select **Require payment**      |

## Ledger

**Activity → Ledger** lists every entry behind every balance: each order charged to credit, each payment, refund, cancellation, edit and adjustment.

| Filter         | Options                                                                                                                        |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Date range** | **Last 30 days** (default), **Last 90 days**, **Last year**, **All time**                                                      |
| **Event**      | **Order placed**, **Payment received**, **Partial payment**, **Refund**, **Order cancelled**, **Adjustment**, **Order edited** |
| **Type**       | **Charges**, **Payments**                                                                                                      |
| **Scope**      | **Company**, **Location**, **Customer**                                                                                        |
| **Sort**       | **Newest first**, **Oldest first**, **Largest amount**, **Smallest amount**                                                    |

Charges show as `+`, payments as `−`. The **Order** column shows Shopify's numeric order ID (for example `#5893421203522`), not the order name such as `#1001`. **Export CSV** downloads the entries that match your filters.

A company order appears three times — once each for the contact, the location and the company — because it counts at each level.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f49ed71a71864d3b999f2d63ea20c373841bb596%2Fcredit-ledger-annotated.png?alt=media" alt="Ledger with filters for date range, events, types, scopes and sort, and rows for payments received and orders placed on Net 30 payment terms or a net30 tag."><figcaption><p>Every charge and payment, with filters.</p></figcaption></figure>

For one account's history with a running balance, open its [account page](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/set-up-credit-limits.md#the-account-page).

## Trends

**Activity → Trends** shows how credit is used over time:

* **Charged to credit**, **Collected** and **Avg time to pay**
* **Credit charged over time** — a bar chart, from **Last 7 days** to **All time**, or a **Custom range**
* **Who owes what** — outstanding by **Companies**, **Locations** or **Customers**
* **Outstanding balance** — the trend, with the change over the range
* **Biggest spenders** and **Closest to their limit**
* **Recent activity**

**Export ledger** downloads the whole ledger.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-e2c97b4d11c1c0edb617f4158d0b89719b3df521%2Fcredit-trends-annotated.png?alt=media" alt="Trends page with Charged to credit, Collected and Avg time to pay, charts of credit charged and outstanding balance, and Closest to their limit with two accounts over limit."><figcaption><p>Trends show what was charged, collected and is still owed.</p></figcaption></figure>

## Sync health

Balances that buyers see — in the cart, at checkout and in their account — are kept in step with the ledger in the background. The **Sync health** card on the **Overview** shows whether that is current:

* **Up to date** — "Credit data last synced {x} ago".
* **Sync is behind** — checkout may be using balances from an earlier time.
* **Not synced yet** — balances sync after the first credit order.

Select **Sync now** to rebuild them for every buyer with a limit. You see "Sync started", then "Balances synced". If the card stays behind, contact us.

A full sync also runs every night. That's when **days past due** move on by a day — see the [FAQ](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/credit/credit-faq.md#days-past-due-didnt-change-today).
