扣款通知（PAYMENT）

扣款成功，或本期扣款失败且不再重试时，向签约时上送的 notify_url 投递。不通知处理中、待渠道确认、当日仍会重试等中间态。

接口说明

请求方式：【POST】商户 notify_url

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

  • event_type 固定为 PAYMENT

请求参数

Body 参数

参数名 类型 必填 描述
event_type string true 固定 PAYMENT
deduction_no string true 账单号
subscription_no string true 订阅号
out_trade_no string true 商户签约订单号
mch_out_trade_no string false 实际支付时的商户订单号（可空）
trade_status string true 交易状态，取值：PENDING / PROCESSING / CHANNEL_PENDING / SUCCESS / FAILED / CANCELLED
deduct_period integer true 本笔所属期数
total_period integer false 总期数（可空）
next_deduction_time string false 下次扣款时间，ISO 8601（可空；已停扣或缺省时省略）。最后一期扣成功后仍可能下发，表示权益截止时间
bill_date string true 本期计划扣款日（yyyy-MM-dd）
original_amount integer true 本笔原始应扣金额（分）
actual_amount integer true 本笔实际扣款金额（分）；失败时可能缺省
channel_order_no string false 渠道订单号（可空）
error_code string false 不下发（避免与外层 HTTP 双码）；成功/失败均省略
error_message string false 失败时有值；成功通知省略

通知示例

成功

{
  "event_type": "PAYMENT",
  "deduction_no": "DD01010120260319120000000001",
  "subscription_no": "SP01010120260319120000000001",
  "out_trade_no": "MCH202603190001",
  "mch_out_trade_no": "PAY2026061910000001",
  "trade_status": "SUCCESS",
  "deduct_period": 3,
  "total_period": 12,
  "next_deduction_time": "2026-07-19T12:00:00+08:00",
  "bill_date": "2026-06-19",
  "original_amount": 1990,
  "actual_amount": 1592,
  "channel_order_no": "CH2026031912000001"
}

通知示例

失败

{
  "event_type": "PAYMENT",
  "deduction_no": "DD01010120260319120000000002",
  "subscription_no": "SP01010120260319120000000001",
  "out_trade_no": "MCH202603190001",
  "mch_out_trade_no": "PAY2026061910000002",
  "trade_status": "FAILED",
  "deduct_period": 3,
  "total_period": 12,
  "bill_date": "2026-06-19",
  "original_amount": 1990,
  "error_message": "余额不足"
}

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