From ea3bab5e55ab43c6d67963f6409b641b5aa50d32 Mon Sep 17 00:00:00 2001 From: Matthew Hutchinson Date: Fri, 15 May 2026 16:54:14 +0100 Subject: [PATCH] docs(checkout): cross-link cart_id from Create Checkout The cart capability extends create_checkout with a cart_id field for cart-to-checkout conversion (defined in cart.json #/$defs/checkout). Today this is covered in prose on the cart page under 'Cart-to-Checkout Conversion', but a reader on the checkout page has no way to discover it from the Create Checkout section. Add a one-line cross-link under Create Checkout pointing to the existing cart.md#cart-to-checkout-conversion section. --- docs/specification/checkout.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/specification/checkout.md b/docs/specification/checkout.md index 007827bb0..d88d837c5 100644 --- a/docs/specification/checkout.md +++ b/docs/specification/checkout.md @@ -565,6 +565,11 @@ To be invoked by the platform when the user has expressed purchase intent product data (price/title etc.) provided by the business through the feeds **SHOULD** match the actual attributes returned in the response. +When the [Cart](cart.md) capability is negotiated, the request payload +accepts an additional `cart_id` field for cart-to-checkout conversion. See +[Cart → Cart-to-Checkout Conversion](cart.md#cart-to-checkout-conversion) for +the field contract. + {{ method_fields('create_checkout', 'rest.openapi.json', 'checkout') }} ### Get Checkout