更新时间:2025-10-24 10:07:12
测试环境接口地址:http://test.lcsw.cn:8045/lcsw_mch或者http://test2.lcsw.cn:8117/lcsw_mch
正式环境接口地址:商户接口域名(对接完成后技术同事提供)
/merchant/withdraw/querycashPOST请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| inst_no | String | 15 | Y | 机构编号,平台分配 |
| version | String | 11 | Y | 版本号,固定"200" |
| trace_no | String | 32 | Y | 请求流水号 |
| merchant_no | String | 15 | Y | 扫呗商户号 |
| key_sign | String | 32 | Y | 签名检验串,传参字典序加令牌(令牌名称为key),32位md5加密转换 |
响应参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 响应码:“01”成功 ,02”失败,请求成功不代表业务处理成功 |
| return_msg | String | 128 | Y | 返回信息提示,“机构号不存在”“请求受限”等 |
| trace_no | String | 32 | Y | 请求流水号 |
| result_code | String | 2 | N | 业务结果:“01”成功 ,02”失败 |
| merchant_no | String | 15 | N | 扫呗商户号 |
| not_settle_amt | String | 11 | N | 清分金额(今日实时交易金额,即新入账金额),单位分 |
| settling_amt | String | 11 | N | 清算金额(若商户为手动清算则为可手动提现金额;若商户为自动清算则为等待划款的金额),单位分 |
| settled_amt | String | 11 | N | 结算金额(商户要到账的金额,即可提现金额),单位分 |
| book_balance | String | 11 | N | 账面总额(清分金额,清算金额,结算金额三者之和),单位分 |
| key_sign | String | 32 | N | 签名检验串,传参字典序加令牌(令牌名称为key),32位md5加密转换 |
Clearing:对交易数据依据机构和交易类型进行分类汇总,并计算结算金额的过程。Settlement:指根据清分结果对交易数据进行净额轧差和提交并完成资金划拨的全过程。Settlement of Accounts:指完成客户账户间资金划拨的全过程。举例如下:
book_balance(账面总额) = not_settle_amt(清分金额) + settling_amt(清算金额) + settled_amt(结算金额)
| 时间点 | book_balance(账面总额) | not_settle_amt(清分金额) | settling_amt(清算金额) | settled_amt(结算金额) |
|---|---|---|---|---|
| 2017-06-29 23:50:00 | 2400 | 2400 | 0 | 0 |
| 2017-06-30 00:10:00 | 2500 | 100 | 2400 | 0 |
| 2017-06-30 08:40:00 | 3200 | 800 | 0 | 2400 |
| 2017-06-30 08:50:00 | 3300 | 900 | 0 | 2400 |
| 2017-06-30 09:10:00 | 1000 | 1000 | 0 | 0 |
/merchant/withdraw/queryfeePOST请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| inst_no | String | 15 | Y | 机构编号,平台分配 |
| version | String | 11 | Y | 版本号,固定"200" |
| trace_no | String | 32 | Y | 请求流水号 |
| merchant_no | String | 15 | Y | 扫呗商户号 |
| amt | String | 11 | Y | 提现金额,单位分 |
| zero_arr_type | String | 2 | Y | D0类型:1普通纯D0 、2:钱包D0 |
| key_sign | String | 32 | Y | 签名检验串,传参字典序加令牌(令牌名称为key),32位md5加密转换 |
响应参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 响应码:“01”成功 ,02”失败,请求成功不代表业务处理成功 |
| return_msg | String | 128 | Y | 返回信息提示,“查询成功”,“请求受限”等 |
| trace_no | String | 32 | Y | 请求流水号 |
| result_code | String | 2 | N | 业务结果:“01”成功 ,02”失败 |
| merchant_no | String | 15 | N | 扫呗商户号 |
| fee_amt | String | 11 | N | 手续费,单位分 |
| key_sign | String | 32 | N | 签名检验串,传参字段序加令牌(令牌名称为key),32位md5加密转换 |
/merchant/withdraw/applycashPOST备注1:
备注2:
备注3:
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| inst_no | String | 15 | Y | 机构编号,平台分配 |
| version | String | 11 | Y | 版本号,固定"200" |
| trace_no | String | 32 | Y | 请求流水号 |
| merchant_no | String | 15 | Y | 扫呗商户号 |
| amt | String | 11 | Y | 提现金额,单位分 |
| fee_amt | String | 11 | Y | 手续费,单位分 |
| zero_arr_type | String | 2 | Y | 提现类型:1普通提现 、2:钱包提现 |
| cash_type | String | 2 | O | 资金类型(1:未结金额提现,2:已结金额提现),zero_arr_type="1"时必填 |
| txn_type | String | 2 | O | 到账周期:3:次日到账 、4:实时到账,zero_arr_type="2"时必填 |
| key_sign | String | 32 | Y | 签名检验串,传参字典序加令牌(令牌名称为key),32位md5加密转换 |
响应参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 响应码:“01”成功 ,02”失败,请求成功不代表业务处理成功 |
| return_msg | String | 128 | Y | 返回信息提示,“提现申请成功”,“请求受限”等 |
| trace_no | String | 32 | Y | 请求流水号 |
| result_code | String | 2 | N | 业务结果:“01”成功 ,02”失败 |
| merchant_no | String | 15 | N | 扫呗商户号 |
| key_sign | String | 32 | N | 签名检验串,传参字典序加令牌(令牌名称为key),32位md5加密转换 |
/merchant/withdraw/settlementrecordsPOST请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| inst_no | String | 15 | Y | 机构编号,平台分配 |
| version | String | 11 | Y | 版本号,固定201 |
| trace_no | String | 32 | Y | 请求流水号 |
| merchant_no | String | 15 | Y | 扫呗商户号 |
| begin_date | String | 8 | Y | 查询清算开始时间(yyyyMMdd) |
| end_date | String | 8 | Y | 查询清算结束时间(yyyyMMdd) |
| key_sign | String | 32 | Y | 签名检验串,,传参字典序+令牌(令牌名称为key),32位md5加密转换 |
响应参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 响应码:“01”成功 ,02”失败,请求成功不代表业务处理成功 |
| return_msg | String | 128 | Y | 返回信息提示,“查询成功”,“请求受限”等 |
| trace_no | String | 32 | Y | 请求流水号 |
| result_code | String | 2 | N | 业务结果:“01”成功 ,02”失败 |
| merchant_no | String | 15 | N | 扫呗商户号 |
| settle_list | String | - | N | 清算查询结果集,JSONArray见settle_list解析 |
| key_sign | String | 32 | N | 签名检验串,传参字典序加令牌(令牌名称为key),32位md5加密转换 |
settle_list数组参数的元素对象属性:
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| settle_date | String | 8 | Y | 清算日期(yyyyMMdd) |
| settle_amt | String | 11 | Y | 清算金额(分) |
| settle_status | String | 2 | Y | 清算状态(1 划款成功<表示已成功向银行发起划款,具体到账以银行通知为准> 2 划款失败 3 划款中 4 已划款,状态未知 <已经调用了划款接口,但是通道没有返回应答或返回了超时,无法判断是否成功,只能次日通过对账明确结果> |
| settle_status_msg | String | 128 | Y | 清算状态描述 |
| settle_channel_name | String | 20 | Y | 清算通道名称 |
| settle_card_name | String | 32 | N | 清算开户名称 |
| settle_card_no | String | 32 | N | 清算开户卡号,脱敏 |
| settle_card_bank | String | 32 | N | 清算开户支行 |