---
title: "POST /checkout_sessions/{checkout_session_id}"
method: POST
path: "/checkout_sessions/{checkout_session_id}"
---

# POST /checkout_sessions/{checkout_session_id}

`POST /checkout_sessions/{checkout_session_id}`

## Request

- Base URL: `https://nowyourlink.com`
- URL: `https://nowyourlink.com/checkout_sessions/{checkout_session_id}`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.nowyourlink.com/oauth/authorize`, token URL `https://api.nowyourlink.com/oauth/token`, scopes: `account:read`)

Replace line_items before payment starts. Price and quantity remain EUR 1 for one report.

## Path parameters

- `checkout_session_id` string, required

## Headers

- `API-Version` '2026-04-17', required
- `Idempotency-Key` string, required

## Request body

- object
  - `line_items` object[], required
    - `id` string, required

## Response `200`

ACP checkout state or paid metrics. No-store; owned by this OAuth grant.

## Other responses

- `400`: Invalid request or unsupported API version. See Supported-Versions.
- `401`: OAuth bearer token required.
- `403`: account:read scope required.
- `409`: Conflicting replay, frozen cart or buyer action required.
- `503`: Uncertain outcome: retry the same body and Idempotency-Key. Never start another payment.

---

[API](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api.md) · [All operations](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/revisions/cd8408529b48?raw)
