---
title: "Cancel a payment order"
method: POST
path: "/open-api/v3/acquiring/payments/cancel"
tags: ["Payments"]
---

# Cancel a payment order

`POST /open-api/v3/acquiring/payments/cancel`

Cancel an existing payment order. This interface can be called to cancel the payment
for non-card payment scenarios or other cases when the payment is not completed.
After cancellation is completed, the status will change to canceled, and the original
payment link (including checkout page and iframe mode) will become invalid and
cannot be used for payment anymore.

## Request body

- AcquiringPaymentCancelReqDTO
  - `merchantTradeNo` string, required — Merchant trade number to be cancelled, globally unique/idempotent
  - `reason` string — Cancellation reason

## Response `200`

OK

- AcquiringPaymentCancelResultVO
  - `code` integer — Return code
  - `message` string — Error message
  - `data` AcquiringPaymentCancelVO, required — Payment order object
    - `tradeNo` string — Order number
    - `merchantTradeNo` string — Merchant order number
    - `amount` number — Order amount
    - `currency` string — Order currency
    - `orderStatus` 'PENDING' | 'READY' | 'PAID' | 'FAILED' | 'CANCELED' | 'REFUNDED' | 'CANCELING' | 'AUTHORIZED' | 'REFUNDING' | 'CAPTURED' | 'CLOSED' — Order status PENDING: Order Creation in Progress READY: Waiting for Customer Payment PAID: Order Paid FAILED: Order Failed CANCELED: Order Canceled by Customer REFUNDED: Order Refunded CANCELING: Order Canceling AUTHORIZED: Order Authorized REFUNDING: Order Refunding CAPTURED: Payment Captured CLOSED: Order Closed (Typically due to Expiration)
    - `orderType` 'UNDEFINED' | 'PAYMENT' | 'REFUND' — Order type
    - `createTime` string — Order creation time
    - `completeTime` string — Order completion time

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/interlace/apis/core-resource.md) · [All operations](https://skmtc.dev/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)