---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/notify/refundNotify/index.md
description: >-
  The refund notification interface is used to receive refund results sent by
  the payment platform. It is suitable for scenarios where merchants need
  real-time awareness of refund status, supporting automatic processing of
  refund information. Key parameters include refund order number, refund amount,
  and refund status.
---
# Refund Notification

```apidef
endpoint: POST refund.notify
name: Refund Notification
summary: Refund result webhook
tags: Notify, Refund
```

The refund notification interface is used to receive refund results sent by the payment platform. It is suitable for scenarios where merchants need real-time awareness of refund status, supporting automatic processing of refund information. Key parameters include refund order number, refund amount, and refund status.

## 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 | Refund amount |
| └─ refundTime | string | M | Refund initiation time, timestamp |
| └─ refundEndingTime | string | M | Time when the refund reaches its final state, timestamp |
| └─ merchantTransactionId | string | M | Original transaction serial number from the merchant's website |
| └─ transactionId | string | M | PingPong original transaction serial number |
| └─ merchantRefundId | string | M | Refund transaction serial number from the merchant's website |
| └─ refundId | string | M | PingPong refund transaction serial number |
| └─ currency | string | M | See Transaction Currency: /en/notes/appendix/transactionCurrency/ |
| └─ notifyType | string | M | REFUND - Refund; |
| └─ status | string | M | Refund status: Status Idempotence: /en/notes/guide/paystatus/ SUCCESS - Success; FAILED - Failure; |
| └─ remark | string | O | Merchant extended fields |

### Request Example

```json
{
  "clientId": "2023042011040310224",
  "code": "000000",
  "bizContent": "{\"amount\":\"100.000000\",\"transactionId\":\"2024050750046460\",\"notifyType\":\"REFUND\",\"merchantTransactionId\":\"PMT-2S7RR3K4LQ1715047351210\",\"currency\":\"USD\",\"merchantRefundId\":\"PMT-4DNTI3AWXR1715049316146\",\"refundEndingTime\":\"1715049319211\",\"refundId\":\"2024050750046461\",\"status\":\"SUCCESS\"}",
  "sign": "B655B6553B7189016F01088606352798ABBF867797259D7E5068E762739D991D",
  "accId": "2023042011040310224447",
  "description": "Transaction succeeded",
  "signType": "SHA256"
}
```