用于创建先享后付服务单。商户提交服务信息、协议号、预计服务时间和风险金等业务数据,慧收钱完成服务单创建后返回服务单状态及渠道服务单信息。
接口说明
- 测试请求URL:https://test-api.huishouqian.com/api/credit
- 生产请求URL:https://api.huishouqian.com/api/credit
- 请求方式:POST
公共请求参数
| 变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| method | 方法名 | string[1,32] | 是 | CREDIT_PAY_CREATE |
| 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] | 是 | 业务接入时分配的服务标识 |
| serviceInfo | 服务信息 | string[1,20] | 是 | 用于介绍本服务单所提供的服务 示例值:某某酒店 |
| merchantAgreementNo | 协议号 | string[1,64] | 条件必填 | 商户协议号 示例值:out3B2B64CC652AE663 |
| returnUrl | 后端通知地址 | string[1,256] | 是 | 接收服务确认或支付成功结果通知的地址 示例值:https://www.merchant.com/notify |
| requestDate | 交易时间 | string[14] | 是 | 请求时间,格式 yyyyMMddHHmmss示例值:20260801140908 |
| creditStart | 服务开始时间 | string[14] | 否 | 预计服务开始时间,格式 yyyyMMddHHmmss示例值:20260802090000 |
| creditStartRemark | 服务开始时间备注 | string[1,20] | 否 | 服务开始时间说明 示例值:预计入住时间 |
| creditEnd | 服务结束时间 | string[14] | 否 | 预计服务结束时间,格式 yyyyMMddHHmmss示例值:20260803120000 |
| creditEndRemark | 服务结束时间备注 | string[1,20] | 否 | 服务结束时间说明 示例值:预计离店时间 |
| needUserConfirm | 是否需要用户确认 | boolean | 否 | 需确认模式必须传 true;免确认模式可不传或传 false |
| memo | 扩展信息 | string | 否 | JSON格式,将Memo参数域转JSON字符串,承载渠道专属业务参数 |
Memo参数域
| 变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| attach | 商户数据包 | string[1,1024] | 否 | 可存放本服务单所需的附加信息,传入前需进行URL Encode |
| postPayments | 后付费项目 | array[object] | 否 | 后付费项目列表,最少1条、最多100条,具体字段见下表 |
| postDiscounts | 商户优惠 | array[object] | 否 | 商户优惠列表,最多30条,具体字段见下表 |
| 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号 |
| riskFund | 风险金信息 | object | 是 | 服务单风险金信息,具体字段见下表 |
| goodsTag | 优惠标记 | string[1,512] | 否 | JSON序列化字符串,协商后传入 |
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.location参数域
| 变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| startLocation | 服务开始地点 | string[1,50] | 否 | 开始使用服务的地点 示例值:上海市浦东新区 |
| endLocation | 服务结束地点 | string[1,50] | 否 | 结束使用服务的地点 示例值:上海市浦东新区 |
Memo.riskFund参数域
| 变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| name | 风险名称 | string[1,30] | 是 | 先免模式支持 DEPOSIT、ADVANCE、CASH_DEPOSIT;先享模式支持 ESTIMATE_ORDER_COST |
| amount | 风险金额 | int64 | 是 | 服务单风险金额,单位:分,须大于0 示例值:10000 |
| description | 风险说明 | string[1,30] | 否 | 风险金说明 示例值:预估订单费用 |
公共请求示例
{method=CREDIT_PAY_CREATE, format=json, signType=RSA2, ,signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=8000000026}业务请求示例
{
"transNo": "OUT_1666688488",
"serviceId": "101",
"serviceInfo": "某某酒店",
"agreementNo": "out3B2B64CC652AE663",
"returnUrl": "https://www.merchant.com/notify",
"requestDate": "20260801140908",
"creditStart": "20260802090000",
"creditStartRemark": "预计入住时间",
"creditEnd": "20260803120000",
"creditEndRemark": "预计离店时间",
"needUserConfirm": true,
"memo": "{\"attach\":\"自定义数据\",\"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号\",\"riskFund\":{\"name\":\"ESTIMATE_ORDER_COST\",\"amount\":10000,\"description\":\"预估订单费用\"},\"goodsTag\":\"{\\\"productTag\\\":\\\"default\\\",\\\"bizScene\\\":\\\"hotel\\\"}\"}"
}公共响应参数
| 变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 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] | 是 | 原样返回商户服务单号 |
| tradeNo | 订单号 | string[1,32] | 是 | 慧收钱内部服务单号 |
| serviceId | 服务ID | string[1,32] | 是 | 服务标识 |
| serviceInfo | 服务信息 | string[1,20] | 是 | 服务单提供的服务说明 |
| channelOrderNo | 渠道服务单号 | string[1,64] | 否 | 渠道服务单号,由系统转换返回 |
| creditStatus | 服务单状态 | string[1,32] | 是 | 服务单当前状态:INIT、CREATED、PROCESSING、SUCCESS、CLOSED、FAIL |
| creditStart | 服务开始时间 | string[14] | 否 | 服务开始时间,格式 yyyyMMddHHmmss |
| creditStartRemark | 服务开始时间备注 | string[1,20] | 否 | 服务开始时间说明 |
| creditEnd | 服务结束时间 | string[14] | 否 | 服务结束时间,格式 yyyyMMddHHmmss |
| creditEndRemark | 服务结束时间备注 | string[1,20] | 否 | 服务结束时间说明 |
| mechantAgreementNo | 协议号 | string[1,32] | 否 | 支付并签约后由慧收钱返回的协议号 |
| memo | 扩展参数 | string | 否 | JSON格式,将响应Memo参数域转JSON字符串 |
响应Memo参数域
| 变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| attach | 商户数据包 | string[1,1024] | 否 | 商户创建服务单时提交的附加数据 |
| postPayments | 后付费项目 | array[object] | 否 | 服务单后付费项目,字段结构与请求 memo.postPayments 一致 |
| postDiscounts | 商户优惠 | array[object] | 否 | 服务单商户优惠,字段结构与请求 memo.postDiscounts 一致 |
| 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] | 否 | 商户门店详细地址 |
| riskFund | 风险金信息 | object | 是 | 服务单风险金信息,字段结构与请求 memo.riskFund 一致 |
| needUserConfirm | 是否需要用户确认 | boolean | 否 | true表示需确认模式,false表示免确认模式 |
| goodsTag | 优惠标记 | string[1,512] | 否 | 商户创建服务单时提交的优惠标记,原样返回 |
公共响应示例
{
"success":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}业务响应示例
{
"transNo": "OUT_1666688488",
"serviceId": "101",
"serviceInfo": "某某酒店",
"channelOrderNo": "10050100220208060900000023310957",
"creditStatus": "CREATED",
"creditStart": "20260802090000",
"creditStartRemark": "预计入住时间",
"creditEnd": "20260803120000",
"creditEndRemark": "预计离店时间",
"orderNo": "2026080100000001",
"agreementNo": "out3B2B64CC652AE663",
"payscoreApplyToken": "dy_token_example",
"memo": "{\"attach\":\"自定义数据\",\"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号\",\"riskFund\":{\"name\":\"ESTIMATE_ORDER_COST\",\"amount\":10000,\"description\":\"预估订单费用\"},\"needUserConfirm\":true,\"goodsTag\":\"{\\\"productTag\\\":\\\"default\\\",\\\"bizScene\\\":\\\"hotel\\\"}\"}"
}交易状态码
| 状态码 | 描述 |
|---|---|
| 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:56
最后编辑:贺前瑞 更新时间:2026-08-20 20:29
最后编辑:贺前瑞 更新时间:2026-08-20 20:29