# 3. 代付回调通知接口

# 简要描述

  • 代付回调接口

# 请求URL - 商户后台配置

  • /xxx

# 请求方式

  • POST

# 请求参数

参数名 必选 类型 说明
mchOrderId string 商户订单id
transactionId string 交易id
amount int 金额
transactionStatus string 事件监听交易状态:PENDING,COMPLETE,FAILED
eventName string eventName(1.disbursement.success 2.disbursement.failed)
sign string 回调事件的签名
createTime string 交易创建时间
returnTime string 交易完成时间
failedCode int 失败状态码
failedMessage string 失败状态信息
remark string 备注

# 回调示例

// 代付成功示例
{
  "amount": 312500,
  "createTime": "2022-05-31 09:38:03",
  "eventName": "disbursement.success",
  "mchOrderId": "CQPL1653961082230623",
  "remark": "cash credit",
  "sign": "xxxxxxxxxxxxx",
  "returnTime": "2022-05-31 09:38:56",
  "transactionId": "D1032653961082864323",
  "transactionStatus": "COMPLETE"
}

// 代付失败示例
{
  "amount": 312500,
  "createTime": "2022-05-31 09:37:20",
  "eventName": "disbursement.failed",
  "failedCode": -10001,
  "failedMessage": "Transaction Exceed Limit",
  "mchOrderId": "CQPL1653961039756685",
  "remark": "cash credit",
  "sign": "xxxxxxxxxxxxx",
  "returnTime": "2022-05-31 09:38:15",
  "transactionId": "D1001653961040053795",
  "transactionStatus": "FAILED"
}

# 商户响应格式

参数名 类型 说明
code int 状态码
msg string 状态描述
data object 响应数据

# 响应示例

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