---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/notify/status/voidNotify/index.md
description: >-
  Pre-authorization void asynchronous notification is used to receive and
  process the results of pre-authorization voids. Suitable for merchant systems
  that need real-time awareness of pre-authorization void status. This
  notification is sent asynchronously to ensure high reliability and low
  latency. Key parameters include transaction number, merchant order number, and
  void result, helping merchants update order status in a timely manner.
---
# Pre-Authorization Void Asynchronous Notification

```apidef
endpoint: POST payment.void
name: Pre-Authorization Void Asynchronous Notification
summary: Void result webhook
tags: Notify, Void
```

Pre-authorization void asynchronous notification is used to receive and process the results of pre-authorization voids. Suitable for merchant systems that need real-time awareness of pre-authorization void status. This notification is sent asynchronously to ensure high reliability and low latency. Key parameters include transaction number, merchant order number, and void result, helping merchants update order status in a timely manner.

## Request Parameters

| Parameter | Type | Required | Description |
|--------|------|------|------|
| accId | string | M | PingPong Store Number |
| clientId | string | M | PingPong Merchant Number |
| code | string | M | Status Code |
| description | string | M | Description |
| sign | string | M | Signature, for details see the Signature Convention: /en/notes/guide/sign/ section in this article |
| signType | string | M | Signature convention, supports MD5, SHA256, for details see the Signature Convention: /en/notes/guide/sign/ section in this article, all parameters are involved in the signature |
| bizContent | string | M | Response parameters are passed as a whole, with no limit on length |
| └─ amount | string | M | Pre-authorization void amount |
| └─ voidTime | string | M | Time of pre-authorization void initiation, timestamp |
| └─ voidEndingTime | string | M | Time when pre-authorization void reaches final state, timestamp |
| └─ merchantTransactionId | string | M | Original transaction serial number from the merchant's website |
| └─ transactionId | string | M | PingPong original transaction serial number |
| └─ merchantVoidId | string | M | Pre-authorization revocation serial number of the merchant's website |
| └─ currency | string | M | See Transaction currency: /en/notes/appendix/transactionCurrency/ |
| └─ notifyType | string | M | VOID - Pre-authorization revocation; |
| └─ status | string | M | Status: status idempotence: /en/notes/guide/paystatus/ SUCCESS - Success; FAILED - Failure; |

### Request Example

```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"
}
```