{"id":7959,"date":"2026-07-20T12:54:26","date_gmt":"2026-07-20T04:54:26","guid":{"rendered":"https:\/\/www.fraudlabspro.com\/resources\/?post_type=docs&p=7959"},"modified":"2026-07-21T12:29:58","modified_gmt":"2026-07-21T04:29:58","password":"","slug":"fraudlabs-pro-screen-order-api-now-supports-item-level-order-data","status":"publish","type":"docs","link":"https:\/\/www.fraudlabspro.com\/resources\/tutorials\/fraudlabs-pro-screen-order-api-now-supports-item-level-order-data\/","title":{"rendered":"FraudLabs Pro Screen Order API Now Supports Item-Level Order Data"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n

FraudLabs Pro is excited to introduce a new items<\/strong> parameter for the Screen Order API<\/strong><\/a>, giving merchants greater visibility into the products contained in every order submitted for fraud analysis. With this enhancement, businesses can include detailed item-level information alongside their order data, enabling more granular validation and making it easier to create product-specific fraud prevention rules.<\/p>\n\n\n\n

What Is the items Parameter<\/h2>\n\n\n\n

The new items<\/strong> parameter is an optional<\/strong> field in the Screen Order API. It accepts a JSON array of objects, where each object represents an individual item in the order.<\/p>\n\n\n\n

Each item supports the following fields:<\/p>\n\n\n\n

Field<\/strong><\/td>Required<\/strong><\/td>Description<\/strong><\/td><\/tr>
sku<\/td>Yes<\/td>The product SKU (Stock Keeping Unit).<\/td><\/tr>
quantity<\/td>Yes<\/td>The quantity purchased.<\/td><\/tr>
price<\/td>Yes<\/td>The unit price of the item.<\/td><\/tr>
type<\/td>No<\/td>The item type like physical, virtual or downloadable.<\/td><\/tr>
name<\/td>No<\/td>The product name.<\/td><\/tr>
purchase_type<\/td>No<\/td>A custom field that merchants can use for their own reference or internal categorization.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

The purchase_type<\/strong> field is intentionally flexible. Merchants can populate it with any value that suits their business workflows, such as subscription, upgrade, one-time purchase, renewal, recharge, etc.<\/p>\n\n\n\n

Example Request<\/h2>\n\n\n\n

Below is an example showing how the items parameter can be included in a Screen Order API request:<\/p>\n\n\n\n