---
title: "ACP Checkout Lifecycle Check: OpenAPI Contract Gate"
slug: "acp-checkout-lifecycle-check"
date: "2026-03-25"
category: "release"
tags: ["codex-skill", "agentic-commerce", "checkout", "openapi"]
---

## What this skill does

This skill validates that merchant-hosted checkout APIs expose the full lifecycle contract (`create`, `update`, `retrieve`, `complete`, `cancel`) in an OpenAPI JSON spec.

## Why it is useful

Discovery and checkout drift apart when lifecycle endpoints are incomplete. This gate enforces the ACP checkout path before production handoff.

## Core command

```bash
cd "<domain-management-root>"
python3 codex-skills.com/scripts/acp_checkout_lifecycle_check.py \
  --openapi /path/to/openapi.json
```

## Inputs and outputs

- Inputs:
  - OpenAPI JSON with `paths` object
- Outputs:
  - lifecycle compliance summary to stdout
  - non-zero exit when required operations are missing

## Compatibility

- Surface: `codex-cli`
- Requires network: no
- Requires escalated permissions: no
- Required tools: `python3`

## Safety notes

- Static contract check only; does not call live payment endpoints.
- Helps enforce replay-safe architecture before runtime tests.

## Sources

- [OpenAI product discovery update](https://openai.com/index/powering-product-discovery-in-chatgpt/)
- [OpenAI Commerce checkout spec](https://developers.openai.com/commerce/specs/checkout)
- [ACP merchant-hosted checkout guide](https://agentic-commerce-protocol.org/guides/merchant-hosted-checkout-path)