EZ Exporter Update: New Order Risk Assessment Fields

Shopify has deprecated the Order Risk endpoints starting from the 2024-04 version of the REST and GraphQL APIs in favor of a new Order Risk Assessment endpoint.

We've pushed an update to EZ Exporter to support this new endpoint and the following fields can now be selected when creating a Data Settings for Shopify Order data.

risk.assessments Risk Assessments (type: text). The risk assessments for the order in JSON format.
risk.assessments.facts Risk Assessments - Facts (type: text). Optional facts used to describe the risk assessments in JSON format.
risk.assessments.risk_level Risk Assessments - Risk Levels (type: text). The likelihood that the order is fraudulent, based on the risk assessment. If there are multiple risk assessments, the values will be separated by a comma. Valid values:
  • HIGH: Indicates a high likelihood that the order is fraudulent.
  • LOW: Indicates a low likelihood that the order is fraudulent.
  • MEDIUM: Indicates a medium likelihood that the order is fraudulent.
  • NONE: Indicates that the risk assessment will not provide a recommendation for the order.
  • PENDING: Indicates that the risk assessment is still pending.
risk.recommendation Risk Recommendation (type: text). The recommendation for the order based on the results of the risk assessments. This suggests the action the merchant should take with regards to its risk of fraud. Valid values:
  • ACCEPT: Recommends fulfilling the order.
  • CANCEL: Recommends cancelling the order.
  • INVESTIGATE: Recommends investigating the order by contacting buyers.
  • NONE: There is no recommended action for the order.

The risk.assessments.facts field in particular could come in handy when trying to figure out how the risk level was determined as it provides very detailed information.

Here's an example of what the facts look like:

[
    [
        {
            "description": "Characteristics of this order are similar to non-fraudulent orders observed in the past",
            "sentiment": "POSITIVE"
        },
        {
            "description": "There was 1 payment attempt",
            "sentiment": "POSITIVE"
        },
        {
            "description": "Payment was made with 1 credit card",
            "sentiment": "POSITIVE"
        },
        {
            "description": "The IP address used to place the order isn't a high risk internet connection (web proxy)",
            "sentiment": "POSITIVE"
        },
        {
            "description": "Card Verification Value (CVV) isn't available",
            "sentiment": "NEUTRAL"
        },
        {
            "description": "Billing address or credit card's address wasn't available",
            "sentiment": "NEUTRAL"
        },
        {
            "description": "Billing address ZIP or postal code isn't available to match with credit card's registered address",
            "sentiment": "NEUTRAL"
        },
        {
            "description": "Location of IP address used to place the order isn't available",
            "sentiment": "NEUTRAL"
        },
        {
            "description": "Distance between shipping address and location of IP address isn't available",
            "sentiment": "NEUTRAL"
        },
        {
            "description": "The billing country or the country of the IP used to place the order isn't available",
            "sentiment": "NEUTRAL"
        }
    ]
]

These are basically the information displayed under the "Fraud analysis" section of the Shopify Admin's order detail page.

Tags: new features, ez exporter, fraud analysis