---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/notify/closeNotify/index.md
description: >-
  订单关闭通知接口用于在订单被系统自动或手动关闭时，向商户发送异步通知。适用于需要实时掌握订单状态变更的场景。关键特性包括支持多种关闭原因标识及提供详细的订单信息，确保商户能够及时响应并处理相关业务逻辑。
---
# 订单关闭通知

```apidef
endpoint: POST payment.close
name: 订单关闭通知
summary: 关单结果异步回调
tags: Notify, Close, Payment
```

订单关闭通知接口用于在订单被系统自动或手动关闭时，向商户发送异步通知。适用于需要实时掌握订单状态变更的场景。关键特性包括支持多种关闭原因标识及提供详细的订单信息，确保商户能够及时响应并处理相关业务逻辑。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| 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。 |
| └─ transactionTime | string | M | 交易发起时间，时间戳 |
| └─ merchantTransactionId | string | M | 网站交易流水号 |
| └─ transactionId | string | M | PingPong 交易流水号 |
| └─ amount | string | M | 交易金额，精确位数和币种有关，请查询附录交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ currency | string | M | 交易币种，ISO 4217 三位币种，具体支持币种⻅附件交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ notifyType | string | M | 固定值：RECHARGE，表示关单类型 |
| └─ status | string | M | 交易状态：状态幂等: /notes/zh/guide/paystatus/ CLOSED-订单关闭（备注：只有在上送关单通知地址的情况下，才会发送主动关单或者被动关单的通知）; |
| └─ remark | string | O | 商户扩展字段，可用于指定特定参数，会在响应体中原样返回 |

### 请求示例

```json
{
  "clientId": "2023101115545610265",
  "code": "000000",
  "bizContent": "{\"amount\":\"1000.000000\",\"transactionId\":\"2024050650046448\",\"notifyType\":\"RECHARGE\",\"merchantTransactionId\":\"PMT-K52GNL5ZY21714991465240\",\"currency\":\"USD\",\"status\":\"CLOSED\"}",
  "sign": "6DA3C7E2F07F78464150BAA7450A3A06343B1E17D8D58A0F94A442A9F4F1FA90",
  "accId": "2023101115545610265482",
  "description": "Transaction succeeded",
  "signType": "SHA256"
}
```