CBK分账V2版

一、接入指南

1.1接入前准备

联系对接支持人员或者分账项目经理获取测试参数

1.2接入域名

账户API域名：https://open-account.lcsw.cn/account/open

结算卡API域名：https://open-account.lcsw.cn/account/open

账户分账API域名：https://mch.lcsw.cn/lcsw

归集接口API域名：https://open-account.lcsw.cn/account/open

二、协议规则

调用API必须遵循以下规则：

2.1传输方式

为保证交易安全性，采用HTTPS传输,Content-type均为application/json

2.2提交方式

采用POST方法提交

2.3数据格式

提交和返回数据都为JSON格式

2.4字符编码

统一采用UTF-8字符编码

2.5判断逻辑

先判断return_code协议字段返回，再判断<font style="color:rgb(36, 41, 46);">result_code</font>业务状态返回，最后判断trade_status交易状态

2.6签名要求

请求和接收数据均需要校验签名，详细方法请参考-签名算法

2.7签名算法

使用MD5方式进行加密

接口中每一个字段(key_sign字段除外),以字典顺序排序之后,按照key1=value1&key2=value2.....&key="令牌"的顺序,进行拼接。对得到的字符串进行MD5签名/验签；

备注：无值null不参与签名；

示例请求参数：
{
"pay_ver": "201",
"pay_type": "010",
"service_id": "010",
"merchant_no": "839305812000286",
"terminal_id": "30616969",
"device_no":"202011261843460000",
"terminal_trace": "201811231154130000",
"terminal_time": "20181123115413",
"auth_no": "xxxxxxxx",
"total_fee": "1",
"order_body": "",
"attach": "",
"goods_detail": "",
"key_sign": ""
}
对应签名串：
string1="auth_no=xxxxxxxx&device_no=202011261843460000&goods_detail=&merchant_no=839305812000286&order_body=&pay_type=010
&pay_ver=201&service_id=010&terminal_id=30616969&terminal_time=20181123115413&
terminal_trace=201811231154130000&total_fee=1" ；

待签名字符串: string2=string1+"&key=xxxxxxxx";

通过摘要算法取得签名字符串: key_sign=md5(string2)

三、API调用时序图

调用时序图，请访问以下连接（密码请联系对接支持人员获取）

https://lcsw.yuque.com/vu2mam/etrung/tct8khu9s75ues9y?singleDoc#

四、账户 API

账户API域名：https://open-account.lcsw.cn/account/open

开户接口指南
1)根据4.1开户接口返回账户状态，返回法人上游签约中需要调用4.2接口获取签约链接（富友和网商）
2)富友通道归集账户流程 4.1开户接口中register_type传5（富友归集账户）,merchant_no必传。走7.1接口绑定归集关系

3）富友同主体无法多次开户,通过register_type传2（富友门店克隆账户）+account_temp_no（原主体CBK账户）去富友复用结算信息开户（新账户结算信息取原主体CBK账户的入网结算信息）

4.1 账户开户

URL:v2/createAccount
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	32	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号不能为空
group_no	String	32	N	集团编号
brand_no	String	32	Y	品牌编号
identity_id	String	32	Y	角色id，见下说明
merchant_no	String	32	N	扫呗商户号(传扫呗商户号,则基于该商户的主体资料开户) 注：register_type=0或5时，该字段必传
cust_info	String	32	N	开户信息,JSON字符串注：register_type=1时必传
register_type	String	1	Y	开户类型：0.扫呗商户开户 1.资料开户 2.门店账户克隆 5.归集账户
account_temp_no	String	32	N	要克隆的CBK账户注：register_type=2时必传
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

identity_id账户类型id可用值，自定义账户类型，需要联系运营同事提供对应账户类型id

账户类型id	账户类型名称	说明
6	入账方	仅能作为分账接收方或提现
8	门店	通道能力允许的条件下能进行门店间的分账或提现
16	归集商户	支持将资金归集给品牌的账户

资料开户，cust_info字段如下：

参数名称	类型	长度	必填	说明
business_license_type	String	1	Y	开户类型 1企业，2个体工商户，3个人(小微商户)
id_card_type	String	1	Y	身份证件类型 0身份证 1香港通行证 2澳门通行证 3台湾通行证4外国人永久居留证
bank_account_type	String	1	N	银行账户类型0未知，2平安产业结算通
license_name	String	100	N	工商注册名称（与注册工商信息时一致） (企业与个体户必传)
license_no	String	32	N	证件号码,与企业证件类型对应的企业注册号 (企业与个体户必传)
license_begintime	String	10	N	证件的开始日期。日期格式：YYYY-MM-DD
license_expire	String	10	N	证件到期日（格式YYYY-MM-DD）
login_phone	String	11	Y	登录手机号
legal_phone	String	11	Y	法人手机号
legal_idnum	String	18	Y	法人证件号码
legal_name	String	32	Y	法人姓名
id_card_start_date	String	10	N	证件发证日期 yyyy-MM-dd（企业与个体户传法人，小微传负责人）
id_card_end_date	String	10	N	证件到期日期 yyyy-MM-dd,如果证件到期日期为“长期”，则传：“2099-01-01”。
account_type	String	1	N	结算卡业务类型枚举值：1：对公2：对私
account_phone	String	11	N	银行预留手机号
account_name	String	64	N	结算卡开户姓名,绑定卡是对公卡，户名是企业名称，如果对私，户名是法人姓名
account_cardno	String	30	N	结算银行卡号
account_idnum	String	20	N	结算卡身份证号
merchant_name	String	20	N	户名简称。当account_name长度大于20时必传该字段。
bank_name	String	64	N	开户支行名称
bank_code	String	25	N	支行编号。银行编号表下载 .
image_business_license	String	255	N	营业执照图片url
business_location	String	32	N	经营地址
img_idcard_front	String	255	N	身份证正面照url
img_idcard_back	String	255	N	身份证背面照url
img_logo	String	255	N	商户门头照片url
img_contract	String	255	N	店内环境照片url
province_code	String	8	N	银联省code 省市区编号表下载
city_code	String	8	N	银联市code
county_code	String	8	N	银联区code
mcc_code	String	32	N	行业类目
home_addr	String	255	N	法人户籍地址
account_email	String	60	N	联系人邮箱

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
account_no	String	32	N	原请求流水号
channel_account_no	String	32	N	通道账号
card_info	String	255	N	结算卡信息
account_status	String	1	Y	账户状态,枚举值： 0未申请 1正常 2法人上游签约中 3已冻结 4法人上游待签约 9已关闭 10已注销

结算卡信息card_info字段如下：

参数名称	类型	长度	必填	说明
account_type	String	1	Y	结算卡类型 1.对公 2.对私
account_phone	String	11	Y	银行预留手机号
account_cardno	String	32	Y	结算银行卡号
account_idnum	String	20	Y	结算卡身份证号
account_name	String	64	Y	结算卡开户姓名,绑定卡是对公卡，户名是企业名称，如果对私，户名是法人姓名
bank_name	String	64	Y	开户支行名称

4.2 生成签约链接

URL：v2/getSignUrl
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	32	N	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号不能为空
account_no	String	20	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	20	N	商户号（CBK账号，商户号，三方账号三选一）
partner_store_no	String	20	N	三方账号（CBK账号，商户号，三方账号三选一）
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
account_no	String	20	N	CBK账号
account_status	String	2	N	账户状态,枚举值： 0未申请 1正常 2法人上游签约中 3已冻结 4法人上游待签约 9已关闭 10已注销
account_sign_url	String	256	N	开户签约地址
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换

4.3 查询账户

URL：v2/queryAccount
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	8	N	机构编号，扫呗分配
brand_no	String	32	N	品牌编号
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
account_no	String	32	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	32	N	商户号（CBK账号，商户号，三方账号三选一）
partner_store_no	String	32	N	三方账号（CBK账号，商户号，三方账号三选一）
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
group_no	String	16	N	集团编号
brand_no	String	16	N	品牌编号
account_no	String	32	N	CBK账号
account_name	String		N	结算卡开户姓名
account_phone	String	11	N	结算人手机号
account_idnum	String	20	N	结算人证件号
account_cardno	String	64	N	结算银行卡号
bank_code	String	16	N	银行代码
bank_name	String	64	N	发卡行名称
account_channel	String	2	N	CBK账户当前分账通道
channel_account_no	String	32	N	对应通道账号
agreement_status	String	2	N	协议签署状态 0-未签署，1-已签署
channel_fail_reason	String	64	N	通道入驻驳回原因
account_type	String	2	N	结算卡类型 1.对公 2.对私
business_license_type	String	2	N	账户类型：1企业，2个体工商户，3个人(小微商户)
license_name	String	64	N	营业执照名称
license_no	String	32	N	社会统一信用代码
legal_name	String	32	N	法人名称
legal_idnum	String	32	N	法人身份证号
account_custom_name	String	64	N	CBK账户名
id_card_type	String	2	N	身份证件类型 0身份证 1香港通行证 2澳门通行证 3台湾通行证4外国人永久居留证
identity_id	String	16	N	角色id
identity_name	String	16	N	账户身份名称
open_time	String	19	N	开户时间yyyy-MM-dd HH:mm:ss
account_status	String	2	N	账户状态,枚举值： 0未申请 1正常 2法人上游签约中 3已冻结 4法人上游待签约 9已关闭 10已注销
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

4.4 注销账户

URL：v2/closeAccount
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	32	N	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号不能为空
account_no	String	32	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	32	N	商户号（CBK账号，商户号，三方账号三选一）
partner_store_no	String	32	N	三方账号（CBK账号，商户号，三方账号三选一）
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换

4.5 修改账户

仅支持中信通道的账户信息修改。

URL：v2/updateAccount
Method: POST
ContentType: application/json

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	32	N	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号不能为空
account_no	String	32	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	32	N	商户号（CBK账号，商户号，三方账号三选一）
partner_store_no	String	32	N	三方账号（CBK账号，商户号，三方账号三选一）
legal_idnum	String	18	N	法人证件号码
legal_name	String	32	N	法人名称
license_no	String	32	N	社会统一信用代码
license_name	String	100	N	证件名称
home_addr	String	255	N	户籍地址,为身份证上的住址
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换

五、结算卡 API

结算卡API域名：https://open-account.lcsw.cn/account/open

5.1 绑定结算卡

URL：v2/bindCard
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	8	N	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
account_no	String	32	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	32	N	商户号（CBK账号，商户号，三方账号三选一）
partner_store_no	String	32	N	三方账号（CBK账号，商户号，三方账号三选一）
account_cardno	String	32	Y	结算银行卡号
account_name	String	64	Y	结算卡开户姓名,绑定卡是对公卡，户名是企业名称，如果对私，户名是法人姓名
bank_code	String	20	Y	支行编号
account_idnum	String	18	Y	结算卡身份证号
account_phone	String	11	Y	银行预留手机号
bank_name	String	64	Y	支行名称
province_code	String	3	Y	省code
city_code	String	34	Y	市code
county_code	String	6	N	区code
account_type	String	32	Y	结算类型 1对公 2对私
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	原请求流水号
bind_status	String	2	N	结算卡绑定状态枚举值：0.未绑定；1.绑定成功；2.绑定失败；3.绑定审核中
key_sign	String	32	N	签名检验串，点击查看签名算法

5.2 发起银行卡激活

URL：v2/applyActiveCard
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	8	N	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
account_no	String	32	N	CBK账号
merchant_no	String	32	N	扫呗商户号
partner_store_no	String	32	N	三方账号
account_cardno	String	32	N	鉴权银行卡号(不传则对默认卡进行鉴权)
verify_type	String	4	Y	鉴权类型 1 打款 2 短信 3 签约链接
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
verify_type	String	4	Y	鉴权类型 1 打款 2 短信 3 签约链接
card_active_url	String	32	N	银行卡激活地址,verify_type=3（绑定审核中）返回
contract_url	String	128	N	签约链接
bind_status	String	4	N	结算卡状态 0：未绑定；1：绑定成功；2：绑定失败；3：绑定审核中
account_phone	String	11	N	鉴权手机号
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

5.3 验证银行卡激活

URL：v2/checkActiveCard
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	8	N	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
account_no	String	32	N	CBK账号
merchant_no	String	32	N	扫呗商户号
partner_store_no	String	32	N	三方账号
account_cardno	String	32	N	结算银行卡号（不传取当前账户默认结算卡)
verify_type	String	4	Y	鉴权类型 1 打款 2 短信 3 签约链接
verify_no	String	16	Y	打款鉴权传入输入金额短信鉴权传入短信验证码
order_no	String	64	N	指令号,平安通道和打款金额一起上送（平安通道需要）
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	原请求流水号
bind_status	String	2	N	结算卡绑定状态枚举值：0.未绑定；1.绑定成功；2.绑定失败；3.绑定审核中
key_sign	String	32	N	签名检验串，点击查看签名算法

5.4 设置默认结算卡

URL：v2/setDefaultCard
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	8	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，每次请求不可重复
account_no	String	32	N	CBK账号
merchant_no	String	15	N	扫呗商户号
partner_store_no	String	32	N	三方账号
account_cardno	String	32	Y	结算卡号
key_sign	String	32	Y	签名检验串，点击查看签名算法

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

5.5 解绑结算卡

URL：v2/unBindCard
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	8	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，每次请求不可重复
account_no	String	32	N	CBK账号
merchant_no	String	15	N	扫呗商户号
partner_store_no	String	32	N	三方账号
account_cardno	String	32	N	结算卡号
key_sign	String	32	Y	签名检验串，点击查看签名算法

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

5.6 修改结算卡

URL：v2/updateCard
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	8	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，每次请求不可重复
account_no	String	32	N	CBK账号
merchant_no	String	15	N	扫呗商户号
partner_store_no	String	32	N	三方账号
account_cardno	String	32	Y	结算卡号
new_account_cardno	String	32	N	需更新卡号（可不传）
account_name	String	64	N	结算卡开户姓名,绑定卡是对公卡，户名是企业名称，如果对私，户名是法人姓名
bank_code	String	20	N	支行编号
account_idnum	String	18	N	结算卡身份证号
account_phone	String	11	N	银行预留手机号
bank_name	String	64	N	支行名称
province_code	String	3	N	省code
city_code	String	4	N	市code
county_code	String	6	N	区code
account_type	String	32	N	结算类型 1对公 2对私
key_sign	String	32	Y	签名检验串，点击查看签名算法

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

5.7 查询结算卡

URL：v2/queryCard
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	8	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，每次请求不可重复
account_no	String	32	N	CBK账号
merchant_no	String	15	N	扫呗商户号
partner_store_no	String	32	N	三方账号
account_cardno	String	32	N	结算卡号
key_sign	String	32	Y	签名检验串，点击查看签名算法

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
result_code	String	2	N	受理（业务）结果 01:成功 02:失败
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
card_info	String		N	银行卡列表 JSON字符串格式
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

card_info参数

参数名称	类型	长度	必填	说明
account_cardno	String	32	Y	结算卡号
account_name	String	64	Y	结算户名
bank_name	String	64	Y	支行名
bank_code	String	8	N	银联号
account_phone	String	32	Y	银行预留手机号
bind_status	String	2	Y	0：未绑定；1：绑定成功；2：绑定失败；3：绑定审核中
bind_desc	String	64	Y	绑定描述
is_default	String	2	Y	0非默认卡 1默认卡
settlement_type	String	2	Y	结算类型:1.法人结算

六、账户分账API

账户分账API域名：https://mch.lcsw.cn/lcsw

6.1 账户余额查询

URL:account/open/querybalance
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，可用值：150
inst_no	String	8	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，不带“-”的uuid
account_no	String	32	N	CBK账号(与扫呗商户号、CBK账号、三方编号三选一)
merchant_no	String	32	N	扫呗商户号(与扫呗商户号、CBK账号、三方编号三选一)
partner_store_no	String	32	N	三方编号(与扫呗商户号、CBK账号、三方编号三选一)
key_sign	String	32	Y	签名检验串，点击查看签名算法

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	原请求流水号
account_no	String	32	N	CBK账号
total_bal	String	11	N	账户总额,查询的账户的账户总额（冻结金额+待结算金额+预留金额+可提现金额+待缴金额）单位分
freeze_bal	String	11	N	冻结金额,查询的账户已冻结的金额，单位分
freeze_bal_details	String	1024	N	冻结金额明细,Json格式
prepaid_bal	String	11	N	待结算金额（不可提现，不可用于冻结）单位分。特殊说明：平安通道若申请了待结算金额可用于分账，需与available_bal相加，为可分账金额
reserve_amt	String	11	N	预留金额
cash_amt	String	11	N	可提现金额或者可发起冻结金额
pending_amt	String	11	N	待缴金额
pending_amt_details	String	1024	N	待缴金额明细,Json格式
recharge_dedicated_amt	String	11	N	一卡多户共用充值入金户的余额（不可提现，不可用于冻结，不可用于退款）特殊说明：1.中信通道开通一卡多户后，该字段会返回多账户共用账户的余额，账户可用余额+该字段余额即为采购可用资金。2.若系统方在自有系统为加盟商展示CBK余额，需将该字段金额单独展示为多账户共用金额。
transferable_amt	String	11	N	可分账金额(api_ver=150时返回) 特殊说明：可分账金额根据CBK后台多种条件计算得出，并不一定等于接口中其它几个字段之和，具体金额明细可查阅CBK后台账户详情。可分账金额不代表可提现金额，也不代表账户实际余额，且不可用于发起冻结。

以下字段为 freeze_bal_details字段

参数名称	类型	长度	必填	说明
freeze_business_type	String	11	N	0.供应链采购冻结 1.品牌冻结 2.团餐待完结订单 3.清分补款 4.品牌管理费 5.品牌手动分账
freeze_business_name	String	50	N	冻结业务名称
freeze_sub_amt	String	11	N	冻结金额

以下字段为 pending_amt_details字段

参数名称	类型	长度	必填	说明
pending_business_type	String	11	N	0.供应链采购冻结 1.品牌冻结 2.团餐待完结订单 3.清分补款 4.品牌管理费 5.品牌手动分账
pending_business_name	String	50	N	待缴业务名称
pending_sub_amt	String	11	Y	待缴金额

6.2 账户余额分账

特殊说明：余额分账指的是使用虚拟账户的余额进行资金的划拨分账。客户计算分账金额的依据可以是按自己的业务订单计算分账比例或其它分账规则，在虚拟账户余额充足的情况下，发起余额分账的请求

URL:account/open/dotrans
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	8	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，每次请求不可重复
trade_no	String	32	Y	分账流水号，系统方自己定义，每次请求需唯一（30s内请勿重复请求，如果该单号存在分账成功记录，无法再次请求）
account_out	String	32	选填	出账方CBK账号(与扫呗商户号、CBK账号、三方编号三选一)
merchant_out	String	15	选填	出账方扫呗商户号(与扫呗商户号、CBK账号、三方编号三选一)
partner_store_no_out	String	32	选填	出账方三方编号(与扫呗商户号、CBK账号、三方编号三选一)
account_in	String	32	选填	入账方CBK账号(与扫呗商户号、CBK账号、三方编号三选一)
merchant_in	String	15	选填	入账方扫呗商户号(与扫呗商户号、CBK账号、三方编号三选一)
partner_store_no_in	String	32	选填	入账方三方编号(与扫呗商户号、CBK账号、三方编号三选一)
amt	String	11	Y	分账金额,单位分
scene_no	String	10	N	场景编号（如有指定场景需求，需提前找分账项目经理添加场景，不能随便传。不传时，默认定义为其他）
order_type	String	1	N	业务来源类型：0余额 1微信 2支付宝 3扫呗校园外卖 4抖音 5美团 6饿了么 7通联 8快手 9大众点评 10富友 11随行付 12乐刷 13库享
notify_url	String	128	N	回调通知地址（只有当分账状态trade_status返回3处理中时，回调才生效）
order_body	String	100	Y	交易备注
attach	String	128	N	附加数据
key_sign	String	32	Y	签名检验串，点击查看签名算法

返回参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	请求流水号，每次请求不可重复
trade_no	String	32	N	分账流水号,原样返回
out_trade_no	String	32	N	CBK分账交易订单号,分账完成后生成的唯一流水号
trade_status	String	1	N	分账状态 1：成功 2：失败 3：处理中（需使用回调或者查询）
attach	String	128	N	交易备注

6.3 扫呗支付订单分账

注：

1.该接口只支持使用扫呗收单，且支付通道使用富友通道的普通支付。

2.产业支付、非富友通道的支付、中信或平安通道分账、以及非扫呗支付的订单，若要基于订单进行分账，请系统放按照自己的订单金额以及规则，计算需要分账的金额后，使用2.1账户余额分账接口进行分账（当天的收单金额，由于还未清算，建议清算后再调用分账接口）。

3.当天的支付订单，发起订单分账，为预分帐操作，在第二天完成资金到账，故回调通知也在第二天收到。若是对之前的订单发起分账，则分账资金实时到账。

URL：account/open/batchAllocate
Method：POST

请求参数

参数名称	类型	长度	必填	说明
pay_ver	String	3	Y	版本号，固定值100
inst_no	String	15	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，每次请求不可重复
account_no	String	32	选填	出账方CBK账号(与扫呗商户号、CBK账号二选一)
merchant_no	String	15	选填	出账方扫呗商户号(与扫呗商户号、CBK账号二选一)
trade_no	String	32	Y	分账流水号，商户可自己定义，多次请求时请勿使用同一个值，每次请求需使用不同的值。
rule_list_json	String	1024	Y	分账列表,json字符串
scene_no	String	10	N	场景编号（如有指定场景需求，需提前找分账项目经理添加场景，不能随便传。不传时，默认定义为其他）
order_body	String	100	N	订单描述
out_trade_no_list	List	32	Y	扫呗支付的扫呗订单号（该参数拼接签名串时，[ ]号内的参数不需要加""号，即&out_trade_no_list=[aaaaaaa]&）
attach	String	128	N	附加数据,原样返回
notify_url	String	128	N	回调通知地址（该接口为预分帐请求，回调在第二天通知）
key_sign	String	32	Y	签名检验串，点击查看签名算法

以下字段为rule_list_json字段

参数名称	类型	长度	必填	说明
account_in	String	15	Y	入账户CBK账号
allocate_amt	Number	11	Y	分账固定金额单位：分
allocate_trace	String	32	Y	入账流水号（需生成唯一值，后续用于分账查询）

返回参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	请求流水号，每次请求不可重复
trade_no	String	32	Y	分账流水号，返回商户系统的订单号
out_trade_no	String	32	Y	利楚唯一分账订单号
allocate_date	String	32	N	分账发起日期
allocate_in_list	String		N	入账订单集合
attach	String	32	N	附加数据，原样返回

以下字段为 allocate_in_list字段

参数名称	类型	长度	必填	说明
account_in	String	15	Y	入账户CBK账号
allocate_amt	Number	11	Y	分账入账金额单位：分
allocate_trace	String	32	N	入账流水号
sub_trade_no	String	32	Y	利楚入账子订单号
trade_status	String	2	Y	分账状态 1：成功 2：失败 3：处理中 4.待分账
allocate_msg	String	128	Y	子订单交易状态描述

6.4 账户提现

URL:account/open/withdrawapply
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	8	Y	机构编号，扫呗分配
trade_no	String	32	Y	提现流水号,商户侧需保证唯一性
trace_no	String	32	Y	请求流水号，每次请求不可重复
amt	String	11	Y	交易金额,单位分
account_no	String	32	选填	CBK账号(与扫呗商户号、CBK账号、三方编号三选一)
merchant_no	String	15	选填	扫呗商户号(与扫呗商户号、CBK账号、三方编号三选一)
partner_store_no	String	32	选填	三方编号(与扫呗商户号、CBK账号、三方编号三选一)
attach	String	128	N	交易备注
notify_url	String	255	N	外部系统通知地址
key_sign	String	32	Y	签名检验串，点击查看签名算法

返回参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	请求流水号，每次请求不可重复
trade_no	String	32	N	提现流水号,原样返回
out_trade_no	String	32	N	交易订单号,交易完成后生成的唯一流水号
poundage	String	11	N	提现手续费，单位分
trade_status	String	2	N	订单状态 2：失败 3：处理中
attach	String	128	N	交易备注

6.5 交易详情查询

URL:account/open/queryorder
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	8	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，每次请求不可重复
trade_no	String	32	N	交易请求(分账、提现、退回)流水号。使用2.1账户余额分账接口进行分账时，该字段传2.1账户余额分账接口里返回的trade_no；使用2.2批量订单分账接口进行分账时，该字段传递2.2批量订单分账接口里返回的allocate_trace；查询提现明细时，该字段传递2.3账户提现接口的trade_no; 查询退回明细时，该字段传递2.8分账交易退回接口的trade_no; trade_no和out_trade_no两者选其一
out_trade_no	String	32	N	CBK分账交易订单号（使用2.1账户余额分账接口进行分账时，该字段传2.1账户余额分账接口里返回的out_trade_no。使用2.2批量订单分账接口进行分账时，该字段传递2.2批量订单分账接口里返回的sub_trade_no）, trade_no和out_trade_no两者选其一
key_sign	String	32	Y	签名检验串，点击查看签名算法

返回参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	原请求流水号
trade_no	String	32	N	商户自己的交易流水号,原样返回
out_trade_no	String	32	N	扫呗交易订单号,交易完成后生成的唯一流水号
amt	String	11	N	交易金额,单位分
name_out	String	32	N	出账方姓名
account_out	String	15	N	出账方CBK账号
account_in	String	15	N	入账方CBK账号,提现交易返回银行卡号.
name_in	String	32	N	入账方账户名
create_time	String	19	N	交易创建时间yyyy-MM-dd HH:mm:ss
finish_time	String	19	N	交易完成时间yyyy-MM-dd HH:mm:ss
trade_status	String	2	N	分账状态：0.未知 1.成功 2.失败 3.处理中 4.待分账 5.分账回退成功
trade_type	String	1	N	交易类型: 0.未知 1.订单分账 2.余额分账 3.充值 4.提现 5.清分
attach	String	128	N	交易备注

6.6 提现交易回调通知

Method: POST
ContentType: application/json

注:商户成功接收回调,请返回{"return_code": "01","return_msg": "success"} JSON字符串. 推送参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trade_no	String	32	N	商户交易流水号
out_trade_no	String	32	N	交易订单号
amt	String	11	N	交易金额,单位分
trade_status	String	1	N	分账状态1:成功，2:失败
finish_time	String	19	N	交易完成时间yyyy-MM-dd HH:mm:ss
attach	String	128	N	交易备注
order_body	String	100	N	备用字段

需返回参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	返回信息提示

6.7 分账交易回调通知

Method: POST
ContentType: application/json

注:商户成功接收回调,请返回{"return_code": "01","return_msg": "success"} JSON字符串. 推送参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trade_no	String	32	N	商户交易流水号
out_trade_no	String	32	N	分账订单号
sub_out_trade_no	String	32	N	入账子订单号
total_transfer_amt	String	11	N	分账订单总金额,单位分
amt	String	11	N	分账入账金额,单位分
trade_status	String	1	N	分账状态1:成功，2：失败
account_out	String	32	N	出账方CBK账号
merchant_out	String	15	N	扫呗出账商户号
account_in	String	32	N	入账方CBK账号
merchant_in	String	15	N	扫呗入账商户号
finish_time	String	19	N	分账完成时间yyyy-MM-dd HH:mm:ss
attach	String	128	N	备注
order_body	String	100	N	备用字段

需返回参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	返回信息提示

6.8 分账数据列表查询

Method: POST
url：account/open/queryTradesByDate

请求参数：

参数名称	类型	长度	必填	说明
api_ver	String	11	Y	版本号，固定值100
trace_no	String	32	Y	请求流水号，每次请求不可重复
inst_no	String	15	Y	机构编号，扫呗分配
account_no	String	32	Y	CBK账号
start_date	String	8	Y	查询开始日期，格式为yyyyMMdd
end_date	String	8	Y	查询结束日期，格式为yyyyMMdd
page	String	11	Y	页码
query_flag	String	1	N	查询标志中信：不需要传这个字段，默认查所有类型数据平安：必传参数：1：交易明细汇总 2：提现 3：清分
key_sign	String	32	Y	签名检验串，点击查看签名算法

响应参数：

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码01，成功 02失败
return_msg	String	32	Y	业务响应描述
trace_no	String	30	Y	请求流水号
tradeDataList	List	1	Y	CBK账号交易详情
result_code	String	2	Y	业务处理响应码，01成功 02失败
key_sign	String	32	Y	签名检验串，点击查看签名算法
total_page	String	15	Y	总页数
total_number	String	15	Y	记录总数
account_channel	int	11	Y	CBK账号所属通道

tradeDataList列表

参数名称	类型	长度	必填	说明
trans_date	String	8	Y	交易日期，格式： YYYYMMDD
trans_time	String	6	Y	交易时间，格式：HHMMSS
trans_type	String	1	Y	交易类型: 1.订单分账 2.余额分账3. 充值 4.提现 5.分账退回 6. 清分
trans_flag	String	1	N	资金方向 1：转出 2：转入
amt	String	11	Y	交易金额，单位：分
out_trade_no	String	15	Y	CBK分账订单号
channel_trade_no	String	10	Y	通道分账订单号
trade_status	String	1	Y	0:成功
order_body	String	100	Y	交易备注

6.9 分账交易退回

URL：account/open/allocateRefund
Method：POST

接口说明: 1、允许多次回退。累计退回金额需小于等于源分账金额。 2、退回发起时，入账方余额不足的情况下，此笔退回交易失败，后续需继续尝试退回，需重新调用本接口。
请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，固定值100
inst_no	String	15	Y	机构编号，扫呗分配
brand_no	String	15	N	品牌编号
trace_no	String	32	Y	请求流水号，每次请求新生成，且不可重复
trade_no	String	32	Y	退回请求单号(多次请求退回时，要保证每次使用的单号不同，不能重复使用一个单号，且不能使用分账请求里的trade_no)
sub_trade_no	String	32	Y	要退回的原分账单号，2.1余额分账接口返回的out_trade_no(或2.2扫呗支付订单分账接口返回的sub_trade_no“利楚入账子订单号”)
allocate_amt	Number	11	Y	分账退回金额单位：分
attach	String	128	N	附加数据,原样返回
key_sign	String	32	Y	签名检验串，点击查看签名算法

返回参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串，点击查看签名算法
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	请求流水号，每次请求不可重复
trade_no	String	32	Y	交易流水号，返回商户系统的订单号
out_refund_no	String	32	N	利楚分账退回订单号
trade_status	String	2	N	订单状态 1：退回成功 2：退回失败
attach	String	32	N	附加数据，原样返回

6.10 查询时间段内渠道入金交易明细

Method: POST
url：account/open/manager/queryChannelTransIn

请求参数：

参数名称	类型	长度	必填	说明
api_ver	String	11	Y	当前可用版本号100、110
trace_no	String	32	Y	请求流水号，每次请求不可重复
inst_no	String	15	Y	机构编号，扫呗分配
brand_no	String	15	Y	品牌编号，扫呗分配
trans_in_date	String	10	Y	入金日期，（格式YYYY-MM-DD）
current_pageid	int	8	Y	页码，初始值为1
key_sign	String	32	Y	签名检验串，点击查看签名算法

响应参数：

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码01，成功 02失败
return_msg	String	32	Y	业务响应描述
trace_no	String	30	Y	请求流水号
transDataList	String	1024	Y	挂账交易详情
result_code	String	2	Y	业务处理响应码，01成功 02失败
key_sign	String	32	Y	签名检验串，点击查看签名算法
total_page	String	15	Y	总页数
total_number	String	15	Y	记录总数
account_channel	int	11	Y	CBK账号所属通道

transDataList为json字符串类型

参数名称	类型	长度	必填	说明
trans_date	String	8	N	交易日期，格式： YYYY-MM-DD
trans_amt	String	12	N	交易金额，单位：分
bank_info	String	50	N	转账银行信息
remark	String	50	N	转账备注
channel_trade_no	String	50	N	渠道流水号
account_no_in	String	32	N	CBK账号（api_ver=110时返回）
trans_in_no	String	25	N	入金账号
trans_in_name	String	25	N	入金账户名称
trans_out_no	String	25	N	出金账号
trans_out_name	String	25	N	出金账户名称
trans_type	String	2	N	01：转账入金 02：会员充值/退票入账 03：支付渠道入金

6.11 资金冻结

URL：account/open/freeze
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，当前版本100
inst_no	String	15	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号，不带“-”的uuid
account_no	String	32	N	一账通账号
merchant_no	String	15	N	扫呗商户号(与一账通账号二选一)
freeze_amt	String	11	Y	解冻/冻结的金额
freeze_type	int	1	Y	交易类型 1.冻结 2.解冻
business_type	int	11	Y	业务类型: 1.品牌冻结 2.团餐待完结订单
attach	String	128	N	备注
key_sign	String	32	Y	签名检验串,拼装所有非空参数+令牌（字典序，商家令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串,拼装所有非空参数+令牌（字典序，商家令牌名称为key），32位md5加密转换
result_code	String	2	N	业务处理响应码，01成功 02失败
trace_no	String	32	Y	原请求流水号

七、归集接口API

归集接口API域名：https://open-account.lcsw.cn/account/open

7.1 归集账户绑定

URL：rule/open/fy/bindGJ
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	32	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号不能为空
account_no	String	32	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	32	N	扫呗商户号
partner_store_no	String	32	N	三方账号
notify_url	String	255	N	通知地址不能超过255位长度
attach	String	64	N	附加数据
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换
bind_list	String		Y	批量绑定
-concentrate_no	String	32	Y	签约归集主体
-concentrate_type	String	3	Y	业务类型 1归集授权 2待结转归集授权
-contract_type	String	3	N	签约类型 1.短信 2.签约链接，不传默认1
-concentrate_ratio	String	5	N	签约比例万分比，不传取品牌配置比例

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
bind_list	String		N	返回对象
-concentrate_no	String		N
-url	String	255	N	激活链接
-bind_status	String	1		账户状态,枚举值： 0未申请 1绑定成功 2绑定失败 3签约中
-modify_no	String	32		变更单号
-status	String	1		0 失败 1 成功
-err_reason	String	255		原因

7.2 归集账户解绑

URL：rule/open/fy/unBindGJ
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	32	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号不能为空
account_no	String	32	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	32	N	扫呗商户号
partner_store_no	String	32	N	三方账号
concentrate_no	String	32	N	签约归集主体，不传取品牌配置主体
attach	String	32	N	备注
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
bind_status	String	1	N	绑定状态,枚举值： 0未申请 1绑定成功 2绑定失败 3签约中

7.3 归集账户绑定关系查询

URL：rule/open/fy/queryBindGJStatus
Method: POST
ContentType: application/json

请求参数

参数名称	类型	长度	必填	说明
api_ver	String	3	Y	版本号，默认100
inst_no	String	32	Y	机构编号，扫呗分配
trace_no	String	32	Y	请求流水号不能为空
account_no	String	32	N	CBK账号（CBK账号，商户号，三方账号三选一）
merchant_no	String	32	N	扫呗商户号
partner_store_no	String	32	N	三方账号
concentrate_no	String	32	N	签约归集主体（非必传）
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
return_msg	String	128	Y	返回信息提示
key_sign	String	32	Y	签名检验串,非空参数字典排序+令牌（终端令牌名称为key），32位md5加密转换
trace_no	String	32	Y	请求流水号，不带“-”的uuid,商户侧需保证唯一性
result_code	String	2	N	受理（业务）结果 01:成功 02:失败 03:受理中
bind_status	String	1	N	绑定状态,枚举值： 0未申请 1绑定成功 2绑定失败 3签约中
account_no	String	32	N	CBK账户
modify_no	String	32	N	变更单号
concentrate_no	String	32	N	签约归集主体
concentrate_ratio	String	5	N	签约比例万分比
concentrate_type	String	1	N	业务类型 1归集授权 2待结转归集授权
attach	String	64	N	附加数据

7.4 归集授权结果回调通知

Method: POST
ContentType: application/json

注:商户成功接收回调,请返回{"return_code": "01","return_msg": "success"} JSON字符串.

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	业务响应描述
key_sign	String	32	Y	签名检验串,拼装所有非空参数+令牌（机构令牌名称为key），32位md5加密转换
result_code	String	2	N	业务处理响应码，01成功 02失败
modify_no	String	32	N	变更单号
modify_status	String	1	N	申请状态0：处理中 1：成功 2：失败 3处理中 4已下架
attach	String	128	N	交易备注

响应参数

参数名称	类型	长度	必填	说明
return_code	String	2	Y	业务响应码，01成功 02失败
return_msg	String	128	Y	返回信息提示

八、对账单文件

8.1分账对账单下载

URL：https://example.com/order/account/day/inst_no/key_sign/inst_no_day.txt
Method：GET

请注意：对账单只能获取生产环境数据，测试环境测试数据无法获取。

有对账单下载需求的机构，请先联系项目经理提交开通对账单下载功能邮件申请。
只能下载“对账单下载”功能开启后的对账单，无法下载开启功能之前的对账单，历史账单可通过后台对账单功能进行下载。
接口不能下载当天的对账单，只能下载前一天或者之前的对账单。

对账单更新日志：

日期	版本列表	内容
2023-02-02	100	初始版本
2024-12-20	110	增加"品牌编号"、"出账扫呗商户号"、"入账扫呗商户号"、"入账方三方门店编号"、"场景名称"
2025-07-22	120	增加返回"出账方三方门店编号"、"备注"字段

若返回以上内容，并不是说密钥不对。提示是未找到对账单文件，请检查是否开启对账单下载功能，或者检查拼接的地址是否正确。

请求路径中example.com只是个示例，请联系对接人员获取真实域名。请求路径中除了/、order、account和.txt，其它全部是变量名，在实际请求中需要替换成变量的值，示例如下：

http://open.lcsw.cn/order/account/20220918/33100010/0161c86f602b02ddf9be76d2da/33100010_20220918.txt

签名算法
MD5加密，utf-8格式转小写,加密后得到key_sign的值，并替换url中的key_sign。

String key_sign = MD5.encode(day=xxxxxx&inst_no=xxxxxx&key=xxxxxx);

签名参数：

参数名称	说明
day	日期，yyyyMMdd，例如：20170208
inst_no	机构号
key	机构号对应的令牌

请求结果中，每一行表示一条交易记录，记录中各参数以,号分隔。各参数含义如下所示："品牌编号"(110及以上版本),"出账CBK账号或平台账号","出账CBK名称或打款账户名称","出账扫呗商户号"(110及以上版本),"出账方三方门店编号"(120及以上版本),"入账CBK账号","入账CBK名称","入账扫呗商户号"(110及以上版本),"入账方三方门店编号"(110及以上版本),"创建日期","创建时间","交易金额(分)","手续费(分)","交易单号","CBK出账订单号","合作商交易流水号","交易类型","入账状态","场景名称"(110及以上版本),"完成日期","返回码描述","分账通道","附加数据","备注"(120及以上版本)

参考数据：

60676292,5210002300031036441,出账方_28,82345678911,80001,5210002300020330287,入账方_01,81345678911,70001,2024-11-25,2024-11-25 17:14:00,1000,0,606762924596224112517140000002,606762924596224112517135900001,,2,1,品牌管理费,2024-11-25,操作成功,6,管理费账单号:606762921300124112517032400003,分账备注

参数说明：

参数名称	说明
品牌编号	品牌编号
出账CBK账号	出账CBK账号
出账CBK名称	出账CBK名称
出账扫呗商户号	出账扫呗商户号
出账方三方门店编号	三方门店编号（根据分账数据来源返回对应平台的编号）
入账CBK账号	入账CBK账号
入账CBK名称	入账CBK名称
入账扫呗商户号	入账扫呗商户号
入账方三方门店编号	三方门店编号（根据分账数据来源返回对应平台的编号）
创建日期	创建日期
创建时间	创建时间
交易金额	单位分
手续费	单位分
交易单号	交易单号
CBK出账订单号	对应出账CBK单号
合作商交易流水号	合作商交易流水号
交易类型	交易类型 2转账（包括实时清分）3充值 4提现
入账状态	入账状态:0.未知 1.成功 2.失败 3.处理中 4.待分账 5.分账回退成功 6.撤销 7.未分账 8.分账回退失败 9.担保户待结算'
场景名称	场景名称
完成日期	分账完成日期
返回码描述	返回码描述
分账通道	5富友 6 中信 7平安
附加数据	分账时传递的附加数据
备注	分账时传递的备注信息

8.2日终余额对账单下载

URL：https://example.com/order/account/day/inst_no/key_sign/account_balance_day.txt
Method：GET

请注意：对账单只能获取生产环境数据，测试环境测试数据无法获取。

有对账单下载需求的机构，请先联系项目经理提交开通对账单下载功能邮件申请。
只能下载“对账单下载”功能开启后的对账单，无法下载开启功能之前的对账单，历史账单可通过后台对账单功能进行下载。
接口不能下载当天的对账单，只能下载前一天或者之前的对账单。

若返回以上内容，并不是说密钥不对。提示是未找到对账单文件，请检查是否开启对账单下载功能，或者检查拼接的地址是否正确。

请求路径中example.com只是个示例，请联系对接人员获取真实域名。请求路径中除了/、order、account和.txt，其它全部是变量名，在实际请求中需要替换成变量的值，示例如下：
http://open.lcsw.cn/order/account/20240301/52100277/51ed9c275ca88afbcd05e6e8274677eb/account_balance_20240301.txt
签名算法
MD5加密，utf-8格式转小写,加密后得到key_sign的值，并替换url中的key_sign。
String key_sign = MD5.encode(day=xxxxxx&inst_no=xxxxxx&key=xxxxxx);
签名参数：

参数名称	说明
day	日期，yyyyMMdd，例如：20170208
inst_no	机构号
key	机构号对应的令牌

请求结果中，每一行表示一条交易记录，记录中各参数以,号分隔。各参数含义如下所示：
"CBK账号","品牌编号","分账机构侧动账账号","账户日终余额"
参数解释：

参数名称	说明
CBK账户	分账账号
品牌编号	品牌编号
分账机构侧动账账号	分账机构侧动账账号
账户日终余额	（分）

开发指引

API

一、接入指南

1.1接入前准备

1.2接入域名

二、协议规则

2.1传输方式

2.2提交方式

2.3数据格式

2.4字符编码

2.5判断逻辑

2.6签名要求

2.7签名算法

三、API调用时序图

四、账户 API

4.1 账户开户

4.2 生成签约链接

4.3 查询账户

4.4 注销账户

4.5 修改账户

五、结算卡 API

5.1 绑定结算卡

5.2 发起银行卡激活

5.3 验证银行卡激活

5.4 设置默认结算卡

5.5 解绑结算卡

5.6 修改结算卡

5.7 查询结算卡

六、账户分账API

6.1 账户余额查询

6.2 账户余额分账

6.3 扫呗支付订单分账

6.4 账户提现

6.5 交易详情查询

6.6 提现交易回调通知

6.7 分账交易回调通知

6.8 分账数据列表查询

6.9 分账交易退回

6.10 查询时间段内渠道入金交易明细

6.11 资金冻结

七、归集接口API

7.1 归集账户绑定

7.2 归集账户解绑

7.3 归集账户绑定关系查询

7.4 归集授权结果回调通知

八、对账单文件

8.1分账对账单下载

8.2日终余额对账单下载