---
title: "POST /agent-commerce/acp/checkout_sessions"
method: POST
path: "/agent-commerce/acp/checkout_sessions"
---

# POST /agent-commerce/acp/checkout_sessions

`POST /agent-commerce/acp/checkout_sessions`

## Request

- Base URL: `https://mondoir.art`
- URL: `https://mondoir.art/agent-commerce/acp/checkout_sessions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mondoir/apis/mondoir-api/docs/agent-commerce/acp/checkout_sessions/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a one-item progressive checkout. Read the payment handler specification.

## Request body

- object
  - `buyer` object
    - `email` string, email
    - `first_name` string
    - `last_name` string
    - `full_name` string
    - `phone_number` string
  - `currency` 'USD', required
  - `line_items` object[], required
    - `id` string, required
    - `name` string
    - `unit_amount` integer
  - `capabilities` object, required
    - `extensions` string[]
    - `interventions` object
      - `supported` string[], required
    - `payment` object
      - `handlers` object[], required
        - `id` string, required
  - `metadata` object
    - `mondoir` object
      - `payer` union
        - string
        - string
      - `network` 'eip155:8453' | 'eip155:137' | 'eip155:42161' | 'eip155:480' | 'eip155:143' | 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp'
      - `quantity` integer
      - `variantId` string
      - `editionNumber` integer
      - `editionNumbers` integer[]
      - `walletAddress` string
  - `fulfillment_details` object
    - `name` string
    - `email` string, email
    - `phone_number` string
    - `address` object
      - `name` string, required
      - `line_one` string, required
      - `line_two` string
      - `city` string, required
      - `state` string, required
      - `country` string, required
      - `postal_code` string, required
  - `selected_fulfillment_options` object[]
    - `type` 'shipping' | 'digital', required
    - `option_id` 'standard', required
    - `item_ids` string[], required

## Response `201`

Created checkout.

## Changes

- **2026-11-09** `5c50dd5066f8`: 2 breaking, 3 warning
  - added the pattern `^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$` to the request property `buyer/email`
  - added the pattern `^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$` to the request property `fulfillment_details/email`
  - the `line_items/items/unit_amount` request property's max was set to `9007199254740991.00`
  - the `metadata/mondoir/editionNumber` request property's max was set to `9007199254740991.00`
  - …1 more
- **2026-10-19** `8a0a695bcfb5`: 1 breaking, 3 info
  - the `metadata/mondoir/payer` request property type changed from `string` to no type
  - added the new optional request property `metadata/mondoir/network`
  - added `subschema #1, subschema #2` to the `metadata/mondoir/payer` request property `anyOf` list
  - removed the pattern `^0x[0-9a-fA-F]{40}$` from the request property `metadata/mondoir/payer`
- **2026-10-18** `4990dc8b3ef4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mondoir/apis/mondoir-api/changes/agent-commerce/acp/checkout_sessions/post.md)

---

[API](https://skmtc.dev/mondoir/apis/mondoir-api.md) - [All operations](https://skmtc.dev/mondoir/apis/mondoir-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mondoir/apis/mondoir-api/revisions/5c50dd5066f8?raw)