5. 代扣回调接口

说明

• 该接口由商户实现，用于接收代扣交易结果通知
• PayCools平台在代扣交易状态发生变化时会主动调用此接口

URL

• 由商户提供

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	是	string	application/json

回调参数

字段名	类型	必填	说明
eventName	string	是	事件名称：directdebit.payment.success / directdebit.payment.failed
mchOrderId	string	是	商户订单号
transactionId	string	是	PayCools 唯一交易流水号
amount	int	是	交易金额（单位：分）
transactionStatus	string	是	交易状态：PENDING / COMPLETE / FAILED
createTime	string	是	交易创建时间
returnTime	string	是	回调/返回时间
channelCode	string	是	支付渠道代码
remark	string	否	备注
failedCode	int	否	失败码（失败时返回）
failedMessage	string	否	失败信息（失败时返回）
sign	string	是	签名

成功回调示例

{
  "eventName": "directdebit.payment.success",
  "mchOrderId": "DD20240101120000",
  "transactionId": "TXN20240101120000123456",
  "amount": 10000,
  "transactionStatus": "COMPLETE",
  "createTime": "2024-01-01 12:00:00",
  "returnTime": "2024-01-01 12:01:30",
  "channelCode": "JTWALLET_DIRECT_DEBIT",
  "remark": "Monthly subscription payment",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"
}

失败回调示例

{
  "eventName": "directdebit.payment.failed",
  "mchOrderId": "DD20240101120000",
  "transactionId": "TXN20240101120000123456",
  "amount": 10000,
  "transactionStatus": "FAILED",
  "createTime": "2024-01-01 12:00:00",
  "returnTime": "2024-01-01 12:01:30",
  "channelCode": "JTWALLET_DIRECT_DEBIT",
  "remark": "Monthly subscription payment",
  "failedCode": -10000,
  "failedMessage": "Transaction Service Error",
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"
}

---

返回示例

{
  "code":1,
  "msg":"success",
  "data":{
  }
}