扣款通知

接口说明

请求方式：【POST】商户 notify_url

请求域名：商户在进线请求中上送的回调地址

请求参数

Header 参数

通知请求头与异步通知说明中的 Header 参数相同。

Body 参数

参数名	类型	必填	描述
event_type	string	true	DEDUCT_SUCCESS 或 DEDUCT_FAIL
trade_no	string	true	平台交易号
merchant_id	string	true	商户号
out_trade_no	string	true	商户订单号
contract_no	string	true	签约号
trade_status	string	true	成功固定 SUCCESS；失败固定 FAIL
payment_amount	integer	true	扣款金额（分）；失败时可能为空
success_agreement_no	string	true	成功协议绑定号（成功时）
successful_payment_time	string	true	成功时间（成功时）
bank_code	string	false	银行编码（成功时）
bank_card_type	string	false	卡类型（成功时）
bank_card_no_masked	string	false	脱敏卡号（成功时）
error_message	string	false	仅失败时有值；成功时不下发
create_time	string	true	通知创建时间

通知示例

{
  "event_type": "DEDUCT_SUCCESS",
  "trade_no": "4101010120250525120000000001",
  "merchant_id": "M100001",
  "out_trade_no": "DED202505250001",
  "contract_no": "C20250525000001",
  "trade_status": "SUCCESS",
  "payment_amount": 1990,
  "success_agreement_no": "AGR20250525000001",
  "successful_payment_time": "2026-05-25T15:10:01+08:00",
  "bank_code": "ICBC",
  "bank_card_type": "D",
  "bank_card_no_masked": "****5661",
  "create_time": "2026-05-25T15:10:01+08:00"
}

处理建议：验签通过后处理业务；须应答 HTTP 状态码 200，响应体为字符串 OK；否则系统按固定频率重试。须按 out_trade_no（或约定业务单号）幂等。