---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/notify/status/voidNotify/index.md
description: >-
  预授权撤销通知用于接收和处理预授权撤销的结果。适用于需要实时了解预授权撤销状态的商户系统。该通知通过异步方式发送，确保高可靠性和低延迟。关键参数包括交易号、商户订单号和撤销结果等，帮助商户及时更新订单状态。
---
# 预授权撤销通知

```apidef
endpoint: POST payment.void
name: 预授权撤销通知
summary: 预授权撤销结果异步回调
tags: Notify, Void
```

预授权撤销通知用于接收和处理预授权撤销的结果。适用于需要实时了解预授权撤销状态的商户系统。该通知通过异步方式发送，确保高可靠性和低延迟。关键参数包括交易号、商户订单号和撤销结果等，帮助商户及时更新订单状态。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | PingPong 店铺号 |
| clientId | string | M | PingPong 商户号 |
| code | string | M | 状态码 |
| description | string | M | 描述 |
| sign | string | M | 签名 |
| signType | string | M | 签名规约，支持 MD5、SHA256，具体见本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏，所有参数均参与签名 |
| bizContent | string | M | 响应参数作为整体传入，长度不限。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ amount | string | M | 预授权撤销金额 |
| └─ voidTime | string | M | 预授权撤销发起时间，时间戳 |
| └─ voidEndingTime | string | M | 预授权撤销到达终态时间，时间戳 |
| └─ merchantTransactionId | string | M | 商户网站的原交易流水号 |
| └─ transactionId | string | M | PingPong原交易流水号 |
| └─ merchantVoidId | string | M | 商户网站的预授权撤销流水号 |
| └─ currency | string | M | 详见交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ notifyType | string | M | VOID-预授权撤销; |
| └─ status | string | M | 状态：状态幂等: /notes/zh/guide/paystatus/ SUCCESS-成功; FAILED-失败; |

### 请求示例

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