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

# Transactions

> View, search, and manually review transactions. Understand risk scores, fraud flags, and take action.

# Transactions

The Transactions module is the operational heart of Datalex. Every payment event processed by your system flows through this module, where it is enriched with risk signals, evaluated by active workflows, and made available for manual review and investigation.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/transactions-overview.png" alt="Transactions Overview" />

*The Transactions list view with risk scores, statuses, and filter controls.*

***

## Transaction Lifecycle

```
Received  →  Workflow Evaluation  →  APPROVED | REJECTED | PENDING | flagged | under-review
```

| Status           | Description                                                               |
| ---------------- | ------------------------------------------------------------------------- |
| **Approved**     | The transaction passed all workflow conditions and was allowed.           |
| **Rejected**     | A workflow rule triggered a Reject node and the transaction was declined. |
| **Pending**      | The transaction is queued and awaiting workflow evaluation.               |
| **Flagged**      | A signal was raised but no terminal decision has been made yet.           |
| **Under Review** | The transaction has been escalated for manual review by an analyst.       |

***

## Transaction Attributes

Every transaction carries a rich set of structured attributes that are used for risk evaluation, routing, and investigation.

### Core Fields

| Attribute       | Type   | Description                                          |
| --------------- | ------ | ---------------------------------------------------- |
| `id`            | Text   | Unique transaction identifier                        |
| `amount`        | Number | Transaction amount                                   |
| `currency`      | Text   | ISO 4217 currency code (e.g., `QAR`, `USD`)          |
| `status`        | Text   | Current transaction status                           |
| `riskScore`     | Number | Computed risk score from 0 (safe) to 100 (high risk) |
| `createdAt`     | Date   | UTC timestamp of when the transaction was received   |
| `paymentMethod` | Text   | Payment method description                           |
| `ipAddress`     | Text   | IP address of the originating device                 |
| `deviceId`      | Text   | Unique device identifier                             |
| `failureReason` | Text   | Reason code if the transaction failed                |
| `insight`       | Text   | AI-generated risk summary                            |

### Card Information

| Attribute              | Type | Description                                          |
| ---------------------- | ---- | ---------------------------------------------------- |
| `card.cardNumber`      | Text | Masked or tokenised card number                      |
| `card.cardHolder`      | Text | Name of the cardholder                               |
| `card.cardExpiry`      | Text | Expiry date of the card                              |
| `card.cardIssuer`      | Text | Issuing bank or network (e.g., `Visa`, `Mastercard`) |
| `card.cardFingerprint` | Text | Unique fingerprint of the card                       |
| `cardCountryCode`      | Text | Country code of the issuing bank                     |

### Payment Info (Metadata)

| Attribute                   | Description                             |
| --------------------------- | --------------------------------------- |
| `paymentInfo.status`        | Provided payment status from the source |
| `paymentInfo.failureReason` | Provided failure reason from the source |
| `paymentInfo.cardHolder`    | Cardholder name from payment metadata   |

### Merchant Info

| Attribute                     | Description                  |
| ----------------------------- | ---------------------------- |
| `merchantInfo.name`           | Merchant display name        |
| `merchantInfo.categoryCode`   | Merchant Category Code (MCC) |
| `merchantInfo.marketplace`    | Marketplace or platform name |
| `merchantInfo.organizationId` | Organisation identifier      |

### User Info

| Attribute             | Description                  |
| --------------------- | ---------------------------- |
| `userInfo.userId`     | The platform user identifier |
| `userInfo.email`      | User email address           |
| `userInfo.accountAge` | Account age in days          |
| `userInfo.country`    | User's registered country    |

## Transaction Detail View

Click any transaction row to open the full **Transaction Detail** page.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/transaction-detail.png" alt="Transaction Detail Page" />

*Transaction detail page with sections for risk, card, merchant, and location.*

### Sections

#### Risk Assessment

Displays the risk score, breakdown of individual fraud flags, and an AI-generated insight summarising the key risk drivers.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/risk-assessment.png" alt="Risk Assessment Section" />

#### Card Information

Shows the card number (masked), holder name, expiry, issuer, and card fingerprint used for velocity tracking.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/card-info.png" alt="Card Information Section" />

#### Merchant Information

Provides merchant name, category code, marketplace, organisation, country, risk level, transaction volume, and dispute rate.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/merchant-info.png" alt="Merchant Info Section" />

#### Location

Displays the resolved geographic location of the transaction IP address, including city, country, and latitude/longitude on an interactive map.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/transaction-location.png" alt="Location Section" />

#### Related Transactions

Lists prior transactions from the same card fingerprint or user, enabling analysts to spot patterns across multiple interactions.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/related-transactions.png" alt="Related Transactions" />

***

## Transaction Graph

The **Transaction Graph** provides a network visualisation of relationships between transactions, users, merchants, and devices. It helps analysts identify fraud rings, account takeovers, and merchant collusion by revealing structural patterns that are invisible in flat lists.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/transaction-graph.png" alt="Transaction Graph" />

*Network graph showing connections between transactions, cards, merchants, and devices.*

### Node types in the graph

| Node type   | Represents                  |
| ----------- | --------------------------- |
| User        | The platform customer       |
| Transaction | An individual payment event |
| Merchant    | A merchant or business      |
| Device      | A unique device fingerprint |
| Card        | A payment card              |

Hover over any node to see its details. Click to select and highlight its direct connections.

***

## Transaction Analytics

The analytics section of Case Management provides aggregated dashboards over the transactions linked to a set of cases, including:

* Transaction volume by time period (area or line chart)
* Status distribution breakdown
* Risk score distribution histogram
* Geographic heat map of transaction origins

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/transaction-analytics.png" alt="Transaction Analytics" />

*Analytics charts for the transaction volume and status breakdown.*

***

## Geographic Map

The **Location Map** aggregates transactions by country and renders them as sized markers on an interactive map. Each marker shows the transaction count, total amount, and highest risk level for that country.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/datalexsolutionsllc/images/docs/transactions/location-map.png" alt="Location Map" />

*Geographic distribution map with per-country transaction aggregations.*

***

## Reviewing a Transaction Manually

1. Navigate to **Transactions** in the main navigation.
2. Use the filters to search by date, status, risk level, or merchant.
3. Click a transaction to open its detail view.
4. Review the risk signals, fraud flags, and related transactions.
5. Take one of the following actions:
   * **allow** — mark the transaction as legitimate.
   * **reject** — mark the transaction as fraudulent.
   * **(allow/reject) and Create Case** — escalate to the Case Management module for deeper investigation.
   * **allow and Flag** — add a flag for secondary review without making a final decision.