# Dispute status notification
When a new dispute occurs, the payment gateway will initiate a callback notification to the merchant system. If the merchant system does not return correctly, the payment gateway will delay notification again.
# notify
interface
Request URL: This link is set through the disputeNotifyUrl in the merchant application configuration. If the link cannot be accessed, the merchant system will not be able to receive the dispute notification.
Request method: POST
Request type: application/x-www-form-urlencoded
# Notification parameters
| Field name | Variable name | Required | Type | Sample value | Description |
|---|---|---|---|---|---|
| Dispute log ID | disputeLogId | Yes | long | 10001 | Dispute change log ID corresponding to this notification |
| Dispute ID | disputeId | Yes | String(30) | D202512101104177050001 | Platform dispute ID |
| Payment order number | payOrderId | Yes | String(30) | P12021022311124442600 | Associated payment system order number |
| Merchant Number | mchNo | Yes | String(30) | M1621873433953 | Merchant Number |
| App ID | appId | Yes | String(24) | 60cc09bce4b0f1c0b83761c9 | App ID |
| Disputed amount | amount | Yes | long | 100 | Disputed amount, unit cent |
| Currency code | currency | Yes | String(3) | USD | Three-digit currency code |
| Dispute stage | stage | Yes | String(50) | first_chargeback_under_review | Dispute stage |
| Reason Code | reasonCode | No | String(32) | 10.4 | Dispute reason code returned by the channel |
| Reason description | reasonMsg | No | String(256) | Fraud | Description of the dispute reason returned by the channel |
| Response deadline | responseDeadline | No | long | 1622016572190 | Response deadline, 13-digit timestamp |
| Notification request time | reqTime | Yes | long | 1622016572190 | Notification request time, 13-digit timestamp |
| Signature | sign | Yes | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | Signature value, see signature algorithm for details |
# Return results
After processing, the business system synchronously returns to the payment center. The return string success indicates that it has been processed. If an exception occurs during processing and a non-success is returned, it indicates that the processing failed, and the payment center will notify the business system again. (Notification frequency is 0/30/60/90/120/150, unit: seconds)
| Status | Business System Response |
|---|---|
| Processed successfully | success |
| Processing failed | fail (or other non-success string) |
Attention
The returned string must be lowercase and cannot have spaces or newlines before or after it.
# Notification sample data
mchNo=M1621873433953&appId=60cc09bce4b0f1c0b83761c9&disputeId=D202512101104177050001&disputeLogId=10001&payOrderId=P12021022311124442600&amount=100¤cy=USD&stage=CHARGEBACK&state=0&reasonCode=10.4&reasonMsg=Fraud&responseDeadline=1624590257000&reqTime=1622016572190&sign=C380BEC2BFD727A4B6845133519F3AD6