业务通知参数

变量 参数名 类型[长度限制] 必填 描述
tradeNo 慧收钱服务单号 string[1,32] 是
transNo 商户服务单号 string[1,64] 是 商户创建服务单时提交的服务单号，由慧收钱根据渠道服务单匹配后补充
示例值：OUT_1666688488
serviceId 服务ID string[1,32] 是 创建服务单时使用的服务标识
示例值：101
serviceInfo 服务信息 string[1,20] 是 服务单提供的服务说明
示例值：某某酒店
channelOrderNo 渠道服务单号 string[1,64] 是 渠道服务单号，由系统转换返回
示例值：10050100220208060900000023310957
creditStatus 服务单状态 string[1,32] 是 服务单当前状态：INIT、PROCESSING、SUCCESS、CLOSED、FAIL；支付成功通知返回 SUCCESS
orderAmt 服务结算总金额 int64 是 服务单完结总金额，单位：分
示例值：10000
creditStart 服务开始时间 string[14] 否 实际服务开始时间，格式 yyyyMMddHHmmss
示例值：20260802090000
creditStartRemark 服务开始时间备注 string[1,20] 否 实际服务开始时间说明
示例值：实际入住时间
creditEnd 服务结束时间 string[14] 否 实际服务结束时间，格式 yyyyMMddHHmmss
示例值：20260803120000
creditEndRemark 服务结束时间备注 string[1,20] 否 实际服务结束时间说明
示例值：实际离店时间
merchantAgreementNo 商户协议号 string[1,64] 否
memo 扩展参数 string 否 JSON格式，将通知Memo参数域转JSON字符串，承载风险金、协议、收款明细及服务信息

通知Memo参数域

变量 参数名 类型[长度限制] 必填 描述
riskFund 风险金信息 object 否 服务单风险金信息，具体字段见下表
attach 商户数据包 string[1,1024] 否 商户提交的附加数据
示例值：自定义数据
collection 收款信息 object 否 本次支付成功后的收款信息，具体字段见下表
postPayments 后付费项目 array[object] 是 服务单完结时提交的最终付费项目，具体字段见下表
postDiscounts 商户优惠 array[object] 否 服务单完结时提交的最终商户优惠，具体字段见下表
location 服务位置 object 否 服务开始及结束地点，具体字段见下表
spbillCreateIp 用户终端IP string[1,45] 否 用户客户端IP，支持IPv4和IPv6
示例值：14.23.150.211
deviceId 商户端设备号 string[1,32] 否 商户端设备号
示例值：13467007045764
storeId 门店编号 string[1,32] 否 商户侧门店编号
示例值：STORE001
storeName 门店名称 string[1,256] 否 商户侧门店名称
示例值：示例酒店
storeAreaCode 门店地区编码 string[1,32] 否 商户门店地区编码
示例值：310115
storeAddress 门店详细地址 string[1,512] 否 商户门店详细地址
示例值：上海市浦东新区示例路1号
通知Memo.riskFund参数域
变量 参数名 类型[长度限制] 必填 描述
name 风险名称 string[1,64] 是 风险金类型
示例值：ESTIMATE_ORDER_COST
amount 风险金额 int64 是 风险金额，单位：分
示例值：10000
description 风险说明 string[1,30] 否 风险金说明
示例值：预估订单费用
通知Memo.collection参数域
变量 参数名 类型[长度限制] 必填 描述
payStatus 收款状态 string[1,32] 是 PROCESSING表示待支付，SUCCESS表示已支付；支付成功通知通常返回 SUCCESS
orderAmt 总收款金额 int64 否 总收款金额，单位：分
示例值：10000
payingAmount 待收金额 int64 否 正在收款中的金额，单位：分
示例值：0
paidAmount 已收金额 int64 否 已经完成收款的金额，单位：分
示例值：10000
channelPayNo 渠道交易单号 string[1,64] 否 结单交易单号；支付成功且收款渠道支持时返回，可用于后续查询或退款
示例值：100420260801000001
payNo 交易订单号 string[1,32] 否 慧收钱交易订单号
paidType 收款成功渠道 string[1,32] 否 DOUYINPAY表示抖音支付，MCH表示商户自收
paidTime 收款成功时间 string[8,14] 否 支持 yyyyMMddHHmmss 或 yyyyMMdd
示例值：20260803121000
bankType 收款银行 string[1,32] 否 收款银行标识
示例值：ABC
promotionDetail 优惠信息 array[object] 否 本次收款使用的优惠信息列表，具体字段见下表
通知Memo.collection.promotionDetail参数域
变量 参数名 类型[长度限制] 必填 描述
couponId 券ID string[1,32] 否 优惠券标识
示例值：coupon_001
name 优惠名称 string[1,64] 否 优惠名称
示例值：新客优惠
amount 优惠金额 int64 是 优惠金额，单位：分
示例值：1000
stockId 活动ID string[1,32] 否 优惠活动标识
示例值：stock_001
douyinpayContribute 抖音支付出资 int64 否 抖音支付出资金额，单位：分
示例值：500
merchantContribute 商户出资 int64 否 商户出资金额，单位：分
示例值：500
otherContribute 其他出资 int64 否 其他出资金额，单位：分
示例值：0
currency 优惠币种 string[1,32] 否 当前支持 CNY
goodsDetail 商品列表 array[object] 否 参与优惠的商品列表，具体字段见下表
通知Memo.collection.promotionDetail.goodsDetail参数域
变量 参数名 类型[长度限制] 必填 描述
goodsId 商品编码 string[1,32] 是 参与优惠的商品编码
示例值：goods_001
quantity 商品数量 uint32 否 商品数量
示例值：1
unitPrice 商品价格 int64 否 商品单价，单位：分
示例值：10000
discountAmount 商品优惠金额 int64 否 商品优惠金额，单位：分
示例值：1000
goodsRemark 商品备注 string[1,128] 否 商品备注
示例值：酒店房费
通知Memo.postPayments参数域
变量 参数名 类型[长度限制] 必填 描述
name 付费名称 string[1,20] 是 付费项目名称
示例值：房费
amount 付费金额 int64 条件必填 项目总金额，单位：分；与 description 至少传入一个
示例值：10000
description 付费说明 string[1,30] 条件必填 计费规则说明；与 amount 至少传入一个
示例值：实际入住一晚
count 付费数量 uint32 否 付费项目数量
示例值：1
通知Memo.postDiscounts参数域
变量 参数名 类型[长度限制] 必填 描述
name 优惠名称 string[1,20] 是 优惠名称说明
示例值：新客优惠
amount 优惠金额 int64 是 优惠金额，单位：分
示例值：1000
description 优惠说明 string[1,30] 否 优惠使用条件说明
示例值：首次入住可用
count 优惠数量 uint32 否 优惠项目数量
示例值：1
通知Memo.location参数域
变量 参数名 类型[长度限制] 必填 描述
startLocation 服务开始地点 string[1,50] 否 开始使用服务的地点
示例值：上海市浦东新区
endLocation 服务结束地点 string[1,50] 否 结束使用服务的地点
示例值：上海市浦东新区

业务通知示例

{
  "transNo": "OUT_1666688488",
  "serviceId": "101",
  "serviceInfo": "某某酒店",
  "channelOrderNo": "10050100220208060900000023310957",
  "creditStatus": "SUCCESS",
  "orderAmt": 10000,
  "creditStart": "20260802090000",
  "creditStartRemark": "实际入住时间",
  "creditEnd": "20260803120000",
  "creditEndRemark": "实际离店时间",
  "memo": "{\"riskFund\":{\"name\":\"ESTIMATE_ORDER_COST\",\"amount\":10000,\"description\":\"预估订单费用\"},\"agreementNo\":\"out3B2B64CC652AE663\",\"attach\":\"自定义数据\",\"collection\":{\"state\":\"USER_PAID\",\"orderAmt\":10000,\"payingAmount\":0,\"paidAmount\":10000,\"details\":[{\"transactionId\":\"100420260801000001\",\"amount\":10000,\"paidType\":\"DOUYINPAY\",\"paidTime\":\"20260803121000\",\"bankType\":\"ABC\",\"promotionDetail\":[{\"couponId\":\"coupon_001\",\"name\":\"新客优惠\",\"amount\":1000,\"stockId\":\"stock_001\",\"douyinpayContribute\":500,\"merchantContribute\":500,\"otherContribute\":0,\"currency\":\"CNY\",\"goodsDetail\":[{\"goodsId\":\"goods_001\",\"quantity\":1,\"unitPrice\":10000,\"discountAmount\":1000,\"goodsRemark\":\"酒店房费\"}]}]}]},\"postPayments\":[{\"name\":\"房费\",\"amount\":10000,\"description\":\"实际入住一晚\",\"count\":1}],\"postDiscounts\":[{\"name\":\"新客优惠\",\"amount\":1000,\"description\":\"首次入住可用\",\"count\":1}],\"location\":{\"startLocation\":\"上海市浦东新区\",\"endLocation\":\"上海市浦东新区\"},\"spbillCreateIp\":\"14.23.150.211\",\"deviceId\":\"13467007045764\",\"storeId\":\"STORE001\",\"storeName\":\"示例酒店\",\"storeAreaCode\":\"310115\",\"storeAddress\":\"上海市浦东新区示例路1号\"}"
}

服务单状态说明

服务单状态 描述
SUCCESS 服务单已完成支付并成功完结
作者：贺前瑞  创建时间：2026-08-20 14:04
最后编辑：贺前瑞  更新时间：2026-08-20 20:34