> 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/dollarback-store-credit/analytics-data-and-account/admin-blocks-customer-and-order-pages.md).

# Admin blocks on the customer & order pages

DollarBack puts two cards directly inside Shopify admin, so you can answer "what did DollarBack do on this order?" and "why did this customer earn less than expected?" without opening the app. Both are installed with the app; there is nothing to enable.

## "DollarBack summary" on the order page

Open **Shopify admin → Orders** and pick any order. The **DollarBack summary** card sits among the app blocks on the order detail page and shows every way DollarBack touched that order:

| Row                | What it shows                                                                                                                                                                                               |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cashback**       | Store credit issued for this order, with a **Pending** badge while the credit is still scheduled and **Credited** once it lands. A badge like "2× tier" appears when a loyalty tier multiplier was applied. |
| **Redeemed**       | Store credit the customer spent paying for this order.                                                                                                                                                      |
| **No cashback**    | Shown instead of Cashback when the order earned nothing, with the reason recorded at calculation time.                                                                                                      |
| **Discount codes** | Earn-side reward codes issued from this order, with "(revoked)" appended if a code was later revoked.                                                                                                       |
| **Referral**       | The referrer this order was attributed to, and the commission they earned.                                                                                                                                  |
| **Edited**         | How many times cashback or the referral reward was recalculated after order edits.                                                                                                                          |

Orders DollarBack never touched show "No DollarBack activity on this order."

The card is a read-only view of the data DollarBack writes to the order itself; see [Metafields & data storage reference](/dollarback-store-credit/developer-tools/metafields-and-data-storage.md) if you want to consume the same data in Flow or your own tooling.

## "Store credit owed" on the customer page

Open **Shopify admin → Customers** and pick a customer. The **Store credit owed** card tracks store credit the customer owes you, per currency. As the card's own help text puts it: "Store credit this customer owes you. It's taken back from their future cashback. Set it to 0 to clear it."

### Where owed credit comes from

When a refund, cancellation, or order edit claws back credit the customer has **already spent**, their Shopify balance can't go below zero. DollarBack records the shortfall as owed instead, and automatically deducts it from the customer's **next cashback** before crediting: they earn less until the debt is paid down. See [Refunds, cancellations & order edits](/dollarback-store-credit/spending-store-credit-and-rewards/refunds-cancellations-and-order-edits.md) for when clawbacks happen.

### Clear or reduce an owed balance

1. Edit the amount next to the currency. Set it to **0** to write the debt off entirely, or lower it to forgive part of it.
2. Click **Save**. The customer's next cashback is no longer reduced (or reduced less).

### Add an owed balance manually

Use the bottom row to record a debt yourself, for example after settling something off-platform:

1. Pick a **Currency**. The picker only lists currencies that don't already have an owed amount; to change an existing one, edit its row instead.
2. Enter an **Amount** above 0 and click **Add**.

Every manual change is written into the underlying record as an "admin\_override" entry with a timestamp, so support can always reconstruct who changed what.

## Verify it works

1. Set a test customer's owed amount to 0 and save; the card should confirm with "Saved."
2. Trigger a qualifying order for that customer and check **DollarBack admin → Analytics → Activity**: the full cashback amount should be credited, with no recovery deduction.

## Common issues

* **Card doesn't load** ("Couldn't load. Refresh to try again."): a transient admin error; refresh the page.
* **"Didn't save. Try again."**: the write to Shopify failed; retry, and check the staff account has permission to edit customers.
* **"Enter an amount above 0."**: the Add row needs a positive amount; to zero out an existing debt, edit its row and save instead.
* **Customer keeps earning less than the program promises**: check this card first; an owed balance silently reduces every payout until cleared.

## Related articles

* [Refunds, cancellations & order edits](/dollarback-store-credit/spending-store-credit-and-rewards/refunds-cancellations-and-order-edits.md)
* [Metafields & data storage reference](/dollarback-store-credit/developer-tools/metafields-and-data-storage.md)
* [Activity: credit logs & scheduled rewards](/dollarback-store-credit/analytics-data-and-account/credit-logs-and-scheduled-rewards.md)
* [How cashback is calculated](/dollarback-store-credit/earning-cashback-programs/how-cashback-is-calculated.md)