From f8da4463a04dba26bbe12c44f98017a287b8b3dd Mon Sep 17 00:00:00 2001
From: James Thompson <thompson.tomo@outlook.com>
Date: Fri, 23 Jan 2026 20:08:39 +1100
Subject: [PATCH] update line item ids to differentiate from item ids

---
 docs/specification/checkout-mcp.md  | 15 ++++++++-------
 docs/specification/checkout-rest.md | 22 +++++++++++-----------
 2 files changed, 19 insertions(+), 18 deletions(-)

diff --git a/docs/specification/checkout-mcp.md b/docs/specification/checkout-mcp.md
index 3f61b170..a84ee8f5 100644
--- a/docs/specification/checkout-mcp.md
+++ b/docs/specification/checkout-mcp.md
@@ -202,7 +202,7 @@ Maps to the [Create Checkout](checkout.md#create-checkout) operation.
         },
         "line_items": [
           {
-            "id": "item_123",
+            "id": "li_1",
             "item": {
               "id": "item_123",
               "title": "Blue Jeans",
@@ -236,7 +236,7 @@ Maps to the [Create Checkout](checkout.md#create-checkout) operation.
             {
               "id": "shipping_1",
               "type": "shipping",
-              "line_item_ids": ["item_123"],
+              "line_item_ids": ["li_1"],
               "selected_destination_id": "dest_home",
               "destinations": [
                 {
@@ -251,7 +251,7 @@ Maps to the [Create Checkout](checkout.md#create-checkout) operation.
               "groups": [
                 {
                   "id": "package_1",
-                  "line_item_ids": ["item_123"],
+                  "line_item_ids": ["li_1"],
                   "selected_option_id": "standard",
                   "options": [
                     {
@@ -368,6 +368,7 @@ Maps to the [Update Checkout](checkout.md#update-checkout) operation.
             "item": {
               "id": "item_123"
             },
+            "id": "li_1",
             "quantity": 1
           }
         ],
@@ -376,7 +377,7 @@ Maps to the [Update Checkout](checkout.md#update-checkout) operation.
           "methods": [
             {
               "id": "shipping_1",
-              "line_item_ids": ["item_123"],
+              "line_item_ids": ["li_1"],
               "groups": [
                 {
                   "id": "package_1",
@@ -421,7 +422,7 @@ Maps to the [Update Checkout](checkout.md#update-checkout) operation.
         },
         "line_items": [
           {
-            "id": "item_123",
+            "id": "li_1",
             "item": {
               "id": "item_123",
               "title": "Blue Jeans",
@@ -455,7 +456,7 @@ Maps to the [Update Checkout](checkout.md#update-checkout) operation.
             {
               "id": "shipping_1",
               "type": "shipping",
-              "line_item_ids": ["item_123"],
+              "line_item_ids": ["li_1"],
               "selected_destination_id": "dest_home",
               "destinations": [
                 {
@@ -470,7 +471,7 @@ Maps to the [Update Checkout](checkout.md#update-checkout) operation.
               "groups": [
                 {
                   "id": "package_1",
-                  "line_item_ids": ["item_123"],
+                  "line_item_ids": ["li_1"],
                   "selected_option_id": "express",
                   "options": [
                     {
diff --git a/docs/specification/checkout-rest.md b/docs/specification/checkout-rest.md
index 38cff117..3f9483c5 100644
--- a/docs/specification/checkout-rest.md
+++ b/docs/specification/checkout-rest.md
@@ -449,7 +449,7 @@ type & addresses.
           {
             "id": "shipping_1",
             "type": "shipping",
-            "line_item_ids": ["item_123"],
+            "line_item_ids": ["li_1"],
             "selected_destination_id": "dest_home",
             "destinations": [
               {
@@ -464,7 +464,7 @@ type & addresses.
             "groups": [
               {
                 "id": "package_1",
-                "line_item_ids": ["item_123"],
+                "line_item_ids": ["li_1"],
                 "selected_option_id": "standard",
                 "options": [
                   {
@@ -571,7 +571,7 @@ Follow-up calls after initial `fulfillment` data to update selection.
           {
             "id": "shipping_1",
             "type": "shipping",
-            "line_item_ids": ["item_123"],
+            "line_item_ids": ["li_1"],
             "selected_destination_id": "dest_home",
             "destinations": [
               {
@@ -659,7 +659,7 @@ Follow-up calls after initial `fulfillment` data to update selection.
           {
             "id": "shipping_1",
             "type": "shipping",
-            "line_item_ids": ["item_123"],
+            "line_item_ids": ["li_1"],
             "selected_destination_id": "dest_home",
             "destinations": [
               {
@@ -674,7 +674,7 @@ Follow-up calls after initial `fulfillment` data to update selection.
             "groups": [
               {
                 "id": "package_1",
-                "line_item_ids": ["item_123"],
+                "line_item_ids": ["li_1"],
                 "selected_option_id": "express",
                 "options": [
                   {
@@ -855,7 +855,7 @@ place to set these expectations via `messages`.
           {
             "id": "shipping_1",
             "type": "shipping",
-            "line_item_ids": ["item_123"],
+            "line_item_ids": ["li_1"],
             "selected_destination_id": "dest_home",
             "destinations": [
               {
@@ -870,7 +870,7 @@ place to set these expectations via `messages`.
             "groups": [
               {
                 "id": "package_1",
-                "line_item_ids": ["item_123"],
+                "line_item_ids": ["li_1"],
                 "selected_option_id": "express",
                 "options": [
                   {
@@ -1023,7 +1023,7 @@ place to set these expectations via `messages`.
           {
             "id": "shipping_1",
             "type": "shipping",
-            "line_item_ids": ["item_123"],
+            "line_item_ids": ["li_1"],
             "selected_destination_id": "dest_home",
             "destinations": [
               {
@@ -1038,7 +1038,7 @@ place to set these expectations via `messages`.
             "groups": [
               {
                 "id": "package_1",
-                "line_item_ids": ["item_123"],
+                "line_item_ids": ["li_1"],
                 "selected_option_id": "express",
                 "options": [
                   {
@@ -1187,7 +1187,7 @@ place to set these expectations via `messages`.
           {
             "id": "shipping_1",
             "type": "shipping",
-            "line_item_ids": ["item_123"],
+            "line_item_ids": ["li_1"],
             "selected_destination_id": "dest_home",
             "destinations": [
               {
@@ -1202,7 +1202,7 @@ place to set these expectations via `messages`.
             "groups": [
               {
                 "id": "package_1",
-                "line_item_ids": ["item_123"],
+                "line_item_ids": ["li_1"],
                 "selected_option_id": "express",
                 "options": [
                   {