---
title: "Huỷ phiên đang chờ"
method: POST
path: "/api/v1/checkouts/{id}/cancel"
tags: ["Hosted checkout"]
---

# Huỷ phiên đang chờ

`POST /api/v1/checkouts/{id}/cancel`

## Request

- Base URL: `https://api.monapay.vn`
- URL: `https://api.monapay.vn/api/v1/checkouts/{id}/cancel`
- Auth: HTTP bearer and API key in header `X-Client-Secret`

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Response `200`

Envelope với data là Checkout.

- object
  - `success` boolean, required
  - `message` string, required
  - `data` Checkout, required
    - `id` string, uuid, required
    - `token` string, required: Token URL-safe dùng cho trang public.
    - `checkout_url` string, uri, required
    - `status` 'pending' | 'paid' | 'expired' | 'cancelled', required
    - `amount` integer, required
    - `currency` 'VND', required
    - `order_code` string, required
    - `description` string, required
    - `payer_email` string, email, nullable
    - `payer_name` string, nullable
    - `metadata` object, nullable
    - `qr_code_id` string, uuid, required
    - `qr_data_url` string, required
    - `qr_image_url` string, uri, required
    - `bank` object, required
      - `code` string, required
      - `name` string, required
      - `account_number` string, required
      - `account_name` string, required
      - `transfer_content` string, required
    - `return_url` string, uri, required
    - `cancel_url` string, uri, nullable
    - `expires_at` string, date-time, required
    - `paid_at` string, date-time, nullable
    - `transaction_code` string, nullable
    - `paid_amount` integer, nullable
    - `partial_amount` integer, nullable
    - `paid_late` boolean
    - `sandbox` boolean
    - `created_at` string, date-time, required

## Other responses

- `404`: Không tìm thấy checkout.
- `409`: Checkout không còn ở trạng thái pending.

---

[API](https://skmtc.dev/monapay/apis/mona-pay-api-v1.md) · [All operations](https://skmtc.dev/monapay/apis/mona-pay-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/monapay/apis/mona-pay-api-v1/revisions/ed3fbd821dce?raw)