---
title: "Expire checkout"
method: POST
path: "/v2/checkouts/{checkoutId}/expire"
tags: ["checkouts"]
---

# Expire checkout

`POST /v2/checkouts/{checkoutId}/expire`

## Path parameters

- `checkoutId` string, uuid, required

## Response `200`

Request has been processed by PawaPay.

- CheckoutExpirationResponse
  - `checkoutId` string, uuid, required — The unique ID for this payment in PawaPay as specified by you during initiation.
  - `status` 'WAITING_PAYMENT' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED' | 'CANCELLED', required — Possible checkout lifecycle statuses. This is distinct from the initiation status (`CheckoutCreationStatus`) returned when the checkout is created. * `WAITING_PAYMENT` - The checkout and its hosted payment page have been created and are waiting for the customer to pay. * `PROCESSING` - A payment attempt is in progress and the checkout is still being processed. * `COMPLETED` - The checkout has completed successfully. This is a **final status.** * `FAILED` - The checkout has failed. Inspect `deposit` or `depositsHistory` for the latest attempt result when available. This is a **final status.** * `EXPIRED` - The checkout has expired and can no longer be used. This is a **final status.** * `CANCELLED` - The customer cancelled the payment on the hosted payment page. This is a **final status.**
  - `expiredAt` string, date-time — Timestamp when the checkout was expired.
  - `reason` string — Reason reported for the expiration.
  - `expiredBy` string — Actor that expired the checkout.

## Other responses

- `401` — Authentication failed. Make sure you have added the API token into the header.
- `403` — Authorization failure. Please check your authentication token.
- `404` — The specified checkout was not found.
- `500` — An unknown failure has occured.

---

[API](https://skmtc.net/pawapay/apis/pawapay-merchant-api-v2.md) · [All operations](https://skmtc.net/pawapay/apis/pawapay-merchant-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pawapay/pawapay-merchant-api-v2/revisions/ce13c31e9746/schema)