latestOpenAPI 3.0.32026-07-2141248520.9 KB

880b27506cbb

Individual Results

Update the status of Fraud process results

Update the status of a set of Fraud process results. The request body supports batch processing of fraud results with the following components:

  • processResults: Array of UUID strings identifying specific fraud Process Results to update - manualStatus: The resolution status for the fraud, which can be one of:
    • FALSE_POSITIVE: When the result is determined to be false positive.
    • TRUE_POSITIVE: When the result is determined to be true positive.
    • UNKNOWN: When the result is still being evaluated and you do not yet want to resolve it.
  • comment: Optional documentation for the decision rationale, useful for audit trails and team communication
patch/v2/individuals/{entityId}/results/fraud

Headers

api_keystring required
Example:245c765b124a098d09ef8765....

Your API key provided by FrankieOne

X-Frankie-CustomerIDstring required
Example:12345678-1234-1234-1234-123456789012

Your Customer ID provided by FrankieOne

X-Frankie-CustomerChildIDstring
Example:87654321-4321-4321-4321-210987654321

Your Customer Child ID provided by FrankieOne

X-Frankie-Channelstring

Open string that can be used to define the "channel" the request comes in from. It can potentially be used in routing and risk calculations upon request. Default values that can be used are: api portal smartui Any alphanumeric string is supported though. Anything over 64 characters will be truncated.

X-Frankie-Usernamestring
Example:fred.flintstone@frankieone.com

Username provided by API caller

Request body

processResultsstring[] required

The process result IDs to update. These are the PROs created when a fraud has been found.

manualStatus'FALSE_POSITIVE_ACCEPT' | 'FALSE_POSITIVE_REJECT' | 'TRUE_POSITIVE_ACCEPT' | 'TRUE_POSITIVE_REJECT' required

The status that the fraud process result should be set to after the results have been reviewed.

  • FALSE_POSITIVE_ACCEPT: When the result is determined to be false positive and it is an acceptable risk.
  • FALSE_POSITIVE_REJECT: When the result is determined to be false positive and it is an unacceptable risk.
  • TRUE_POSITIVE_ACCEPT: When the result is determined to be true positive and it is an acceptable risk.
  • TRUE_POSITIVE_REJECT: When the result is determined to be true positive and it is an unacceptable risk.

Example request

{
  "comment": {
    "commentId": "55fc5d54-46f7-49c8-bf78-e07ec79cd6e7",
    "text": "Update after speaking to customer over the phone directly."
  }
}

Response

OK

requestIdstring required

The unique request identifier for the API call made.

processResultsProcessResultObject[] required— unresolved $ref