# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://firstoken.gitbook.io/api-docs/api-reference/risk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.