业务通知参数

变量 参数名 类型[长度限制] 必填 描述
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
channelPayNo 渠道扣款单号 string[1,64] 否 支付成功且收款渠道支持时返回
示例值：100420260801000001
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
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] 否 结束使用服务的地点
示例值：上海市浦东新区

服务单状态说明

服务单状态 描述
SUCCESS 服务单已完成支付并成功完结
作者：张杰  创建时间：2026-08-20 19:27
最后编辑：丁辉  更新时间：2026-09-11 19:34