---
title: "Create a Shopify-hosted checkout for buyer review"
method: POST
path: "/v1/agent/checkout-sessions"
---

# Create a Shopify-hosted checkout for buyer review

`POST /v1/agent/checkout-sessions`

## Request

- Base URL: `https://agent-commerce.homebridgepc.com`
- URL: `https://agent-commerce.homebridgepc.com/v1/agent/checkout-sessions`
- Auth: HTTP bearer

Authenticated, stateful integration route, distinct from public exact-SKU records and buyer-controlled cart permalinks. Prices, discounts, variant IDs, shipping promises, and totals are merchant-controlled fields rather than client inputs. Final review and completion occur in Shopify Checkout.

## Headers

- `Idempotency-Key` string, required

## Request body

- CheckoutSessionRequest
  - `sku` string, required
  - `quantity` integer, required
  - `source` string, required
  - `agentSessionId` string
  - `buyerAcknowledgements` object, required

## Response `201`

Shopify checkout ready for buyer review

## Other responses

- `401`: Missing, invalid, revoked, or expired credential
- `403`: Credential lacks scope or offer permission
- `503`: Global agent-commerce kill switch is engaged

---

[API](https://skmtc.dev/homebridgepc/apis/halo-homebridge-agent-commerce-api.md) · [All operations](https://skmtc.dev/homebridgepc/apis/halo-homebridge-agent-commerce-api/llms.txt) · [OpenAPI document](https://skmtc.dev/homebridgepc/apis/halo-homebridge-agent-commerce-api/revisions/14766d95177c?raw)