## Before You Start

Set up your Store Credit program first. Your expiry rules and top-up packages decide what the receipt has to show, and the setting that connects this template lives on the same page.

See [Setting Up Your Store Credit Program](/docs/setting-up-your-store-credit-program) before you continue.

---

## Where to Find Receipt Templates

Your top-up receipt is built in the same list as every other slip your shop prints.

1. Click the ⚙️ <Badge>Settings</Badge> icon in the top-right corner.

2. Under the **Library** section, click <Badge>Receipt template</Badge>.

![Under the Library section, click Receipt template.](https://cdn.easybizcloud.app/knowledge/027cd0b2-b89b-447c-86f8-847925b036cd.png)

3. The page that opens is titled Receipt Templates. Slips you already use, such as your POS order receipt, are listed here.

![The page that opens is titled Receipt Templates.](https://cdn.easybizcloud.app/knowledge/6dae8eb2-1824-4d12-9978-9cdefc26be9f.png)

<Callout type="note" title="📝 Note">

There is no separate Store Credit receipt page. A top-up receipt is one row in this list, with its Type shown as Credit.

</Callout>

---

## Create the Top-Up Receipt Template

1. Click <Badge>+ Add</Badge> in the top right. A pop-up titled New Receipt Template opens.

2. Enter a **Template name**, for example Store Credit Top-Up Receipt. This is the name you will pick later in Store Credit settings, so keep it plain.

3. Under **Template content**, scroll to the bottom of the card list. **Top up receipt** is the last card.

![Under Template content, scroll to the bottom and click the Top up receipt card.](https://cdn.easybizcloud.app/knowledge/8873ff2c-8408-4de5-aec1-4f8697e54023.png)

4. Click the **Top up receipt** card, then click <Badge>Create</Badge>.

<Callout type="important" title="⚠️ Important">

Choose the card carefully. The content type is fixed once the template is created. If you pick the wrong card, delete the template and create a new one.

</Callout>

---

## What the Ready-Made Layout Already Prints

The editor opens with a working slip. 

- Brand Logo centered
- A large Top Up Receipt heading in white-on-black
- Customer and Customer tel
- Top up amount, Gift amount, New balance
- Paid by, Top up date, Top up from, Served by
- A Signature line

![How the printed receipt looks](https://cdn.easybizcloud.app/knowledge/8d403ccc-5550-404c-ae0b-f7db25881d3d.jpg)

<Callout type="note" title="📝 Note">
The **Gift amount** row only prints when that top-up actually included bonus credit. A plain top-up with no bonus leaves the row out, so the slip never shows a confusing $0.00 gift.
</Callout>

---

## Set the Paper Width and Formats

Click the outer edge of the slip to select the receipt itself. The **Block** tab then shows **Normal character per line**.

| Pick this | Result |
| --- | --- |
| 48 Characters (80mm) | For a normal counter printer |
| 32 Characters (58mm) | For a small handheld printer |

The **Receipt** tab holds three settings that apply to the whole slip: **Date format**, **Time format**, and **Currency display**. Each can be left on Default to preferences, which follows your Console setting.

![The Receipt tab holds Date format, Time format, and Currency display.](https://cdn.easybizcloud.app/knowledge/9b647906-abc0-4e26-aa24-49fed611bf23.png)

<Callout type="note" title="📝 Note">
Picking the wrong width is the usual reason a slip prints with the right-hand column cut off. Chinese characters take the space of two English characters, so a line that fits in English can still wrap in Chinese.
</Callout>

---

## Customise the Layout

Click any part of the slip to select that block. A small toolbar appears on the block, and the **Block** tab fills with its settings.

- Rewrite the wording, for example change Top Up Receipt to Thank You For Topping Up.
- **Font size**: Small, Normal, Large, Huge, or Giant.
- **Alignment**: click to cycle Left, Center, Right.
- **Bold** and **Invert mode**, which prints white letters on a black bar for a heading.
- **Top margin**: add 1 to 5 blank lines above the block.
- **Move block** to shift it up or down, or **Delete block** to remove it.
- **Conditional display** to print a block only in certain situations.

![Click a block to change its wording, size, alignment, and spacing.](https://cdn.easybizcloud.app/knowledge/595cb66c-4bc7-40dd-8629-6ea2473c1bc5.png)

To add something new, select the block you want to add below and click the ⊕ **Insert sibling block below** button. A drawer opens with the blocks a top-up receipt can use: Business Logo, three text sizes, Text side by side, Text 3 columns, Line Feed, Dash line, Signature, and PAYNOW QR Code (Manual).

![Click the insert button to add a logo, text, divider, blank line, signature, or PayNow QR.](https://cdn.easybizcloud.app/knowledge/ffead557-e834-4939-8bee-6ae87433c8d7.png)

<Callout type="important" title="⚠️ Important">
Do not delete the amount and balance rows. If you need a second copy of one, duplicate the existing row instead of typing the number by hand. A typed amount prints the same figure on every receipt.
</Callout>

---

## Add a Manual PayNow QR

Add the **PAYNOW QR Code (Manual)** block, then set two options.
<Callout type="important" title="🇸🇬 Singapore market only">
PayNow is available only in Singapore. If your business operates in another market, skip this section and use a payment method supported in your market.
</Callout>

| Setting | What it does |
| --- | --- |
| QR code size | 1 to 8. Larger is easier to scan off a narrow slip. |
| Auto Include Amount | Total Amount and Outstanding Amount both print a QR for what the customer paid. No Amount prints a QR with no value, so the customer keys the amount into their banking app. |

![Add the PAYNOW QR Code (Manual) block and set its size and amount.](https://cdn.easybizcloud.app/knowledge/4ef644fb-bc16-4e30-a334-6e5eaaac59ff.png)

<Callout type="important" title="⚠️ Important">
Manual means EasyBiz builds the QR from your own company registration number. You do not upload a QR picture. If no registration number is saved, the editor shows a warning and the QR prints nothing while the rest of the slip prints normally. Add it under Settings, **Administration** section, **Company**.
</Callout>

<Callout type="note" title="📝 Note">
PayNow is a Singapore payment method built from a Singapore registration number, so only Singapore registered companies can use this block. The QR also never includes bonus gift credit, only the money the customer actually hands over.
</Callout>

---

## Save the Template

Click <Badge>Save</Badge> in the top right. Saving also publishes: the Status in the Receipt Templates list changes from Draft to Active.

<Callout type="important" title="⚠️ Important">

A template that has never been saved stays in Draft, and a Draft template does not appear in Store Credit settings.

</Callout>

---

## Connect It to Store Credit

1. Click the ⚙️ <Badge>Settings</Badge> icon in the top-right corner.

2. Under the **Marketing** section, click <Badge>Store Credit</Badge>.

![Store credit on settings page](https://cdn.easybizcloud.app/knowledge/dce8c50d-17fa-435f-80b4-6fe904e87784.png)

3. Under **General Settings**, open **Top-up receipt template** and choose the template you saved.

![Under Top-up receipt template, choose your saved template.](https://cdn.easybizcloud.app/knowledge/2db91a89-0d41-41bc-927e-f0a0b05180df.png)

4. Click <Badge>Save</Badge>.

---

## What Your Staff Sees at the Counter

| POS version | What your staff sees | What prints |
| --- | --- | --- |
| Older POS app | The existing top-up completion flow | Your template once it is connected, otherwise EasyBiz's fixed standard slip |
| Newer POS app | A Payment Succeeded screen showing the slip, a Print receipt button, and a printer settings button | Your template |

<Callout type="important" title="⚠️ Important">

With no template connected, the older app still prints its plain built-in slip, but the newer app shows no slip and no Print receipt button at all. Connect a template so every counter can hand the customer the same printed receipt.

</Callout>

---

## Test It

Do one small top-up on the POS with a test customer.
1. Open the Credit tab, choose a package or a custom amount, and take the payment.

2. When the payment succeeds, the slip appears on the success screen with a <Badge>Print receipt</Badge> button below it.

![After a successful top-up the slip appears on screen with a Print receipt button.](https://cdn.easybizcloud.app/knowledge/2af27afd-d7a7-49ac-9adc-316b9beebc4c.png)

<Callout type="note" title="📝 Note">
You do not need a printer connected to check the layout. The slip on screen is exactly what will print. The button beside it opens receipt printer settings if the printer is not paired yet.
</Callout>

---

## FAQs

**Is the template required before staff can top up credit?**

> No. Top-ups work either way. What changes is what staff can hand the customer: the newer POS app shows no slip and no print button until a template is connected, while the older app falls back to a fixed slip you cannot edit.



**Why does my template not appear in the selector?**

> Either it has never been saved, so it is still Draft and only Active templates are offered, or it was created from the wrong card. The selector only offers templates created from the Top up receipt card, and that card cannot be changed after creation.



**Is one selected template shared across all outlets and POS devices?**

> Yes. There is one setting for the whole business. You cannot give a different top-up receipt to different outlets, sales channels, or devices. Changing it changes every counter at once.



**Does changing it update receipts from earlier top-ups?**

> No. Each top-up keeps the slip produced at that moment. A new template applies from the next top-up onward.



**Is the receipt printed automatically, or sent by email or WhatsApp?**

> Neither. It is a manual print from the success screen, on the device that took the payment. Once staff close that screen the print option is gone. There is no email or WhatsApp version of the top-up receipt.



**What happens to the top-up if receipt printing fails?**

> The credit is added to the wallet first and the slip is produced afterwards. A printer that is off, out of paper, or a template that fails to build never takes the money back or removes the credit. Check the customer's balance on their profile to confirm.



**Why is the PayNow QR missing or blank?**

> Almost always a missing company registration number under Settings, Administration, Company. Without it the block quietly prints nothing while the rest of the slip prints normally. Also check you added the block to the same template you connected in Store Credit settings.



**Does the QR include bonus gift credit?**

> No. It carries only what the customer pays. A $100 package with a $10 bonus produces a $100 QR, because the $10 is credit you grant, not money the customer transfers.



**Why can I not find the top-up fields when I type @ in a text block?**

> The @ list on a top-up receipt currently offers customer and company fields, not the top-up amounts. Keep the ready-made amount, gift, and balance rows and edit their labels instead of rebuilding them. If you need one twice, duplicate the existing row.



---

## What's Next?

Make the Credit tab visible to counter staff with [Set Up Store Credit on Your POS](/docs/set-up-store-credit-on-your-pos).


