> ## Documentation Index
> Fetch the complete documentation index at: https://afrizon-admin.tunzaa.co.tz/llms.txt
> Use this file to discover all available pages before exploring further.

# View and filter payment transactions for orders in Meneja

> Browse, filter, and inspect every payment, refund, and payout transaction recorded against your orders in the Meneja admin dashboard.

Every payment event in Meneja generates a transaction record. Transactions give you a detailed, immutable log of money movement across your platform — covering incoming payments, issued refunds, and payouts. You can view all transactions in the Transactions section, filter them by status or date, and drill into the full detail of any individual record.

## Transaction record structure

Each transaction contains the following fields:

| Field            | Description                                        |
| ---------------- | -------------------------------------------------- |
| `transaction_id` | Unique transaction identifier                      |
| `reference`      | External payment reference from the gateway        |
| `amount`         | Transaction amount                                 |
| `status`         | Current `TransactionStatus` value                  |
| `payment_date`   | Date and time of the payment event, or `null`      |
| `type`           | Transaction type: `payment`, `refund`, or `payout` |
| `user_id`        | The customer associated with this transaction      |
| `tenant_id`      | The tenant this transaction belongs to             |
| `created_at`     | When the transaction record was created            |
| `updated_at`     | When the transaction record was last updated       |

## Transaction statuses

| Status      | Meaning                                                  |
| ----------- | -------------------------------------------------------- |
| `PENDING`   | The transaction has been initiated but not yet confirmed |
| `COMPLETED` | The transaction completed successfully                   |
| `FAILED`    | The transaction was attempted but did not succeed        |
| `REFUNDED`  | The original payment transaction has been refunded       |

<Note>
  Transaction statuses are set by the payment gateway and are updated automatically when Meneja receives a callback. You cannot manually change a transaction's status.
</Note>

## Transaction types

The `type` field tells you the direction and purpose of the money movement:

| Type      | Meaning                             |
| --------- | ----------------------------------- |
| `payment` | An incoming payment from a customer |
| `refund`  | Money returned to a customer        |
| `payout`  | A payout disbursement               |

## Viewing and filtering transactions

Navigate to **Orders → Transactions** to see the full transactions list. The table shows the transaction ID, reference, amount, status, and date for each record.

You can filter the list using the following options:

| Filter      | Description                                               |
| ----------- | --------------------------------------------------------- |
| `status`    | Filter by `PENDING`, `COMPLETED`, `FAILED`, or `REFUNDED` |
| `search`    | Search by transaction ID or reference number              |
| `date_from` | Start of a date range                                     |
| `date_to`   | End of a date range                                       |

<Steps>
  <Step title="Open the Transactions list">
    Navigate to **Orders** and select **Transactions** from the sub-navigation. The list loads with your most recent transactions at the top.
  </Step>

  <Step title="Apply filters">
    Use the status filter to narrow results — for example, select `FAILED` to review all transactions that did not complete. Add a date range to limit results to a specific period.
  </Step>

  <Step title="View transaction details">
    Click **View** on any row to open the full transaction detail. The detail view shows the complete record including the raw gateway request and response data.
  </Step>
</Steps>

## Transactions on a specific order

You can also view all transactions for a single order from the order detail view. The Transactions tab within an order lists every payment and refund event associated with that order's reference number.

<Tip>
  When investigating a payment dispute, start with the order's Transactions tab. You can cross-reference the `reference` field with your payment gateway's own records to get the full picture.
</Tip>

## Payment methods

Transactions are recorded regardless of the payment method used. Meneja supports the following methods:

* `credit_card`
* `paypal`
* `bank_transfer`
* `cash_on_delivery`
* `mobile_money`

The payment method is captured in the order's `payment_details.method` field and is visible in the order detail view alongside the transaction.