---
title: "Pay Cart"
method: POST
path: "/v1/carts/{cart_id}/pay"
tags: ["manufacturing-v1"]
---

# Pay Cart

`POST /v1/carts/{cart_id}/pay`

Charge the account's saved card for this cart and create the order,
with no person in the loop.

Preconditions: the cart is `open`, its quote is `ready`, it has a
`ship_to` and a `shipping_option_id`, and the account has a card on file
(`GET /v1/account`, saved on the website's account page) or the request
names a Stripe PaymentMethod. The charge is the cart's
`totals.amount_total_cents`. On success the cart becomes `checked_out`
and the response carries `order_id`. An uncertain result returns 202
with status `processing`; a durable worker retries order creation with the
same payment. Timeouts never trigger automatic refunds. Retrying a paid
cart returns the existing payment.

## Path parameters

- `cart_id` string, required

## Request body

- V1CartPayRequest
  - `payment` union, required
    - V1CardOnFilePayment
      - `type` 'card_on_file', required
    - V1PaymentMethodPayment
      - `type` 'payment_method', required
      - `id` string, required — A Stripe PaymentMethod id (`pm_...`) usable off-session for this account's customer, for callers that manage their own payment details.
  - `customer_email` string, nullable — Receipt and order emails; defaults to the account email.
  - `customer_phone` string, nullable

## Response `200`

Already paid; the existing payment.

- V1CartPayment
  - `object` 'cart_payment'
  - `cart_id` string, required
  - `status` 'paid' | 'processing' | 'failed' | 'refunded', required
  - `payment_intent_id` string, nullable
  - `amount_total_cents` integer, required
  - `order_id` string, nullable
  - `order_url` string, nullable — `/v1/orders/{order_id}` once the order exists.
  - `paid_at` string, date-time, nullable

## Other responses

- `201` — Charged; the order exists.
- `202` — Payment reconciliation or order creation is pending.
- `400` — Malformed request.
- `401` — Missing or invalid credentials.
- `402` — The card was declined.
- `403` — The credentials do not permit this operation.
- `404` — The resource does not exist or is not visible to the caller.
- `409` — The resource is not ready, or Idempotency-Key was reused with a different request.
- `422` — Validation failed; see `error.param` and `error.details`.
- `429` — Rate limit exceeded; retry after the `Retry-After` header.
- `500` — Unexpected failure; safe to retry with the same Idempotency-Key.
- `503` — A dependency is temporarily unavailable; retry later.

## Changes

- **2026-09-06** `b7e901150c5c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rmfg/apis/fastapi/changes/v1/carts/:cart_id/pay/post.md)

---

[API](https://skmtc.dev/rmfg/apis/fastapi.md) · [All operations](https://skmtc.dev/rmfg/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/rmfg/apis/fastapi/revisions/737527fc081e?raw)