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

# POST /checkout_sessions/{checkout_session_id}/cancel

`POST /checkout_sessions/{checkout_session_id}/cancel`

## Request

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

Cancel before payment begins. Cannot cancel a payment already in progress.

## Path parameters

- `checkout_session_id` string, required

## Headers

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

## Request body

- object

## 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)