---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/marketplaces/mpVoid/index.md
description: >-
  预授权撤销 API
  用于取消已创建但尚未请款的预授权交易。适用于商家在不需要完成支付时释放消费者资金，减少不必要的财务处理。主要功能包括指定交易ID以执行撤销操作，支持全球范围内的多种货币类型。关键参数涉及交易标识符、撤销原因等，确保资金管理的灵活性与安全性。
---
# 预授权撤销

```apidef
endpoint: POST /v4/payment/void
name: 预授权撤销
```

预授权撤销 API 用于取消已创建但尚未请款的预授权交易。适用于商家在不需要完成支付时释放消费者资金，减少不必要的财务处理。主要功能包括指定交易ID以执行撤销操作，支持全球范围内的多种货币类型。关键参数涉及交易标识符、撤销原因等，确保资金管理的灵活性与安全性。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| 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。 |
| └─ merchantTransactionId | string | M | 商户网站的原交易流水号 |
| └─ notificationUrl | string | M | 异步通知地址 |
| └─ merchantVoidId | string | M | 商户网站预授权撤销流水号，全局唯一 |
| └─ amount | string | M | 交易金额，小数点后保留两位，如 10.12，部分交 易币种如 JPY、KRW 其最小单位为元，也要求上送两位小数，如 29.00 |
| └─ currency | string | M | 交易币种，ISO 4217 三位币种，具体支持币种⻅附件交易币种: /notes/zh/appendix/transactionCurrency/表 |

### 请求示例

```json
{
  "accId": "2023042011040310224447",
  "bizContent": "{\"merchantVoidId\":\"PMT-RM319TQYEJ1715049483296\",\"merchantTransactionId\":\"PMT-RM319TQYEJ1715049483296\",\"amount\":\"100\",\"currency\":\"USD\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/notify\"}",
  "clientId": "2023042011040310224",
  "sign": "334BB275659C85577A889EDCE1693972BA1744B24F8C12A8A5E37EE557B66DD0",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| 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。 |
| └─ transactionId | string | PingPong原交易流水号 |
| └─ merchantTransactionId | string | 商户网站的原交易流水号 |
| └─ merchantVoidId | string | 商户网站的void交易流水号 |
| └─ description | string | 结果描述 |
| └─ currency | string | 交易币种 |
| └─ amount | string | 交易金额 |
| └─ voidTime | string | void发起时间，时间戳 |
| └─ voidEndingTime | string | void到达终态时间，时间戳 |
| └─ status | string | 状态 SUCCESS-成功; FAILED-失败; PROCESSING-进行中; |

### 响应示例

```json
{
  "accId": "2023042011040310224447",
  "bizContent": "{\"amount\":\"100.000000\",\"merchantVoidId\":\"PMT-RM319TQYEJ1715049483296\",\"transactionId\":\"2024050750046462\",\"voidEndingTime\":\"1715049613278\",\"voidTime\":\"1715049612000\",\"merchantTransactionId\":\"PMT-RM319TQYEJ1715049483296\",\"currency\":\"USD\",\"status\":\"SUCCESS\"}",
  "clientId": "2023042011040310224",
  "code": "000000",
  "description": "Transaction succeeded",
  "sign": "0474235D375F8A81E9FD17E278ED3F11039F8462F64650A1F0D613FADAE5B04F",
  "signType": "SHA256"
}
```