This section describes the events and notifications that occur after a payment is completed, including payment status updates, disputes, and refunds.

1. Payment Webhook

The Payment Webhook is triggered when the payment status changes. For complete examples and field definitions, see the Acquiring Order Webhook section.

{
  "tradeNo": "PAY2025081500001",
  "merchantTradeNo": "MCH2025081500001",
  "currency": "USD",
  "amount": 399.50,
  "orderStatus": "PAID",
  "orderType": "PAYMENT",
  "createTime": 1750000000000,
  "completeTime": 1750000150000,
  "paymentMethodId": 1234567890123,
  "merchantCustomerId": "CUST_0001",
  "subMerchantId": 987654321098,
  "description": "Purchase of wireless headphones (Model: WH-1000XM5)",
  "errorCode": "151001",
  "errorMsg": "Param Error"
}

2. Dispute Webhook

The Dispute Webhook is triggered when a dispute or chargeback is initiated or updated. For complete examples and field definitions, see the Acquiring Dispute Webhook section.

{
  "disputeCaseId": 123456789012,
  "disputeType": "FIRST_CHARGEBACK",
  "disputeStatus": "NOTICE",
  "tradeNo": "PAY2025081000001",
  "disputeCurrency": "USD",
  "disputeAmount": 299.50,
  "reasonCode": "4837",
  "reasonInfo": "Transaction not authorized by cardholder",
  "dueDate": "2025-09-10",
  "createTime": 1750005600000,
  "description": "Cardholder claims the transaction was not initiated by them; merchant needs to submit proof of authorization by 2025-09-10"
}

3. Refund Webhook

The Refund Webhook is triggered when a refund is processed. For complete examples and field definitions, see the Acquiring Refund Response section.

{
  "tradeNo": "REF2025081400001",
  "merchantTradeNo": "MER_REF2025081400001",
  "amount": 199.99,
  "currency": "USD",
  "orderStatus": "REFUNDED",
  "orderType": "REFUND",
  "createTime": "1750002000000",
  "completeTime": "1750002120000",
  "merchant": {
    "subMerchantId": "SUB_MERCH_001",
    "merchantNo": "M000000123"
  }
}