接口说明

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] CREDIT_PAY_FINISH
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
serviceId 服务ID string[1,32] 业务接入时分配的服务标识
payType 交易类型 string[1,32] 固定值DOUYIN_CREDIT
orderAmt 服务结算总金额 int64 实际结算总金额,单位:分,须大于等于0
示例值:10000
requestDate 交易时间 string[14] 本次完结请求时间,格式 yyyyMMddHHmmss
示例值:20260803121000
creditStart 服务开始时间 string[14] 本次完结确认的实际服务开始时间,格式 yyyyMMddHHmmss
示例值:20260802090000
creditStartRemark 服务开始时间备注 string[1,20] 本次完结确认的服务开始时间说明
示例值:实际入住时间
creditEnd 服务结束时间 string[14] 本次完结确认的实际服务结束时间,格式 yyyyMMddHHmmss
示例值:20260803120000
creditEndRemark 服务结束时间备注 string[1,20] 本次完结确认的服务结束时间说明
示例值:实际离店时间
memo 扩展信息 string JSON格式,将Memo参数域转JSON字符串,承载本次完结服务单的结算明细及渠道业务参数

Memo参数域

变量 参数名 类型[长度限制] 必填 描述
attach 商户数据包 string[1,1024] 本次完结所需的附加数据
示例值:自定义数据
postPayments 后付费项目 array[object] 本次完结的最终付费项目,最少1条、最多100条,具体字段见下表
postDiscounts 商户优惠 array[object] 本次完结的最终商户优惠,最多30条,具体字段见下表
goodsTag 优惠标记 string[1,512] JSON序列化字符串,协商后传入
channelInfo 支付渠道信息 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.postPayments参数域
变量 参数名 类型[长度限制] 必填 描述
name 付费名称 string[1,20] 付费项目名称
示例值:房费
amount 付费金额 int64 条件必填 项目总金额,单位:分,须大于等于0;与 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.channelInfo参数域
变量 参数名 类型[长度限制] 必填 描述
presetChannel 指定渠道列表 array[object] 指定必用渠道列表,最多5个支付渠道,具体字段见下表
Memo.channelInfo.presetChannel参数域
变量 参数名 类型[长度限制] 必填 描述
channelCode 指定渠道 string[1,128] 指定必用渠道名称,协商后传入
示例值:OUTSIDE_MC
channelId 指定渠道ID string[1,64] 指定必用渠道ID,协商后传入
示例值:HLQXK
channelAmount 指定渠道金额 int64 指定渠道使用金额,单位:分
示例值:10000
channelExtInfo 扩展参数 string[1,1024] 指定渠道扩展信息,JSON序列化字符串
Memo.location参数域
变量 参数名 类型[长度限制] 必填 描述
startLocation 服务开始地点 string[1,50] 开始使用服务的地点
示例值:上海市浦东新区
endLocation 服务结束地点 string[1,50] 结束使用服务的地点
示例值:上海市浦东新区

公共请求示例

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

业务请求示例

{
  "transNo": "OUT_1666688488",
  "serviceId": "101",
  "orderAmt": 10000,
  "requestDate": "20260803121000",
  "creditStart": "20260802090000",
  "creditStartRemark": "实际入住时间",
  "creditEnd": "20260803120000",
  "creditEndRemark": "实际离店时间",
  "memo": "{\"attach\":\"自定义数据\",\"postPayments\":[{\"name\":\"房费\",\"amount\":10000,\"description\":\"实际入住一晚\",\"count\":1}],\"postDiscounts\":[{\"name\":\"新客优惠\",\"amount\":1000,\"description\":\"首次入住可用\",\"count\":1}],\"goodsTag\":\"{\\\"productTag\\\":\\\"default\\\"}\",\"channelInfo\":{\"presetChannel\":[{\"channelCode\":\"OUTSIDE_MC\",\"channelId\":\"HLQXK\",\"channelAmount\":10000,\"channelExtInfo\":\"{\\\"key\\\":\\\"value\\\"}\"}]},\"location\":{\"startLocation\":\"上海市浦东新区\",\"endLocation\":\"上海市浦东新区\"},\"spbillCreateIp\":\"14.23.150.211\",\"deviceId\":\"13467007045764\",\"storeId\":\"STORE001\",\"storeName\":\"示例酒店\",\"storeAreaCode\":\"310115\",\"storeAddress\":\"上海市浦东新区示例路1号\"}"
}

公共响应参数

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

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
transNo 商户服务单号 string[1,64] 原样返回商户服务单号
serviceId 服务ID string[1,32] 服务标识
serviceInfo 服务信息 string[1,20] 服务单提供的服务说明
channelOrderNo 渠道服务单号 string[1,64] 渠道服务单号,由系统转换返回
creditStatus 服务单状态 string[1,32] 服务单当前状态:INITPROCESSINGSUCCESSCLOSEDFAIL。完结请求受理后、支付结果返回前通常保持 PROCESSING
orderAmt 服务结算总金额 int64 本次完结服务单的总金额,单位:分
creditStart 服务开始时间 string[14] 实际服务开始时间,格式 yyyyMMddHHmmss
creditStartRemark 服务开始时间备注 string[1,20] 实际服务开始时间说明
creditEnd 服务结束时间 string[14] 实际服务结束时间,格式 yyyyMMddHHmmss
creditEndRemark 服务结束时间备注 string[1,20] 实际服务结束时间说明
memo 扩展参数 string JSON格式,将响应Memo参数域转JSON字符串,承载完结服务单的其他业务数据

响应Memo参数域

变量 参数名 类型[长度限制] 必填 描述
riskFund 风险金信息 object 服务单风险金信息,字段结构与创建服务单的 memo.riskFund 一致
postPayments 后付费项目 array[object] 本次完结的最终付费项目,字段结构与请求 memo.postPayments 一致
postDiscounts 商户优惠 array[object] 本次完结的最终商户优惠,字段结构与请求 memo.postDiscounts 一致
goodsTag 优惠标记 string[1,512] 商户提交的优惠标记,原样返回
location 服务位置 object 服务开始及结束地点,字段结构与请求 memo.location 一致
spbillCreateIp 用户终端IP string[1,45] 用户客户端IP,支持IPv4和IPv6
deviceId 商户端设备号 string[1,32] 商户端设备号
storeId 门店编号 string[1,32] 商户侧门店编号
storeName 门店名称 string[1,256] 商户侧门店名称
storeAreaCode 门店地区编码 string[1,32] 商户门店地区编码
storeAddress 门店详细地址 string[1,512] 商户门店详细地址
attach 商户数据包 string[1,1024] 商户提交的附加数据,原样返回

公共响应示例

{
"success":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}

业务响应示例

{
  "transNo": "OUT_1666688488",
  "serviceId": "101",
  "serviceInfo": "某某酒店",
  "channelOrderNo": "10050100220208060900000023310957",
  "creditStatus": "PROCESSING",
  "orderAmt": 10000,
  "creditStart": "20260802090000",
  "creditStartRemark": "实际入住时间",
  "creditEnd": "20260803120000",
  "creditEndRemark": "实际离店时间",
  "memo": "{\"riskFund\":{\"name\":\"ESTIMATE_ORDER_COST\",\"amount\":10000,\"description\":\"预估订单费用\"},\"postPayments\":[{\"name\":\"房费\",\"amount\":10000,\"description\":\"实际入住一晚\",\"count\":1}],\"postDiscounts\":[{\"name\":\"新客优惠\",\"amount\":1000,\"description\":\"首次入住可用\",\"count\":1}],\"goodsTag\":\"{\\\"productTag\\\":\\\"default\\\"}\",\"location\":{\"startLocation\":\"上海市浦东新区\",\"endLocation\":\"上海市浦东新区\"},\"spbillCreateIp\":\"14.23.150.211\",\"deviceId\":\"13467007045764\",\"storeId\":\"STORE001\",\"storeName\":\"示例酒店\",\"storeAreaCode\":\"310115\",\"storeAddress\":\"上海市浦东新区示例路1号\",\"attach\":\"自定义数据\"}"
}

交易状态码

状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
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 13:59
最后编辑:贺前瑞  更新时间:2026-08-20 20:29