---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/InPersonPayments/cancel/index.md
description: >-
  订单取消接口用于取消未完成的订单。适用于商户需要取消正在处理中的交易场景，支持通过商户订单流水号进行取消操作。取消结果包括取消成功、取消失败（已支付完成）和取消处理中三种状态。
---
# 订单取消接口

```apidef
endpoint: POST /onsiteAcquirer/payment/misCancel
name: 订单取消接口
```

订单取消接口用于取消未完成的订单。适用于商户需要取消正在处理中的交易场景，支持通过商户订单流水号进行取消操作。取消结果包括取消成功、取消失败（已支付完成）和取消处理中三种状态。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestTime | string | M | 商户侧请求时间。时间戳，到毫秒 |
| └─ merchantTransactionId | string | M | 商户网站交易流水号 |

### 请求示例

```json
{
  "accId": "SP1234567890",
  "clientId": "P100001",
  "signType": "SHA256",
  "sign": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6",
  "version": "1.0",
  "bizContent": "{\"requestTime\":\"1698912345678\",\"merchantTransactionId\":\"TX20231101123456\"}"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ merchantTransactionId | string | 商户网站交易流水号 |
| └─ cancelStatus | string | 取消状态： CANCEL_SUCCESS - 取消成功; CANCEL_FAIL_PAID - 取消失败，已支付完成; CANCEL_PROCESSING - 取消处理中; |

### 响应示例

```json
{
  "accId": "SP1234567890",
  "clientId": "P100001",
  "signType": "SHA256",
  "sign": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6",
  "code": "000000",
  "description": "成功",
  "bizContent": "{\"cancelStatus\":\"CANCEL_SUCCESS\",\"merchantTransactionId\":\"TX20231101123456\"}"
}
```