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

# Fraud Checks

### Video Guide

<div style={{ position: 'relative', paddingBottom: '56.25%', height: '450px' }}>
  <iframe src="https://www.loom.com/embed/1f3cee9293bc407a83e7b1a8a5cbc056?sid=5f1d151d-f237-43ff-82be-3f04135e299c&hide_speed=true&hide_share=true" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '450px' }} />
</div>

## Introduction

Fraud Prevention & Risk-Based Onboarding lets you screen every applicant during onboarding by analyzing device, email, and phone signals in real time. The API works with FrankieOne oneSDK to gather silent risk indicators and trigger additional checks only when needed, helping you:

* Block fraudulent sign-ups before they reach KYC
* Reduce friction for genuine customers
* Lower manual review and operational costs

## Key Features

<CardGroup cols={2}>
  <Card title="Silent device intelligence & behavioural biometrics" icon="user-secret" iconType="light">
    Collects IP, user-agent, jailbreak status, VPN usage, and behavioural patterns without user interaction.
  </Card>

  <Card title="Silent email and phone checks" icon="id-card" iconType="light">
    Verifies deliverability, tenure, and risk signals behind the scenes.
  </Card>

  <Card title="Risk-based decisioning" icon="scale-balanced" iconType="light">
    Combines fraud and KYC scores, applies custom thresholds, and surfaces clear recommendations.
  </Card>

  <Card title="Intrusive verification when risk is high" icon="magnifying-glass" iconType="light">
    Triggers IDV, liveness, or OCR only for medium or high-risk users.
  </Card>

  <Card title="Rule-based risk engine" icon="list-check" iconType="light">
    Configure risk thresholds and scorecards in the portal—no code required.
  </Card>

  <Card title="Unified risk score" icon="shield-check" iconType="light">
    Combines Fraud and KYC risk into a single assessment for smarter decisions.
  </Card>
</CardGroup>

## What's a Fraud Check?

After the customer or entity has run the onboarding check, you can view any fraud-related issues in the workflow events tab. If there are any alerts found, these may include risks or issues related to email, phone, device, or IP checks. These alerts can be resolved individually.

## Reviewing Fraud Check Results

Filter the entities table with fraud as one of the selected issues. Selecting an entity that has fraud issues will take you to the entity view and show the workflow events tab with the onboarding fraud check result.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-entity-list.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=a000f9b9dd3f349cd27fb01a3476ce55" alt="Filter the entities table for Fraud issues" width="1919" height="508" data-path="images/v2/portal/fraud-entity-list.webp" />

**Displaying Issues**: If the system detects potential fraud issues (known as PROs) in any of the checked sections (such as email, phone, device, IP), you will see a view similar to the image below, prompting you to check and resolve these items.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-entity-details.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=54ea3014878fe2b35e7ad23251acda75" alt="" width="1915" height="934" data-path="images/v2/portal/fraud-entity-details.webp" />

From here, you can view the risk level and overview of each section. Device and IP location are grouped together by `deviceId`.

## Fraud Check Details

**Visibility Requirement**: The onboarding fraud checks are only visible if enabled on your account. To enable them, please reach out to your Frankie Account Manager.

You can view the details by clicking on one of the `Review full details`, `Rules triggered badges`, or the `table rows under the device & IP location`. This will open a drawer with the content of the selected section.

Clicking on "more details" will redirect you to view the external link.

### Email Section:

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-email-alerts.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=46a07b5c16d2e129bc068d3e40542be7" alt="" width="1917" height="932" data-path="images/v2/portal/fraud-email-alerts.webp" />

### Phone Section:

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-phone-alerts.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=80778741402525863e2c38ebd9eed9fd" alt="" width="1913" height="932" data-path="images/v2/portal/fraud-phone-alerts.webp" />

### Device & IP Section:

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-device-alerts.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=ddd03e4dcd60ccd213d9dc3ceae517af" alt="" width="1914" height="934" data-path="images/v2/portal/fraud-device-alerts.webp" />

## Resolving Fraud Check Issues

You can resolve issues by selecting the **Resolve** button on the right side of the onboarding fraud check container.

There may be cases where the resolve button is not visible. This is because there are no PROs that need to be resolved, meaning the email, phone, device, and IP sections are all cleared and nothing needs to be resolved.

If all of the checks need to be resolved, Selecting the **Resolve** link will open a modal. Decide whether to approve or reject and add a comment.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-resolve-check.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=2d15574ce49818301eb80f87ec97f011" alt="" width="600" height="380" data-path="images/v2/portal/fraud-resolve-check.webp" />

If the device is the only thing that needs to be resolved, then the option will only show the device session.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-resolve-check-2.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=1be1c56112fa437cd4ad1485ee53cca0" alt="" width="675" height="376" data-path="images/v2/portal/fraud-resolve-check-2.webp" />

By marking all the signs of fraud as **No**, the decision will only show the **Approve** option.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-resolve-check-3.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=e888819e613fec07025c64543b56b11e" alt="" width="674" height="382" data-path="images/v2/portal/fraud-resolve-check-3.webp" />

After you click **Resolve alert** with the decision of **Approve**, it will show the status of `Manually approved` beside the onboarding fraud check title.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-check-manually-approved.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=75ba7738567e9c2158b67b6979d7f387" alt="" width="840" height="89" data-path="images/v2/portal/fraud-check-manually-approved.webp" />

If you decide to reject, it will show the status of `Manually rejected` beside the onboarding fraud check title.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-check-manually-rejected.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=d01cc2f4b1b85869b8d91ac50e664750" alt="" width="830" height="71" data-path="images/v2/portal/fraud-check-manually-rejected.webp" />

Hover over the comment icon to see the comment box.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-check-comment-box.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=63d32fe42a3c1f267ca3aaeda6a40833" alt="" width="820" height="114" data-path="images/v2/portal/fraud-check-comment-box.webp" />

## Fraud Check Comments

If you click on the comment icon, it will open the comment history box on the right side to see all previous comments after you have resolved an issue.

<img src="https://mintcdn.com/frankieone-f5583b1b/SnCigSgkA9Jnv8RS/images/v2/portal/fraud-comment-section.webp?fit=max&auto=format&n=SnCigSgkA9Jnv8RS&q=85&s=30e517c18a1f6e75b086a880fc173612" alt="" width="1914" height="935" data-path="images/v2/portal/fraud-comment-section.webp" />

Please be aware that comments may be duplicated after you have resolved an issue. This is expected because answering yes and no in the resolve modal for each of the checks (email/phone/device) will call two APIs simultaneously.
