Skip to content

docs(checkout-a2a): restate the complete_in_progress freeze for transport parity - #670

Closed
vishkaty wants to merge 1 commit into
Universal-Commerce-Protocol:mainfrom
vishkaty:fix/a2a-complete-in-progress-freeze
Closed

vishkaty wants to merge 1 commit into
Universal-Commerce-Protocol:mainfrom
vishkaty:fix/a2a-complete-in-progress-freeze

Conversation

@vishkaty

@vishkaty vishkaty commented Aug 1, 2026 •

Copy link
Copy Markdown
Contributor

Problem

The complete_in_progress update-freeze MUST is stated in the core checkout lifecycle and in the REST, MCP, OpenAPI, and OpenRPC contracts, but the A2A checkout binding (docs/specification/shopping/checkout/a2a.md) does not restate it. It has only a messageId-based Request Idempotency section and uses add_to_checkout / complete_checkout action verbs, so an implementer reading only the A2A binding gets no signal about the freeze.

Fix

Add the freeze to the A2A Request Idempotency section, adapted to the A2A action model: while a Checkout is complete_in_progress, the platform MUST NOT send a further checkout-modifying message (for example add_to_checkout), and the business agent MUST leave the Checkout unchanged and return a recoverable error Message.

Verification

validate_examples.py 343 passed (unchanged), re-measured 2026-09-01 on a test merge into main 1d39948; spellcheck clean; the index.md#update-checkout anchor resolves.

Raised from #665.

@damaz91 damaz91 added status:needs-triage Signal that the PR is ready for human triage documentation Improvements or additions to documentation status:under-review and removed status:needs-triage Signal that the PR is ready for human triage labels Aug 1, 2026
@damaz91
damaz91 requested review from alexpark20 and gsmith85 August 3, 2026 07:58
@dkoch74 dkoch74 added the area:payments Issues and pull requests related to the Payments vertical label Aug 5, 2026
@vishkaty

Copy link
Copy Markdown
Contributor Author

@gsmith85 companion to #659. This restates the complete_in_progress freeze in the A2A binding for parity with the other transports. Glad to adjust.

…port parity

The `complete_in_progress` update-freeze MUST is stated in the core checkout
lifecycle and in the REST, MCP, OpenAPI, and OpenRPC contracts, but the A2A
checkout binding does not restate it; it has only a `messageId`-based Request
Idempotency section and uses `add_to_checkout` / `complete_checkout` action
verbs. An implementer reading only the A2A binding gets no signal about the
freeze.

Add the freeze to the A2A Request Idempotency section, adapted to the A2A action
model: while a Checkout is `complete_in_progress`, the platform MUST NOT send a
further checkout-modifying message, and the business agent MUST leave the
Checkout unchanged and return a recoverable error.
@vishkaty
vishkaty force-pushed the fix/a2a-complete-in-progress-freeze branch from 535f6b3 to 007e60c Compare August 21, 2026 17:53
@dkoch74

dkoch74 commented Aug 24, 2026

Copy link
Copy Markdown
Member

@gsmith85 can you please review?

@damaz91 damaz91 added status:stale-review Applied if a PR is waiting on a reviewer for too long and removed status:under-review labels Sep 14, 2026
@damaz91
damaz91 requested review from archrao and yanheChen and removed request for alexpark20 September 21, 2026 10:42
@gsmith85

gsmith85 commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

Thanks for raising this, @vishkaty. After looking closely at how a2a.md is structured, I think we should keep the complete_in_progress operation contract exclusively in checkout/index.md rather than duplicating it here.

#582 only touched rest.md and mcp.md because those files have dedicated Update Checkout sections stating the full-replacement rule, which needed to be qualified for complete_in_progress. a2a.md delegates the checkout status lifecycle (incomplete, ready_for_complete, requires_escalation, complete_in_progress, canceled) entirely to checkout/index.md, so restating just this one lifecycle rule under Request Idempotency would be out of place. Closing this out, and we can resolve the second item of #665 on the same basis.

@gsmith85 gsmith85 closed this Oct 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:payments Issues and pull requests related to the Payments vertical documentation Improvements or additions to documentation status:stale-review Applied if a PR is waiting on a reviewer for too long

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants