> For the complete documentation index, see [llms.txt](https://docs.shopwaive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shopwaive.com/shopify/draft-orders.md).

# Draft orders

Put a customer's Shopwaive balance on an open draft order, right on Shopify's draft order page: More actions > Apply balance, and the Shopwaive Balance card

## What it is

Your staff can put a customer's Shopwaive balance on an open draft order as a discount, right on Shopify's draft order page. Nothing opens in another page.

There are two ways in. Both show the same figures and do the same things:

* **Apply balance**, in the draft order's **More actions** menu. It opens a window. It is there on every draft order: you don't need to add anything.
* **Shopwaive Balance**, a card you can add to the draft order page. The card is optional.

The discount is always titled **Balance used**. The balance comes off the customer's Shopwaive balance once, when the draft order is completed. Applying, changing or removing the discount takes nothing from the balance.

{% hint style="info" %}
Draft orders are useful for phone, email and in-person orders, invoices, wholesale prices and B2B orders. See Shopify's guide to [creating draft orders](https://help.shopify.com/en/manual/orders/create-orders).
{% endhint %}

## Who sees it

* Staff who can open draft orders in your Shopify admin see **Apply balance** in **More actions**, and the **Shopwaive Balance** card once it is added.
* Every change is made with the signed-in staff member's own Shopify account, so Shopify checks that person's permissions. A staff member who can't add discounts to draft orders sees **Your Shopify account can't add discounts to draft orders, so nothing was changed. Ask the store owner.**
* Customers see only the result: a **Balance used** discount on their invoice and at checkout.

## Before you start

The draft order needs:

* a customer,
* an email address on that customer,
* at least one product or custom item.

## Step by step: apply a balance to a draft order

{% stepper %}
{% step %}
**Open the draft order**

In your Shopify admin, go to **Orders** > **Drafts** and open a draft order, or click **Create order**. Add the customer and the products, then save the draft order.
{% endstep %}

{% step %}
**Click More actions > Apply balance**

<figure><img src="https://1743155819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6HSAZj4RDucpQwVtzMYt%2Fuploads%2Fgit-blob-7ecf001f38f5218b43d4e66028470138b9ecf7e5%2Fdraft-orders-more-actions.png?alt=media" alt="The More actions menu on a draft order, with Apply balance and the Shopwaive logo"><figcaption><p>More actions on a draft order. Apply balance has the Shopwaive logo.</p></figcaption></figure>
{% endstep %}

{% step %}
**Read the window**

The **Apply balance** window shows whose balance it is, the **Available balance**, what is **Applied to this draft order**, and what **Comes off the balance when completed**. When the balance can be used, it also says **This draft order can use up to** an amount.

<figure><img src="https://1743155819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6HSAZj4RDucpQwVtzMYt%2Fuploads%2Fgit-blob-43512f1c3eb5c78e81690f8f71602c67f9e9f2e1%2Fdraft-orders-apply-balance-window.png?alt=media" alt="The Apply balance window for a sample customer with no Shopwaive balance"><figcaption><p>The window for a sample customer. This one has no Shopwaive balance yet, so the window offers Refresh.</p></figcaption></figure>
{% endstep %}

{% step %}
**Apply the balance, or an amount**

* **To use the most this draft order can use:** click **Apply balance**. The window asks first, for example **Apply $70.00 of Jane Sample's balance to this draft order?** Click the button with the amount, for example **Apply $70.00**, or **Cancel**.
* **To use a smaller amount:** click **Apply amount**, type the amount in **Amount to apply**, then click **Apply amount**, or **Cancel**.

Either way, the window says **It comes off the balance when the draft order is completed, not now.**
{% endstep %}

{% step %}
**Check the result**

While Shopify updates the draft order, the window says **Updating the draft order.** As soon as the draft order shows the discount, the window says **Applied: $70.00 of the Shopwaive balance is on this draft order.** Click **Done** to close the window. The draft order shows the discount as **Balance used**.

To use a different amount, click **Change amount** instead of **Done**. The window shows **Apply balance** and **Apply amount** again.
{% endstep %}

{% step %}
**Finish the draft order as usual**

Send the invoice, collect payment or set payment terms as usual. When the draft order is completed, the applied amount comes off the customer's Shopwaive balance.
{% endstep %}
{% endstepper %}

### Change or remove the balance

* **To change the amount:** right after applying, click **Change amount**. Later, open **More actions** > **Apply balance** again. Click **Apply amount** and type the new amount, or click **Apply balance** to use the most. The new amount replaces the old one.
* **To take it off:** open the same window, click **Remove**, then **Remove discount**. The window says **Removed: the Shopwaive balance discount is off this draft order.** Click **Done**. Nothing comes off the customer's balance for a removed discount.
* **Refresh** reads the draft order and the balance again, for example after you edit the draft order.

## Optional: add the Shopwaive Balance card

The card shows the same lines and buttons as the window, on the draft order page itself. After you apply an amount on the card, it says **Applied:** and the amount. If the draft order's totals don't show it yet, reload the page.

1. Open any draft order.
2. In **Blocks**, click **Block**.
3. Choose **Shopwaive Balance**.

<figure><img src="https://1743155819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6HSAZj4RDucpQwVtzMYt%2Fuploads%2Fgit-blob-1db885b9b595424e55cdefa9d9afdcf6c0248349%2Fdraft-orders-add-block.png?alt=media" alt="The Blocks section of a draft order, with Block clicked and Shopwaive Balance in the list"><figcaption><p>Blocks > Block > Shopwaive Balance.</p></figcaption></figure>

## What the window shows

| Line                                     | What it means                                                                                                                                                                                           |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| The customer's name and email            | Whose balance it is. On a B2B draft order, a line says it is the buyer's own balance, not their company's.                                                                                              |
| **Available balance**                    | The customer's Shopwaive balance now. At a store that shows points, a line under it gives the points in the customer's wallet: whole points, rounded down, unless **Points decimals** is set to 1 or 2. |
| A line about other open draft orders     | The part of the balance that is already on the customer's other open draft orders, with their numbers.                                                                                                  |
| **Applied to this draft order**          | The balance discount on this draft order now, or **None**.                                                                                                                                              |
| **Comes off the balance when completed** | What comes off the customer's balance when this draft order is completed, or **Nothing**.                                                                                                               |
| **This draft order can use up to**       | The most you can apply: the lower of the draft order's items and the balance that is not on the customer's other open draft orders.                                                                     |

## What the window says, and what to do

| Message                                                                                                            | What to do                                                                                                                              |
| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Add a customer to this draft to use their Shopwaive balance.**                                                   | Add the customer to the draft order and save it.                                                                                        |
| **Add an email address to this customer to use their Shopwaive balance.**                                          | Add the customer's email address in Shopify.                                                                                            |
| **This customer has no Shopwaive balance.**                                                                        | Give the customer a balance first, or take another payment.                                                                             |
| **Add products to this draft order to use the balance.**                                                           | Add at least one product or custom item.                                                                                                |
| **All of Jane Sample's $70.00 is on other open draft orders (#D12, #D15).**                                        | The whole balance is on the customer's other open draft orders. Remove it from one of them, or complete that one first.                 |
| **This draft order has another discount ... Applying the balance replaces it.**                                    | Shopify allows one discount on a whole draft order. Applying the balance replaces the other one.                                        |
| **The items on this draft order come to ..., so that is the most the balance can cover.**                          | The balance covers at most the draft order's items.                                                                                     |
| **The balance is now lower than this discount ...**                                                                | The customer spent part of the balance after you applied it. Apply a new amount, or remove the discount.                                |
| **This draft order is completed, so its discount can no longer be changed here.**                                  | A completed draft order is an order now.                                                                                                |
| **This customer's balance is held in ... and this store prices in ..., so it can't be used on a draft order.**     | The balance and the draft order must be in the same currency.                                                                           |
| **This draft order carries the "Shopwaive" tag ...**                                                               | The tag marks an order a customer placed with their own balance. If this draft order is a copy of one, remove the tag to use a balance. |
| **This draft order changed while this window was open, so nothing was changed. The window now shows it as it is.** | Check the draft order and try again.                                                                                                    |
| **Your Shopify account can't add discounts to draft orders, so nothing was changed. Ask the store owner.**         | The store owner can give you the permission in Shopify.                                                                                 |

## Limits

* One balance discount per draft order. It replaces any other discount on the whole draft order.
* The balance used is the customer's own Shopwaive balance. A company balance is not applied to a draft order.
* The balance must be in your store's currency.
* A completed draft order can't be changed here.
* The window counts up to 1,000 of the customer's other open draft orders. For a customer with more than that, it does not offer **Apply balance**.
* Completing a draft order never takes more from the balance than was applied.

## In the app

**Apply balance** and the **Shopwaive Balance** card are on Shopify's draft order page in your Shopify admin, not on a page of the Shopwaive app.

## Related

* [Gift Cards](https://docs.shopwaive.com/shopify/codes/gift-cards.md), another way to take a payment toward an order.
