Skip to main content
The FBO Point of Sale system records all financial activity as transactions. This reference documents the transaction types, payment methods, processing states, and reconciliation workflow.

​
Transaction Types

TypeAPI ValueDescriptionEffect on Balance
PaymentpaymentMoney received from a customer for products or services.Increases till balance.
RefundrefundMoney returned to a customer for a previous payment.Decreases till balance.
AdjustmentadjustmentManual correction to a balance or till amount.Varies by direction.
VoidvoidCancellation of a transaction before settlement. Reverses the original amount.Reverses original.

​
Payment Methods

MethodAPI ValueDescriptionSettlement
CashcashPhysical currency collected at the till.Immediate.
Credit Cardcredit_cardCredit card payment via payment gateway.1—3 business days.
Debit Carddebit_cardDebit card payment via payment gateway.1—2 business days.
CheckcheckPaper check. Requires manual deposit.3—5 business days.
House Accounthouse_accountCharged to the customer’s account for later invoicing.Upon invoice payment.
Wire TransferwireBank wire transfer for large transactions.1—2 business days.
Gift Cardgift_cardRedeemed from an FBO-issued gift card balance.Immediate.
Reward Pointsreward_pointsRedeemed from a customer’s reward card balance.Immediate.

​
Transaction Processing States

StatusAPI ValueDescription
PendingpendingTransaction initiated but not yet processed (e.g., card authorization in progress).
CompletedcompletedTransaction successfully processed and recorded.
FailedfailedTransaction could not be processed (e.g., card declined).
ReversedreversedA completed transaction that was subsequently reversed by a void or refund.

​
Transaction Fields

FieldTypeDescription
transaction_idStringAuto-generated unique identifier.
order_idString (optional)Reference to the associated POS order.
till_idString (optional)Reference to the till that processed the transaction.
customer_idString (optional)Reference to the customer account.
transaction_typeEnumPayment, refund, adjustment, or void.
payment_methodEnumCash, credit card, debit card, check, house account, etc.
amountNumberTransaction amount in USD. Always a positive value.
descriptionString (optional)Notes or reference information for the transaction.
statusEnumPending, completed, failed, or reversed.
processed_byStringUser who processed the transaction.
created_atTimestampDate and time the transaction was initiated.
settled_atTimestamp (optional)Date and time the transaction was settled (funds received).

​
Reconciliation

Till reconciliation compares the expected balance (calculated from transactions) against the actual counted balance at shift close.

​
Reconciliation Calculation

expected_balance = opening_balance
                 + SUM(cash payments)
                 - SUM(cash refunds)
                 + SUM(cash adjustments)

variance = actual_counted_balance - expected_balance
Only cash transactions affect the till’s physical balance. Card and house account transactions are tracked for reporting but do not change the cash in the till.

​
End-of-Day Report Fields

FieldDescription
Till nameWhich till the report covers.
Shift operatorStaff member who operated the till.
Opening balanceCash amount at shift start.
Closing balanceCounted cash amount at shift end.
Expected balanceCalculated balance based on transactions.
VarianceDifference between expected and actual.
Transaction countTotal number of transactions during the shift.
Total salesSum of all payment transactions (all methods).
Total refundsSum of all refund transactions.
Net revenueTotal sales minus total refunds.

Manage POS Tills

Open, close, and reconcile tills.

Use the FBO Point of Sale

Process orders and manage POS operations.

FBO POS Reference

Product catalog, order fields, and inventory tracking.

Run FBO Reports

Financial reports including end-of-day reconciliation.
Last modified on April 11, 2026