{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Guides","product":"Fraud Prevention","type":"markdown"},"seo":{"title":"Monitor transactions","description":"Everything about Mosaic Journeys, SDKs, and APIs","siteUrl":"https://developer.transmitsecurity.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"monitor-transactions","__idx":0},"children":["Monitor transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction monitoring lets you report, evaluate, and investigate payments and other financial operations in Mosaic. You can send transaction data either from a Fraud Prevention SDK session using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["triggerActionEvent()"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]},", or directly from your backend using the dedicated API or orchestration journey step. In both cases, the transactions appear in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fraud Prevention"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction Monitoring"]}," for review and investigation."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Early availability"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The dedicated backend Transaction Monitoring API and the Transaction Monitoring page in the Admin Portal are currently in early availability. Contact your Transmit Security representative for details."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Prerequisites"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction monitoring requires a working Fraud Prevention integration."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If you plan to report transactions from the client"]},", start with an SDK quick start such as the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/risk/quick_start_web"},"children":["JavaScript SDK quick start"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If you plan to evaluate transactions from your backend"]},", start with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/risk/quick_start_backendapi"},"children":["Backend API quick start"]},". Transaction evaluation integrates ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/risk/quick_start_backendapi#step-4-trigger-actions"},"children":["Step 4"]}," of the backend guide with a dedicated API call for financial transactions."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction monitoring enables:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Flexible transaction reporting"]},": Send transaction data from the client SDK or directly from your backend, depending on your integration model."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Real-time transaction evaluation"]},": Assess payments as they occur and apply recommendations before your system completes the operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behavioral anomaly detection"]},": Identify deviations from typical payer and payee activity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom rule enforcement"]},": Apply business policies to influence transaction outcomes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unified visibility"]},": View transaction risk and decisions alongside Fraud Prevention actions in the Admin Portal."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-an-integration-path","__idx":1},"children":["Choose an integration path"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction Monitoring supports two distinct integration paths:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SDK/session-based transaction reporting"]},": Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["triggerActionEvent()"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]}," when the transaction originates in a web or mobile flow that already uses a Fraud Prevention SDK session. This path reports the transaction into Transaction Monitoring and enriches it with Fraud Prevention analysis."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Backend/session-less transaction evaluation"]},": Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/openapi/risk/transactions.openapi"},"children":["Evaluate Transaction API"]}," or the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/orchestration/journeys/evaluate_transaction"},"children":["Evaluate Transaction"]}," journey step when you want your backend or journey to submit a transaction and receive a recommendation that your system can enforce, even without device or user session context."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These paths are closely related, but they serve slightly different integration needs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Both paths feed Transaction Monitoring and can be used to obtain a recommendation for a transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose the dedicated backend evaluation path for session-less backend integrations."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both paths can be used before or after authentication:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Before authentication"]},": You can report the transaction with available context, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claimedUserId"]},", correlation ID, device/session context, payer, payee, and amount."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["After authentication"]},": You can use the authenticated user context and any additional transaction details available in your app or backend."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":2},"children":["How it works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction monitoring combines transaction reporting, real-time evaluation, and investigation across SDK-based and backend-driven flows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sdksession-based-flow","__idx":3},"children":["SDK/session-based flow"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"mid-mermaid"},"children":[{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n participant C as Client SDK\n participant B as Your backend\n participant API as Mosaic\n participant DE as Risk engine\n participant RE as Rule engine\n participant UI as Transaction Monitoring UI\n\n C->>API: Report transaction via
triggerActionEvent(..., { transactionData })\n API-->>C: Return actionToken\n C->>B: Send actionToken with
transaction request\n B->>API: Fetch recommendation via
Recommendation API\n API->>DE: Analyze transaction\n DE->>RE: Apply detection and rules\n RE-->>API: Final recommendation\n API-->>B: Return TRUST / ALLOW /
CHALLENGE / DENY\n API-->>UI: Surface transaction for
investigation\n","diagramHtml":"Transaction Monitoring UIRule engineRisk engineMosaicYour backendClient SDKTransaction Monitoring UIRule engineRisk engineMosaicYour backendClient SDKReport transaction via triggerActionEvent(..., { transactionData })Return actionTokenSend actionToken with transaction requestFetch recommendation via Recommendation APIAnalyze transactionApply detection and rulesFinal recommendationReturn TRUST / ALLOW / CHALLENGE / DENYSurface transaction for investigation","diagramHtmlDark":"Transaction Monitoring UIRule engineRisk engineMosaicYour backendClient SDKTransaction Monitoring UIRule engineRisk engineMosaicYour backendClient SDKReport transaction via triggerActionEvent(..., { transactionData })Return actionTokenSend actionToken with transaction requestFetch recommendation via Recommendation APIAnalyze transactionApply detection and rulesFinal recommendationReturn TRUST / ALLOW / CHALLENGE / DENYSurface transaction for investigation"},"children":["sequenceDiagram\n participant C as Client SDK\n participant B as Your backend\n participant API as Mosaic\n participant DE as Risk engine\n participant RE as Rule engine\n participant UI as Transaction Monitoring UI\n\n C->>API: Report transaction via
triggerActionEvent(..., { transactionData })\n API-->>C: Return actionToken\n C->>B: Send actionToken with
transaction request\n B->>API: Fetch recommendation via
Recommendation API\n API->>DE: Analyze transaction\n DE->>RE: Apply detection and rules\n RE-->>API: Final recommendation\n API-->>B: Return TRUST / ALLOW /
CHALLENGE / DENY\n API-->>UI: Surface transaction for
investigation\n"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"backendsession-less-flow","__idx":4},"children":["Backend/session-less flow"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"mid-mermaid"},"children":[{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n participant B as Your backend / Journey\n participant API as Mosaic\n participant DE as Risk engine\n participant RE as Rule engine\n participant UI as Transaction Monitoring UI\n\n B->>API: Submit / evaluate transaction via
API or Evaluate Transaction step\n API->>DE: Analyze transaction\n DE->>RE: Apply detection and rules\n RE-->>API: Final recommendation\n API-->>B: Return TRUST / ALLOW /
CHALLENGE / DENY\n API-->>UI: Surface transaction for
investigation\n","diagramHtml":"Transaction Monitoring UIRule engineRisk engineMosaicYour backend / JourneyTransaction Monitoring UIRule engineRisk engineMosaicYour backend / JourneySubmit / evaluate transaction via API or Evaluate Transaction stepAnalyze transactionApply detection and rulesFinal recommendationReturn TRUST / ALLOW / CHALLENGE / DENYSurface transaction for investigation","diagramHtmlDark":"Transaction Monitoring UIRule engineRisk engineMosaicYour backend / JourneyTransaction Monitoring UIRule engineRisk engineMosaicYour backend / JourneySubmit / evaluate transaction via API or Evaluate Transaction stepAnalyze transactionApply detection and rulesFinal recommendationReturn TRUST / ALLOW / CHALLENGE / DENYSurface transaction for investigation"},"children":["sequenceDiagram\n participant B as Your backend / Journey\n participant API as Mosaic\n participant DE as Risk engine\n participant RE as Rule engine\n participant UI as Transaction Monitoring UI\n\n B->>API: Submit / evaluate transaction via
API or Evaluate Transaction step\n API->>DE: Analyze transaction\n DE->>RE: Apply detection and rules\n RE-->>API: Final recommendation\n API-->>B: Return TRUST / ALLOW /
CHALLENGE / DENY\n API-->>UI: Surface transaction for
investigation\n"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The diagrams above show two separate integration paths into the same capability:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SDK/session-based flow"]},", the transaction is reported from a Fraud Prevention SDK session. The SDK returns an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actionToken"]},", and your backend uses that token to fetch the recommendation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["backend/session-less flow"]},", the transaction is submitted directly by your backend or journey and the recommendation is returned in the same evaluation flow, without requiring a device or user session context."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Evaluation combines transaction attributes, historical behavior, and real-time context:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer and payee evaluation"]},": Assesses the parties involved in the transaction, including their known profiles, risk attributes, and relationship to each other. This can include whether a payee is new to the payer or belongs to a higher-risk category."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Historical patterns"]},": Compares the transaction with typical behavior, such as transfer amounts, destinations, frequency, and deviations from the user's usual transaction range."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Real-time context"]},": Evaluates the current transaction as it happens, including velocity within a time window and cross-border activity involving new or higher-risk jurisdictions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rule evaluation"]},": Applies predefined and custom policies that can adjust or override the outcome."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Rules"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fraud Prevention evaluates transactions out of the box. To customize decisions, you can define ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/risk/rules"},"children":["rules"]}," based on transaction conditions such as amount thresholds, payee risk category, or jurisdiction."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the result is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHALLENGE"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DENY"]},", your system should take action (for example, require step-up authentication or block the transaction)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"review-and-manage-transactions","__idx":5},"children":["Review and manage transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction Monitoring"]}," page in the Admin Portal (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fraud Prevention"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction Monitoring"]},") provides a centralized view of reported and evaluated transactions, correlated with Fraud Prevention outcomes and triggered rules. Use it to triage risky payments, investigate individual cases, and feed insights back into your detection strategy."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"explore-and-filter-transactions","__idx":6},"children":["Explore and filter transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The transactions list shows key payment details, including type, amount, parties, recommendation, and timestamp. You can sort the list and customize columns."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use filters to narrow the list by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Time range"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recommendation"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction type"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction amount"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advanced attributes"]}," (transaction, payer, payee, card, device, rule, risk, or assignment data)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"investigate-a-transaction","__idx":7},"children":["Investigate a transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open a transaction to review the context behind its recommendation, including risk details, payment information, session data, and related entities."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview"]},", review the main risk factors, triggered rules, payer and payee details, and payment method."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Session"]},", check the recommendation reasons and session context, including device, browser, location, and anonymization signals."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Entity Analysis"]},", pivot on a related user, network, or device for focused entity analysis, including recent activity and recommendation patterns."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Raw Data"]},", inspect the full raw transaction payload when you need field-level detail."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"act-on-transactions","__idx":8},"children":["Act on transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use follow-up actions to move from investigation to response:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set label"]},": Tag a transaction as fraud, legit, suspected, or undetermined. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/risk/labels"},"children":["Provide feedback with labels"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create rule"]},": Start a new rule from the current transaction. For more details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/risk/rules"},"children":["Rules"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Assign"]}," a transaction to a team member for review."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Analyze"]}," a transaction by generating an AI-assisted summary for faster triage."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Share"]}," a direct link to collaborate on a transaction."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These actions are available from the detail view and in bulk from the transactions list."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"style":{"display":"flex","flexWrap":"wrap","justifyContent":"center","gap":"20px"}},"children":[{"$$mdtype":"Tag","name":"figure","attributes":{"style":{"flex":"1","minWidth":"200px","textAlign":"center","margin":"0"}},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/assets/transaction_monitoring.7438a9854c6a9152d92a4db9642c7fc02a6b42f81c5133d5e5816dfbcbe1d0b2.e95a590b.gif","target":"_blank"},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/transaction_monitoring.7438a9854c6a9152d92a4db9642c7fc02a6b42f81c5133d5e5816dfbcbe1d0b2.e95a590b.gif","alt":"","style":{"maxWidth":"100%","height":"auto","borderRadius":"5px"}},"children":[]}]},{"$$mdtype":"Tag","name":"figcaption","attributes":{"style":{"color":"grey","fontStyle":"italic","fontSize":"14px","textAlign":"left"}},"children":["Click to open the GIF in a dedicated tab."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"data-retention","__idx":9},"children":["Data retention"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transaction information is retained for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1 year"]},", allowing historical analysis, trend identification, and audit compliance across your transaction data."]}]},"headings":[{"value":"Monitor transactions","id":"monitor-transactions","depth":1},{"value":"Choose an integration path","id":"choose-an-integration-path","depth":2},{"value":"How it works","id":"how-it-works","depth":2},{"value":"SDK/session-based flow","id":"sdksession-based-flow","depth":3},{"value":"Backend/session-less flow","id":"backendsession-less-flow","depth":3},{"value":"Review and manage transactions","id":"review-and-manage-transactions","depth":2},{"value":"Explore and filter transactions","id":"explore-and-filter-transactions","depth":3},{"value":"Investigate a transaction","id":"investigate-a-transaction","depth":3},{"value":"Act on transactions","id":"act-on-transactions","depth":3},{"value":"Data retention","id":"data-retention","depth":2}],"frontmatter":{"markdown":{"toc":{"depth":2}},"seo":{"title":"Monitor transactions"}},"lastModified":"2026-04-24T11:03:20.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/risk/transaction_monitoring","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}