> For the complete documentation index, see [llms.txt](https://firstoken.gitbook.io/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://firstoken.gitbook.io/api-docs/api-reference/risk.md).

# Risk

This section is dedicated to providing detailed insights and guidance on our advanced risk management solutions, specifically focusing on Fraud Prevention and Risk Payer Authentication. Our APIs are designed to help businesses enhance their security measures, protect against fraudulent activities, and ensure a seamless payment experience for their customers.

{% hint style="info" %}
**Note**: The base URL is <https://api.firstoken.co/v1/risk>
{% endhint %}

{% hint style="warning" %}
&#x20;For testing in a sandbox environment, the URL is as follows: <https://api.firstoken-staging.co/v1/risk>
{% endhint %}

### Fraud Prevention

The Fraud Prevention module, is a sophisticated tool designed to detect and prevent fraudulent transactions in real-time. By leveraging machine learning algorithms and advanced analytics, the service evaluates transaction data to identify suspicious activities and potential threats.

### Risk Payer Authentication

Risk Payer Authentication, is a security protocol designed to protect online transactions by verifying the identity of the cardholder. Our solution ensures that only authorized users can complete transactions, thereby reducing the risk of fraud.

***

Codes of response

<details>

<summary>200 OK</summary>

**Description:** The request was successful, and the server has returned the requested data.

```json
{
    "status": "success",
    "message": "Transaction in review",
    "data": {
        "transaction_info": {
            "type": "create_decision_response",
            "reference_code": "8e20a087-4527-4512-8939-378e2d400641",
            "transaction_id": "0001733777975387254447",
            "request_id": "7337779757366174204953",
            "status": "Pending_review",
            "created_at": "2024-12-09T20:59:36Z"
        },
        "payment_information": {
            "scheme": "VISA DEBIT",
            "bin": "462294",
            "accountType": "Visa Classic",
            "issuer": "INTL HDQTRS-CENTER OWNED",
            "binCountry": "US"
        },
        "risk_info": {
            "score": "5",
            "model_used": "default",
            "info_codes": {
                "address": [
                    "COR-BA"
                ],
                "phone": [
                    "UNV-PH"
                ],
                "globalVelocity": [
                    "VEL-ADDR",
                    "VEL-NAME",
                    "VELI-CC",
                    "VELL-CC",
                    "VELS-CC",
                    "VELV-CC"
                ],
                "suspicious": [
                    "MUL-EM"
                ],
                "identityChange": [
                    "ID-M-HPOS",
                    "ID-X-NEG",
                    "MORPH-C"
                ],
                "internet": [
                    "INTL-IPCO",
                    "MM-IPBCO"
                ]
            },
            "profile": {
                "earlyDecision": "REVIEW"
            },
            "providers": {
                "fingerprint": {
                    "profile_duration": "7",
                    "test_risk_rating": "neutral"
                }
            },
            "case_priority": "1"
        }
    }
}
```

</details>

<details>

<summary>400 Bad Request</summary>

**Description:** The request could not be understood by the server due to malformed syntax or invalid data.

```json
{
    "status": "fail",
    "message": "Invalid request",
    "data": {
        "description": "Some fields are missing in the request",
        "path": "order_info.amount_details.currency"
    }
}
```

</details>

<details>

<summary>500 Internal Server Error</summary>

**Description:** The server encountered an unexpected condition that prevented it from fulfilling the request

</details>