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.

Note: The base URL is https://api.firstoken.co/v1/risk

For testing in a sandbox environment, the URL is as follows: https://api.firstoken-staging.co/v1/risk

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

200 OK

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

{
    "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"
        }
    }
}

400 Bad Request

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

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

500 Internal Server Error

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