Credits tab

The Credits tab is where you manage the booth's credit balance and audit how credits flow through the system. Credits are the unit BoothIQ uses to represent customer payment. Every coin or bill the customer inserts becomes credits, and every print they buy deducts credits.

Who this is for: Operators investigating "where did the money go" questions, comping a customer, or auditing credit history.

What this tab is for

• See the current credit balance on the booth in real time
• Manually add credits to comp a customer or for an event
• See the full credit transaction history with filters
• Understand the source of every credit (Pulse / Cloud / Admin / Other)
• Watch the credit flow chart for visual breakdown

Layout

Top to bottom:

1. Page header with the title "Credits"
2. Headline cards showing the current balance and recent activity
3. Manual credit add section with an input and a button
4. Credit flow chart (visual breakdown of additions, deductions, resets)
5. Transaction history table with filters and pagination

Current balance

The most prominent number on this tab is the current credit balance, the value that customers will see in the welcome screen's credits indicator. It's stored in the local database under the System / CurrentCredits setting and updates in real time as customers insert money or finish sessions.

In Free Play mode the balance is irrelevant. Customers don't need credits to start a session. But the balance still tracks (and you can still add to it manually) so you have an audit trail.

Headline cards

Around the current balance you'll see secondary stats. Typically:

• Today's additions. Credits added today (any source)
• Today's deductions. Credits spent on prints today
• Net change. Additions minus deductions

These give you a quick "what happened today" picture without digging into the history table.

Manually adding credits

To add credits to the booth (e.g. comping a customer whose print failed, or seeding the booth for a free-play event without switching modes):

1. Find the Add Credits input or section.
2. Enter the amount you want to add.
3. Tap the Add (or similar) button.
4. The booth records an Admin credit transaction in the history.
5. The current balance updates immediately.

Manual credit adds are recorded with source = Admin so you can find them in the history filter later.

Deducting / resetting credits

To remove credits from the booth (e.g. you accidentally added too much, or you want a clean slate at the start of an event):

• Deduct. Subtract a specific amount
• Reset. Set the balance back to zero

Both operations are recorded in the credit history with their own type label so you can audit them later.

Credit flow chart

A visual chart showing the breakdown of credit movements over a chosen period:

• Add transactions (green/teal). Credits coming in
• Deduct transactions (red). Credits being spent on prints
• Reset transactions (yellow/amber). Manual zero-outs

This is mostly for spotting unusual patterns at a glance. E.g. a sudden spike in resets means someone has been clearing the balance more than expected.

Credit source breakdown

Every credit transaction has a source, where the credit came from:

• Pulse. From the coin / bill acceptor PCB. This is the normal "customer paid" flow
• Cloud. From a remote add_credits command sent by the cloud dashboard
• Admin. From a manual addition you did in this tab
• Other. Legacy or unknown source. Usually only seen on very old transactions

The Credits tab shows a source breakdown so you can answer questions like "how much of last week's revenue came from cash vs cloud comps vs admin adds?"

Transaction history

A paginated table at the bottom shows every credit transaction with:

• Date and time
• Type (Add / Deduct / Reset)
• Amount
• Source (Pulse / Cloud / Admin / Other)
• Balance after the transaction

Filter buttons or dropdowns let you narrow the list by type:

• All. Show everything
• Add only
• Deduct only
• Reset only

Pagination shows about 20 entries per page.

How to comp a customer

Common scenario: a customer's print came out blurry, or the printer jammed during their session. You want to give them a "free retry."

1. Open the Credits tab.
2. Note the current balance so you can verify your add worked.
3. Add credits equal to the price of one session (or whatever amount you want to comp).
4. Walk back to the customer and tell them they can run another session.
5. After they're done, the balance should be back to where it started (the comped credits get spent on the new session).

Because the comp is recorded as source = Admin, your accountant can distinguish "real customer payments" from "operator comps" in the audit trail.

Verify it worked

You can use the Credits tab effectively when you can:

• Read the current balance
• Add credits manually
• Find a specific past transaction by filtering
• Identify whether a credit came from a customer, the cloud, or an admin add

Common problems

Balance is wrong.

The booth missed a Pulse signal, or there's a stale state. Check the credit history for missing entries. Restart the booth if balances disagree wildly with what's expected.

Manual add doesn't change the balance.

You forgot to tap the confirmation button, or the amount was zero. Check the transaction history. If no Admin entry was recorded, repeat the add.

Customer paid but credit didn't appear.

The PCB pill is probably red. See Payment not registering (coming soon).

Pulse history shows duplicates.

Rare. Usually a hardware glitch. Note the time and contact support.

Next steps

• Products tab. Configure prices so credits map to products correctly.
• Running Your Booth › Adding credits manually (coming soon). A task-oriented walkthrough.
• Cloud and Fleet › Remote commands (coming soon). How cloud admins push credits to the booth remotely.