Item-Level Tax Amount

Item-Level Tax Amount

Overview

The order payload includes a tax_amount field on each item, surfacing the tax applied to that specific line item.

What's New

A new field, tax_amount, is included on each item in the order payload. This field represents the tax applied to that specific item, expressed in the same minor currency unit as other monetary fields (e.g., cents).

Why This Matters

• Enables merchants to see tax breakdowns per item
• Supports more accurate reconciliation and reporting
• Aligns item-level data with order-level tax totals

Example

New field highlighted below: tax_amount

{
  "event": {
    "type": "OrderCreate",
    "status": "NEW"
  },
  "order": {
    "id": "e0f07796-38d0-42e7-a044-52ac37ec7620",
    "store_order_cart_id": "3000010869268097",
    "tax": 78,
    "subtotal": 908,
    "estimated_pickup_time": "2026-01-29T23:21:11+00:00",
    "is_pickup": false,
    "order_special_instructions": "",
    "delivery_address": {},
    "consumer": {
      "id": 2251800019558741,
      "first_name": "TAS-USER",
      "last_name": "T",
      "email": "[email protected]",
      "phone": "8552228111"
    },
    "store": {
      "merchant_supplied_id": "def_2024",
      "provider_type": "newverticals_sandbox",
      "timezone": "US/Pacific",
      "store_business": {
        "auto_release_enabled": false
      },
      "id": "31437511"
    },
    "categories": [
      {
        "merchant_supplied_id": "Apparel",
        "name": "Apparel",
        "items": [
          {
            "name": "Men's Pants",
            "quantity": 1,
            "price": 429,
            "merchant_supplied_id": "mens-pants-001",
            "consumer_name": "TAS-USER",
            "extras": [],
            "special_instructions": "",
            "line_item_id": "ff877b5d-d056-4ef1-8a94-3074085f433e",
            "tax_amount": 36
          }
        ]
      },
      {
        "merchant_supplied_id": "Kids",
        "name": "Kids Apparel",
        "items": [
          {
            "name": "Kid's T-Shirt",
            "quantity": 1,
            "price": 479,
            "merchant_supplied_id": "kids-tshirt-001",
            "consumer_name": "TAS-USER",
            "extras": [],
            "special_instructions": "",
            "line_item_id": "09a8c71c-1d30-41c3-9d8e-93c48555ac29",
            "tax_amount": 42
          }
        ]
      }
    ],
    "delivery_short_code": "574f8d3a",
    "tax_transaction_id": "",
    "is_demand_gen": false,
    "commission_type": "regular",
    "is_tax_remitted_by_doordash": false,
    "tax_amount_remitted_by_doordash": 0,
    "fulfillment_type": "dx_delivery",
    "subtotal_for_tax": 908,
    "merchant_tip_amount": 0,
    "experience": "DOORDASH",
    "applied_loyalty_reward_details": {
      "rewards": [],
      "rewards_total": 0
    }
  }
}