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

# Transaction Monitoring Overview

> Integrate with OmniEagle for secure and compliant risk evaluation of transactions

This chapter explains the process of integrating with the ecrop OmniEagle platform for transaction monitoring and risk evaluation. It outlines the necessary steps and API interactions involved in submitting transaction data and retrieving risk evaluation results.

## Prerequisites for Transaction Monitoring Integration

Before integrating with the OmniEagle Transaction Monitoring APIs, ensure you fulfill the following prerequisites:

<Steps>
  <Step title="Client Authentication and Authorization">
    Obtain valid credentials for accessing the OmniEagle API. Refer to the [Onboarding Section](client-onboarding) for details on how to register your application and obtain access credentials for calling our APIs.
  </Step>

  <Step title="Data Mapping and Transformation">
    Familiarize yourself with the data requirements for the /omni-eagle/v1/transactions endpoint. Ensure that you are capturing and mapping all necessary transaction details, including amount, currency, source/destination wallets, transaction ID, and timestamp. Accurate and consistent data mapping is crucial for reliable risk evaluations.
  </Step>

  <Step title="Webhook Endpoint Setup">
    Configure a secure and reliable webhook endpoint in your system to receive asynchronous risk evaluation results from OmniEagle. This endpoint should be able to handle POST requests and parse the JSON payload containing the risk score, risk level, and detailed risk analysis (if available). The webhook URL must be accessible from the internet and properly secured to prevent unauthorized access.
  </Step>

  <Step title="Error Handling and Logging">
    Implement robust error handling and logging mechanisms to track and manage any issues that may arise during the integration process. Log all API requests, responses, and webhook notifications to facilitate troubleshooting and auditing.
  </Step>
</Steps>

## Submitting Transaction Data for Risk Evaluation

After fulfilling the prerequisites, you can begin the process of submitting transaction data for risk evaluation using the OmniEagle API.

1. **Create Risk Evaluation Order:** Submit a POST request to the /omni-eagle/v1/transactions endpoint, providing the necessary transaction data, a unique reference number, and your webhook URL in the request body.
2. **Handle API Responses:** Process the API response to determine if the risk evaluation order was successfully accepted. A 201 response indicates successful acceptance, while a 208 response indicates that the order has already been received.
3. **Receive Asynchronous Results:** OmniEagle processes the transaction data and asynchronously sends the risk evaluation result to the provided webhook URL.
4. **Process Webhook Notification:** Upon receiving the webhook notification, parse the JSON payload to extract the risk score, risk level, and detailed risk analysis (if available).
5. **Retrieve Risk Evaluation (Optional):** If necessary, you can retrieve the risk evaluation result using the /omni-eagle/v1/transactions/{referenceNumber} endpoint.
6. **Enforce Policies:** Based on the received risk evaluation, enforce appropriate policies and take necessary actions, such as flagging suspicious transactions for further investigation or blocking transfers.