> ## Documentation Index
> Fetch the complete documentation index at: https://docs.planeconnection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POS Transaction Types

> Transaction types, payment methods, reconciliation fields, and financial workflows for the FBO Point of Sale system.

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

| Type       | API Value    | Description                                                                    | Effect on Balance       |
| ---------- | ------------ | ------------------------------------------------------------------------------ | ----------------------- |
| Payment    | `payment`    | Money received from a customer for products or services.                       | Increases till balance. |
| Refund     | `refund`     | Money returned to a customer for a previous payment.                           | Decreases till balance. |
| Adjustment | `adjustment` | Manual correction to a balance or till amount.                                 | Varies by direction.    |
| Void       | `void`       | Cancellation of a transaction before settlement. Reverses the original amount. | Reverses original.      |

## Payment Methods

| Method        | API Value       | Description                                            | Settlement            |
| ------------- | --------------- | ------------------------------------------------------ | --------------------- |
| Cash          | `cash`          | Physical currency collected at the till.               | Immediate.            |
| Credit Card   | `credit_card`   | Credit card payment via payment gateway.               | 1--3 business days.   |
| Debit Card    | `debit_card`    | Debit card payment via payment gateway.                | 1--2 business days.   |
| Check         | `check`         | Paper check. Requires manual deposit.                  | 3--5 business days.   |
| House Account | `house_account` | Charged to the customer's account for later invoicing. | Upon invoice payment. |
| Wire Transfer | `wire`          | Bank wire transfer for large transactions.             | 1--2 business days.   |
| Gift Card     | `gift_card`     | Redeemed from an FBO-issued gift card balance.         | Immediate.            |
| Reward Points | `reward_points` | Redeemed from a customer's reward card balance.        | Immediate.            |

## Transaction Processing States

| Status    | API Value   | Description                                                                         |
| --------- | ----------- | ----------------------------------------------------------------------------------- |
| Pending   | `pending`   | Transaction initiated but not yet processed (e.g., card authorization in progress). |
| Completed | `completed` | Transaction successfully processed and recorded.                                    |
| Failed    | `failed`    | Transaction could not be processed (e.g., card declined).                           |
| Reversed  | `reversed`  | A completed transaction that was subsequently reversed by a void or refund.         |

## Transaction Fields

| Field              | Type                 | Description                                                 |
| ------------------ | -------------------- | ----------------------------------------------------------- |
| `transaction_id`   | String               | Auto-generated unique identifier.                           |
| `order_id`         | String (optional)    | Reference to the associated POS order.                      |
| `till_id`          | String (optional)    | Reference to the till that processed the transaction.       |
| `customer_id`      | String (optional)    | Reference to the customer account.                          |
| `transaction_type` | Enum                 | Payment, refund, adjustment, or void.                       |
| `payment_method`   | Enum                 | Cash, credit card, debit card, check, house account, etc.   |
| `amount`           | Number               | Transaction amount in USD. Always a positive value.         |
| `description`      | String (optional)    | Notes or reference information for the transaction.         |
| `status`           | Enum                 | Pending, completed, failed, or reversed.                    |
| `processed_by`     | String               | User who processed the transaction.                         |
| `created_at`       | Timestamp            | Date and time the transaction was initiated.                |
| `settled_at`       | Timestamp (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

| Field                 | Description                                    |
| --------------------- | ---------------------------------------------- |
| **Till name**         | Which till the report covers.                  |
| **Shift operator**    | Staff member who operated the till.            |
| **Opening balance**   | Cash amount at shift start.                    |
| **Closing balance**   | Counted cash amount at shift end.              |
| **Expected balance**  | Calculated balance based on transactions.      |
| **Variance**          | Difference between expected and actual.        |
| **Transaction count** | Total number of transactions during the shift. |
| **Total sales**       | Sum of all payment transactions (all methods). |
| **Total refunds**     | Sum of all refund transactions.                |
| **Net revenue**       | Total sales minus total refunds.               |

## Related

<CardGroup cols={2}>
  <Card title="Manage POS Tills" href="/how-to/fbo/manage-pos-tills">
    Open, close, and reconcile tills.
  </Card>

  <Card title="Use the FBO Point of Sale" href="/how-to/fbo/use-point-of-sale">
    Process orders and manage POS operations.
  </Card>

  <Card title="FBO POS Reference" href="/reference/fbo-pos-reference">
    Product catalog, order fields, and inventory tracking.
  </Card>

  <Card title="Run FBO Reports" href="/how-to/fbo/run-fbo-reports">
    Financial reports including end-of-day reconciliation.
  </Card>
</CardGroup>