# Update a Previously Scored Transaction

Perform a request to update a previously scored transaction. 

This endpoint uses a valid Basic Authentication username and password for authentication.


Endpoint: POST /update
Version: 2025.04.03.0
Security: basicAuth

## Request fields (application/json):

  - `uuid` (string, required)
    Original risk score uuid
    Example: "e5c920e8-a619-4ca7-a06a-92e36a53e7e6"

  - `agentUpdatedOn` (string)
    When the internal agent updated the order status in ISO 8601 format, UTC timezone, default to current time
    Example: "2017-02-13T21:27:45Z"

  - `agentCode` (string)
    Code for an internal agent who has made changes to the order
    Example: "agent123"

  - `agentDept` (string)
    Department of internal agent
    Example: "dept123"

  - `balance` (integer)
    If multiple payments for an order, the balance due
    Example: 150

  - `event` (string)
    Note about the update
    Example: "event name"

  - `paymentStatus` (string)
    Status of the order payment
    Enum: "AUTH", "PAID", "PARTIALLY_PAID", "INVOICED", "REFUNDED", "PARTIALLY_REFUNDED", "DEFAULT", "PARTIALLY_DEFAULT", "CHARGEBACK", "VOID"

  - `status` (string)
    Status of the order
    Enum: "NEW", "HOLD", "QUEUED", "APPROVED", "CANCELLED", "FULFILLED", "RETURNED"

  - `fraudType` (string)
    Fraud category
    Enum: "PAYMENT_RISK", "POLICY_ABUSE", "FRIENDLY_FRAUD", "OTHER", "IDENTITY_THEFT", "SYNTHETIC_IDENTITY", "ACCOUNT_TAKEOVER", "RETURN", "REFUND", "MARKETPLACE", "NON_PAYMENT", "PACKAGE_THEFT"

  - `fraud` (boolean)

## Response 200 fields (*/*):

  - `success` (boolean)
    Whether the request was successful
    Example: true

  - `uuid` (string)
    Unique ID for request which is generated by risk service
    Example: "e4ef2a10-20b1-4caa-8db0-60b2a3d68070"

  - `code` (string)
    The code if there is an error, such as 900 for internal error
    Example: "900"

  - `messages` (array)
    Array[object], messages if there is any error

  - `messages.keyword` (string)
    Keyword related to the message
    Example: "Internal Error"

  - `messages.message` (string)
    Content of the message such as Internal Error
    Example: "Internal Server Error"

  - `messages.dataPath` (string)
    Path to the data file
    Example: "payment"

  - `data` (object)

  - `data.id` (string)
    UUID of the request
    Example: "e4ef2a10-20b1-4caa-8db0-60b2a3d68070"

  - `data.riskScore` (integer)
    Risk score, on a scale from 0 (low risk) to 100 (high risk)
    Example: 50

  - `data.mostSevereAction` (string)
    Applied action, according to risk assessment
    Example: "cancelled"

  - `data.tags` (array)

  - `data.tags.id` (string)
    Unique ID of your tag

  - `data.tags.action` (string)
    Action name related to rule
    Example: "cancelled"

  - `data.tags.name` (string)
    Name of your tag
    Example: "Rule Cancelled"

  - `data.tags.type` (string)
    Action that you would like your tag to have associated. 'label' will simply tag your order, while 'queue' will cause the order to be placed in a queue for later retrieval and review
    Example: "rule"

  - `data.tags.state` (string)
    Rule set
    Example: "Global Rule Set"