New Feature

FraudLabs Pro’s Screen Order API Now Supports Item-Level Order Data

Photo by Kaitlyn Baker on Unsplash

Merchants can now submit product details such as SKUs, quantities, prices, and item types for more targeted fraud screening.

Fraud detection becomes more effective when businesses can evaluate not only who placed an order, but also what the order contains.

FraudLabs Pro has introduced a new optional items parameter for the Screen Order API. The enhancement allows merchants to submit detailed product information alongside their existing order data, providing richer context for fraud analysis.

With item-level data, businesses can apply more granular validation and create fraud prevention rules based on specific products, SKUs, or item types — without disrupting their existing API integrations.

What Is the items Parameter?

The items parameter accepts a JSON array of objects. Each object represents an individual product or item included in an order.

Merchants can provide the following fields for each item:

The purchase_type field is intentionally flexible. Businesses can use values that match their own workflows, such as:

• Subscription
• Upgrade
• One-time purchase
• Renewal
• Recharge

This flexibility makes it easier to distinguish between different transaction models when reviewing or processing orders.

Example API Request

The following example shows how item-level information can be included in a Screen Order API request:

"items": [
  {
    "sku": "SKU-1001",
    "quantity": 1,
    "price": 99.99,
    "type": "physical",
    "name": "Wireless Headphones",
    "purchase_type": "one-time purchase"
  },
  {
    "sku": "SKU-2005",
    "quantity": 2,
    "price": 19.95,
    "type": "downloadable",
    "name": "Country List"
  }
]

Each item is processed independently, allowing FraudLabs Pro to evaluate product information more effectively while preserving compatibility with existing API integrations.

Plan Limits

The items parameter is available across all FraudLabs Pro plans.

The number of items that can be submitted depends on the merchant’s plan:

• **Free Micro plan:** Up to three items per order
• **Paid plans:** No limit on the number of items per order

This allows merchants with larger shopping carts or wholesale transactions to submit complete item information without restrictions.

More Powerful SKU Validation

The new parameter extends the capabilities of the existing SKU Validation rule.

When an order contains an items array, the rule can evaluate the sku value of every submitted item. This enables merchants to build rules around individual products rather than relying only on order-level information.

For example, a business could apply additional scrutiny when an order contains:

• A frequently targeted product
• A high-value SKU
• A limited-edition item
• A product with a history of fraudulent purchases

This makes fraud prevention strategies more precise and easier to adapt to product-specific risks.

Item Type Validation

The Item Type Validation rule can also evaluate the optional type field included with each item.

Merchants can use this rule to distinguish between categories such as:

• Physical products
• Virtual goods
• Downloadable products

Different product types often carry different fraud risks. A downloadable product, for example, can be delivered immediately and may require a different screening strategy from a physical item that must be shipped.

By combining item types with other order and customer signals, businesses can create validation rules that better reflect how their products are sold and fulfilled.

Both the SKU Validation and Item Type Validation rules can be configured from the FraudLabs Pro Rule page.

Richer Order Context Leads to Better Fraud Decisions

Order-level information remains important, but item-level data provides an additional layer of context.

By submitting product details through the new items parameter, merchants can:

• Identify risks associated with specific products
• Apply rules to individual SKUs
• Differentiate between physical and digital goods
• Categorize purchases according to internal workflows
• Screen large or complex orders more effectively

Most importantly, businesses can begin using the enhancement without affecting their current Screen Order API integration.

Whether you are using the Free Micro plan or a paid plan, adding item details can help FraudLabs Pro produce a more complete picture of each transaction.

Start including the optional items parameter in your Screen Order API requests to create smarter validation rules and strengthen your protection against online fraud.

Experience Item-Level Order Data Today

Free Micro plan: Submit up to three items per order. Try it for free

Paid plans: Submit an unlimited number of items per order. Subscribe now