用于查询先享后付服务单的当前状态、服务信息、风险金、结算金额及收款明细。

服务商、子商户和用户身份信息由慧收钱根据商户身份及原服务单获取,不作为商户请求或响应参数。


接口说明

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] CREDIT_PAY_QUERY
version 版本 string[1,16] 接口版本:1.0
format 请求格式 string[1,16] 业务请求参数格式,支持:JSON
merchantNo 商户号 string[1,16] 商户在慧收钱的商户号,由慧收钱生成并下发
signType 加密类型 string[1,16] RSA2:签名机制查看说明
signContent 业务数据 string 业务请求参数
sign 签名数据 string[1,128] 签名数据

业务请求参数

变量 参数名 类型[长度限制] 必填 描述
transNo 商户服务单号 string[1,64] 商户系统内部服务单号,用于定位需要查询的原服务单
示例值:OUT_1666688488
payType 交易类型 string[1,32] 固定值DOUYIN_CREDIT
serviceId 服务ID string[1,32] 创建服务单时使用的服务标识
示例值:101

公共请求示例

{method=CREDIT_PAY_QUERY, format=json, signType=RSA2, ,signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=8000000026}

业务请求示例

{
  "transNo": "OUT_1666688488",
  "serviceId": "101"
}

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 服务端响应状态,如果为true,则可以调用result;如果为false,则调用errorCode来获取出错信息
errorCode 错误码 string[1,32] 响应码
errorMsg 错误描述 string[1,128] 响应描述
result 响应内容 string 业务响应参数
sign 签名数据 string[1,128] 响应验签数据

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
tradeNo 慧收钱服务单号 string[1,32]
transNo 商户服务单号 string[1,64] 原样返回商户服务单号
serviceId 服务ID string[1,32] 服务标识
serviceInfo 服务信息 string[1,20] 服务单提供的服务说明
channelOrderNo 渠道服务单号 string[1,64] 渠道服务单号
creditStatus 服务单状态 string[1,32] 服务单当前状态:INITCREATEDPROCESSINGSUCCESSCLOSEDFAIL
creditStart 服务开始时间 string[14] 服务开始时间,格式 yyyyMMddHHmmss
creditStartRemark 服务开始时间备注 string[1,20] 服务开始时间说明
creditEnd 服务结束时间 string[14] 服务结束时间,格式 yyyyMMddHHmmss
creditEndRemark 服务结束时间备注 string[1,20] 服务结束时间说明
merchantAgreementNo 商户协议号 string[1,64]
memo 扩展参数 string JSON格式,将响应Memo参数域转JSON字符串,承载公共字段以外的服务单业务数据

响应Memo参数域

变量 参数名 类型[长度限制] 必填 描述
riskFund 风险金信息 object 服务单风险金信息,具体字段见下表
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号
attach 商户数据包 string[1,1024] 商户提交的附加数据
示例值:自定义数据
响应Memo.riskFund参数域
变量 参数名 类型[长度限制] 必填 描述
name 风险名称 string[1,64] 风险金类型
示例值:ESTIMATE_ORDER_COST
amount 风险金额 int64 风险金额,单位:分
示例值:10000
description 风险说明 string[1,30] 风险金说明
示例值:预估订单费用
响应Memo.collection参数域
变量 参数名 类型[长度限制] 必填 描述
payStatus 收款状态 string[1,32] PROCESSING表示待支付,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] 支持 yyyyMMddHHmmssyyyyMMdd
示例值: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":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}

业务响应示例

{
  "transNo": "OUT_1666688488",
  "serviceId": "101",
  "serviceInfo": "某某酒店",
  "channelOrderNo": "10050100220208060900000023310957",
  "creditStatus": "SUCCESS",
  "creditStart": "20260802090000",
  "creditStartRemark": "实际入住时间",
  "creditEnd": "20260803120000",
  "creditEndRemark": "实际离店时间",
  "memo": "{\"riskFund\":{\"name\":\"ESTIMATE_ORDER_COST\",\"amount\":10000,\"description\":\"预估订单费用\"},\"agreementNo\":\"out3B2B64CC652AE663\",\"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号\",\"attach\":\"自定义数据\",\"returnUrl\":\"https://www.merchant.com/notify\"}"
}

服务单状态说明

服务单状态 描述
INIT 服务单创建请求结果未知,等待查询或补单
CREATED 需确认模式下服务单已创建,等待用户确认
PROCESSING 服务进行中,或完结请求已受理但尚未收到最终支付结果
SUCCESS 服务单已成功完结
CLOSED 服务单已取消
FAIL 服务单创建失败或已失效

交易响应码

响应码 描述 解决方案
100004 不支持该支付通道的交易
100019 无可用渠道
100200 订单已支付成功,请勿重复支付
100203 交易失败
100204 订单已过期,请使用新的订单号发起交易
100205 订单已存在
100206 订单不存在
100207 交易已取消
100208 订单已失败
100209 交易失败,黑名单用户
100210 交易失败,非白名单用户
100211 交易记录不存在
100212 交易失败,风险受限
100500 余额不足
100501 交易金额超限
100502 交易金额低于限额
100503 交易金额不正确
100505 单日交易金额超限
100506 单笔交易金额超限
100507 单月交易金额超限
100600 短信验证码错误
100601 短信验证码失效
100602 请确认是否发送短信,当前交易必须通过短信验证
200002 非法的交易
200003 订单号已存在,请勿重复提交
200004 订单不存在
200005 原订单金额校验不通过
200010 批次号已存在
200011 订单数量超过单批次处理量
200012 请求太过频繁,请稍后再试
200015 不支持此支付类型
200017 订单关闭成功
200018 订单关闭失败,请重试!
200107 分账参数校验异常
200108 交易主体从属关系异常
200109 业务订单不存在
200110 业务订单状态异常
200111 支付金额超限
200112 业务订单已失效
200113 该业务订单不支持部分支付
200114 业务订单已关闭
200115 非法交易
200116 存在成功/处理中订单,请勿重复提交
200117 订单已经分账不能发起退款/撤销
200118 订单金额不等于交易金额+营销金额
200119 订单金额+交易金额不能都为0
200120 营销账户信息不能为空
200201 商户状态异常,无法进行交易
200203 商户与子商户关系不对应,无法进行交易
200204 门店信息不存在,无法进行交易
200205 终端商户信息不存在,无法进行交易
200206 请求ip白名单未配置
200207 账户状态异常
200209 门店信息不存在
200210 设备信息不存在
200302 产品渠道不能为空
300401 交易非法,订单已完成
300701 商户限额校验不通过
作者:贺前瑞  创建时间:2026-08-20 14:08
最后编辑:贺前瑞  更新时间:2026-08-20 20:29