LCSW XRMPIC

https://help.lcsw.cn/xrmpic
Admin
LCSW XRMPIC is a payment processing platform that provides APIs and integration tools for merchants...
Tokens:407,289
Snippets:872
Trust Score:3.8
Update:12 hours ago
Show doc for...
Tokens:
Raw
### GET /order/account/day/{inst_no}/{key_sign}/{inst_no}_{day}.txt

Source: https://help.lcsw.cn/xrmpic/tisnldchblgxohfl/kx6s06m64gtaskv5

下载分账对账单文件。该接口用于获取指定日期的分账交易记录，返回文本文件，每行一条记录，字段以逗号分隔。需要签名认证，且仅能下载前一天或更早的数据。

```APIDOC
## GET /order/account/day/{inst_no}/{key_sign}/{inst_no}_{day}.txt

### Description
下载分账对账单文件。该接口用于获取指定日期的分账交易记录，返回文本文件，每行一条记录，字段以逗号分隔。需要签名认证，且仅能下载前一天或更早的数据。

### Method
GET

### Endpoint
https://example.com/order/account/day/{inst_no}/{key_sign}/{inst_no}_{day}.txt

### Parameters
#### Path Parameters
- **inst_no** (string) - Required - 机构号
- **key_sign** (string) - Required - 签名值，通过MD5加密生成
- **day** (string) - Required - 日期，格式yyyyMMdd，例如：20170208

### Request Example
无请求体，参数通过URL路径传递。

### Response
#### Success Response (200)
返回文本文件，每行一条交易记录，字段以逗号分隔。字段顺序如下：
- 品牌编号 (110及以上版本)
- 出账CBK账号或平台账号
- 出账CBK名称或打款账户名称
- 出账扫呗商户号 (110及以上版本)
- 出账方三方门店编号 (120及以上版本)
- 入账CBK账号
- 入账CBK名称
- 入账扫呗商户号 (110及以上版本)
- 入账方三方门店编号 (110及以上版本)
- 创建日期
- 创建时间
- 交易金额(分)
- 手续费(分)
- 交易单号
- CBK出账订单号
- 合作商交易流水号
- 交易类型
- 入账状态
- 场景名称 (110及以上版本)
- 完成日期
- 返回码描述
- 分账通道
- 附加数据
- 备注 (120及以上版本)

#### Response Example
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,分账备注

### Error Handling
若返回内容提示未找到对账单文件，请检查是否开启对账单下载功能，或检查拼接的地址是否正确。
```

--------------------------------

### GET /order/account/day/{inst_no}/{key_sign}/account_balance_{day}.txt

Source: https://help.lcsw.cn/xrmpic/tisnldchblgxohfl/kx6s06m64gtaskv5

下载日终余额对账单文件。该接口用于获取指定日期的账户日终余额信息，返回文本文件，每行一条记录，字段以逗号分隔。需要签名认证，且仅能下载前一天或更早的数据。

```APIDOC
## GET /order/account/day/{inst_no}/{key_sign}/account_balance_{day}.txt

### Description
下载日终余额对账单文件。该接口用于获取指定日期的账户日终余额信息，返回文本文件，每行一条记录，字段以逗号分隔。需要签名认证，且仅能下载前一天或更早的数据。

### Method
GET

### Endpoint
https://example.com/order/account/day/{inst_no}/{key_sign}/account_balance_{day}.txt

### Parameters
#### Path Parameters
- **inst_no** (string) - Required - 机构号
- **key_sign** (string) - Required - 签名值，通过MD5加密生成
- **day** (string) - Required - 日期，格式yyyyMMdd，例如：20170208

### Request Example
无请求体，参数通过URL路径传递。

### Response
#### Success Response (200)
返回文本文件，每行一条记录，字段以逗号分隔。字段顺序如下：
- CBK账号
- 品牌编号
- 分账机构侧动账账号
- 账户日终余额

#### Response Example
示例数据未提供。

### Error Handling
若返回内容提示未找到对账单文件，请检查是否开启对账单下载功能，或检查拼接的地址是否正确。
```

--------------------------------

### 创建收单商户

Source: https://help.lcsw.cn/xrmpic/tisnldchblgxohfl/wakc5p

Creates a new acquiring merchant with the provided onboarding information. This operation requires various merchant details and supporting documents.

```APIDOC
## 创建收单商户

### Description
创建新的收单商户，需要提供商户入网资料，包括银行账户信息、商户性质、清算类型、费率代码以及相关证明材料。

### Method
POST

### Endpoint
（未提供具体端点，请参考源文档）

### Parameters
#### Request Body
- **bank_name** (String, 50) - Required - 入账银行卡开户支行，请参考银行编号表
- **bank_no** (String, 25) - Required - 开户支行联行号，请参考银行编号表
- **company_account_name** (String, 100) - Optional - 对公户结算账户开户名
- **company_account_no** (String, 25) - Optional - 对公户结算账户开户号
- **company_bank_name** (String, 50) - Optional - 对公户结算账户开户支行，请参考银行编号表
- **company_bank_no** (String, 25) - Optional - 对公户结算账户开户支行联行号，请参考银行编号表
- **settle_type** (String, 2) - Required - 清算类型：`1`自动结算；`2`手动结算
- **rate_code** (String, 10) - Optional - 支付费率代码，默认千分之六，取值范围见支付费率代码表
- **merchant_type** (String, 1) - Optional - 商户性质，`1`普通商户，`2`二级商户，默认为1，只有需要挂商户集时才传`2`
- **parent_no** (String, 15) - Optional - 所属商户集商户号（9开头），商户性质为二级商户时必传
- **img_logo** (String, 255) - Required - 商户门头照片
- **img_indoor** (String, 255) - Required - 内部前台照片
- **img_contract** (String, 255) - Required - 店内环境照片
- **img_other** (String, 255) - Optional - 其他补充证明材料照片
- **img_idcard_holding** (String, 255) - Optional - 本人手持身份证照片
- **img_open_permits** (String, 255) - Optional - 开户许可证照片或对公账户信息（加银行业务章）
- **img_org_code** (String, 255) - Optional - 组织机构代码证照片
- **img_tax_reg** (String, 255) - Optional - 税务登记证照片
- **img_unincorporated** (String, 255) - Optional - 入账非法人证明照片
- **img_private_idcard_a** (String, 255) - Optional - 对私账户身份证正面照片（人像面）
- **img_private_idcard_b** (String, 255) - Optional - 对私账户身份证反面照片（国徽面）
- **img_standard_protocol** (String, 255) - Optional - 商户总分店关系证明
- **img_val_add_protocol** (String, 255) - Optional - 商户增值协议照片
- **img_sub_account_promiss** (String, 255) - Optional - 分账承诺函照片
- **img_cashier** (String, 255) - Optional - 微信支付物料照片
- **img_3rd_part** (String, 255) - Optional - 第三方平台截图
- **img_alicashier** (String, 255) - Optional - 支付宝支付物料照片
- **img_salesman_logo** (String, 255) - Optional - 业务员门头合照
- **img_union_materiel** (String, 255) - Optional - 云闪付营销物料布放照片
- **remark** (String, 50) - Optional - 入网备注（文字描述入网特殊情况说明）
- **notify_url** (String, 255) - Optional - 审核状态通知地址
- **key_sign** (String, 32) - Required - 签名检验串，点击查看签名算法

### Request Example
（未提供请求示例）

### Response
#### Success Response
（未提供响应信息）

#### Response Example
（未提供响应示例）

### Error Handling
（未提供错误处理信息）
```

--------------------------------

### GET /open/wap/110/pay

Source: https://help.lcsw.cn/xrmpic/tisnldchblgxohfl/rinsc3

该接口用于生成WAP支付链接，通过拼接参数构造完整的支付URL。用户可在微信、支付宝等支付应用内访问该链接完成支付。

```APIDOC
## GET /open/wap/110/pay

### Description
该接口用于生成WAP支付链接，通过拼接参数构造完整的支付URL。用户可在微信、支付宝等支付应用内访问该链接完成支付。

### Method
GET

### Endpoint
/open/wap/110/pay

### Parameters
#### Query Parameters
- **merchant_no** (String) - Required - 商户号，长度15
- **terminal_id** (String) - Required - 终端号，长度8
- **company_flag** (String) - Optional - 是否使用产业付产品：0：否（默认0），1：产业付和普通支付混合，2：只能产业付（即pay_type只能使用180或者190）
- **pay_type** (String) - Optional - 支付类型：000 自动判断（不填默认000），010 微信，020 支付宝，110 银联云闪付，180 微企付，190 支付宝商转。注意：此字段不参与签名
- **terminal_trace** (String) - Required - 终端流水号，可填写商户系统的业务订单号（若repeated_trace设置1，多次请求时不可使用同一个值），长度6至32
- **terminal_time** (String) - Required - 终端交易时间，格式yyyyMMddHHmmss，长度14
- **total_fee** (String) - Required - 金额，单位分，长度12
- **order_body** (String) - Optional - 订单描述，显示在消费者账单详情页面的商品信息。禁止使用+，空格，/，?，%，#，&，=，【这几类特殊符号，中文需要urlencode，签名拼接不需要urlencode，长度128
- **notify_url** (String) - Optional - 支付结果接收地址，通知数据请查看4.10回调通知接口，支付宝商转不支持回调。注：该字段若不传递，需要通过4.5支付查询接口确认订单支付状态（get请求拼接需要urlencode，签名拼接不需要urlencode），长度255
- **auto_pay** (String) - Optional - 扫码后是否自动生成订单：1：自动拉起支付并生成订单，0或不传：手动点击页面支付按钮后生成订单，长度1
- **attach** (String) - Optional - 附加数据，原样返回，中文需要urlencode，签名拼接不需要urlencode，长度128
- **repeated_trace** (String) - Required - 是否允许重复扫码或支付：0或不传:允许重复扫码或支付，1:不允许重复扫码或支付，2:允许terminal_trace值不变但terminal_time值变化时多次请求，3:允许terminal_trace+terminal_time只支付成功一次，失败情况下可重复，长度2
- **key_sign** (String) - Required - 签名验证串，长度32

### Request Example
http://接口域名/open/wap/110/pay?auto_pay=0&merchant_no=&notify_url=&其它参数=key_sign=签名验证串

### Response
#### Success Response
该接口无返回参数，拼接后的链接可转换成二维码，或者在页面内直接访问。

#### Response Example
无返回参数。
```

--------------------------------

### GET /pos/200/preauth/preAuthQrH5pay

Source: https://help.lcsw.cn/xrmpic/tisnldchblgxohfl/ui1lup

预授权聚合码接口，用于生成预授权二维码，支持GET请求。

```APIDOC
## GET /pos/200/preauth/preAuthQrH5pay

### Description
预授权聚合码接口，用于生成预授权二维码。

### Method
GET

### Endpoint
/pos/200/preauth/preAuthQrH5pay

### Parameters
#### Query Parameters
- **merchant_no** (String) - Required - 商户号，长度15
- **terminal_id** (String) - Required - 终端号，长度8
- **terminal_trace** (String) - Required - 终端流水号，填写商户系统的订单号，长度32
- **terminal_time** (String) - Required - 终端交易时间，格式yyyyMMddHHmmss，长度14
- **total_fee** (String) - Required - 金额，单位分，长度12
- **order_body** (String) - Optional - 订单描述，长度128
- **front_url** (String) - Optional - 前端回调地址，必须urlencode（get请求拼接需要urlencode，签名拼接不需要urlencode），不填则支付成功后不跳转，长度256
- **attach** (String) - Optional - 附加数据，原样返回，长度128
- **key_sign** (String) - Required - 签名验证串，长度32

### Response
#### Success Response (200)
- **return_code** (String) - 响应码：01成功，02失败，响应码仅代表通信状态，不代表业务结果
- **return_msg** (String) - 返回信息提示
- **result_code** (String) - 业务结果：01成功，02失败
- **pay_type** (String) - 请求类型，010微信，020支付宝
- **merchant_name** (String) - 商户名称
- **merchant_no** (String) - 商户号
- **terminal_id** (String) - 终端号
- **terminal_trace** (String) - 终端流水号，商户系统的订单号，扫呗系统原样返回
- **terminal_time** (String) - 终端交易时间
- **total_fee** (String) - 金额，单位分
- **out_trade_no** (String) - 利楚唯一订单号
- **appId** (String) - 微信支付返回字段，公众号id
- **timeStamp** (String) - 微信返回字段，时间戳
- **nonceStr** (String) - 微信返回字段，签名方式
- **package_str** (String) - 微信支付返回字段，订单详情扩展字符串
- **signType** (String) - 微信支付返回字段，签名方式
- **paySign** (String) - 微信支付返回字段，签名
- **ali_trade_no** (String) - 支付宝JSAPI支付返回字段用于调起支付宝JSAPI
- **key_sign** (String) - 签名验证串
```

--------------------------------

### Maven安装SDK到本地仓库并添加pom依赖

Source: https://help.lcsw.cn/xrmpic/q6imdiojes7iq5y1/qg52lx

使用mvn install:install-file命令将jar包安装到本地仓库，注意修改-Dfile路径和-Dversion版本号。安装后需在pom.xml中添加dependency依赖，version需与安装版本一致。

```bash
//请自行根据电脑系统类型修改-Dfile指定的jar包所在路径格式，注意将命令中的-Dversion指定的jar包版本换成所下载的版本
mvn install:install-file -Dfile=D:\saobei-open-sdk-1.2.1.jar -DgroupId=com.lcsw.opensdk -DartifactId=saobei-open-sdk -Dversion=1.2.1 -Dpackaging=jar
//安装到本地仓库后，在pom中添加如下引入，注意version修改成所安装的版本号
<dependency>
    <groupId>com.lcsw.opensdk</groupId>
    <artifactId>saobei-open-sdk</artifactId>
    <version>1.2.1</version>
</dependency>
```

--------------------------------

### POST coupon/marketing/createpaystock

Source: https://help.lcsw.cn/xrmpic/tisnldchblgxohfl/yp6frh

新增支付券接口，用于创建支付券批次。需要提供批次信息、发放规则、样式设置、核销规则和营销资金预算等参数。

```APIDOC
## POST coupon/marketing/createpaystock

### Description
新增支付券接口，用于创建支付券批次。需要提供批次信息、发放规则、样式设置、核销规则和营销资金预算等参数。

### Method
POST

### Endpoint
coupon/marketing/createpaystock

### Parameters
#### Request Body
- **api_ver** (String) - Required - 版本号，默认100
- **inst_no** (String) - Required - 机构编号，扫呗分配
- **trace_no** (String) - Required - 请求流水号，不带“-”的uuid,商户侧需保证唯一性
- **merchant_no** (String) - Required - 扫呗商户号
- **channel** (String) - Required - 渠道类型WECHAT：微信 ALIPAY：支付宝 ,多个以逗号分隔
- **stock_type** (String) - Required - 批次类型，仅支持： NORMAL：固定面额满减券批次
- **stock_name** (String) - Required - 券名称
- **available_begin_time** (String) - Required - 可用时间-开始时间yyyy-MM-dd HH:mm:ss
- **available_end_time** (String) - Required - 可用时间-结束时间yyyy-MM-dd HH:mm:ss
- **stock_use_rule** (String) - Required - 发放规则
- **pattern_info** (String) - Required - 样式设置
- **coupon_use_rule** (String) - Required - 核销规则
- **budget_info** (String) - Required - 营销资金预算
- **notify_url** (String) - Optional - 接收用户核券通知地址
- **key_sign** (String) - Required - 签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换

#### stock_use_rule (发放规则)
- **max_coupons** (String) - Required - 最大发券数 校验规则： 1、发放总个数最少5个 2、发放总个数最多1000万个
- **max_amount** (String) - Conditional - (微信必传,支付宝不传)最大发券预算，当营销经费no_cash选择预充值false时，激活批次时会从制券商户的余额中扣除预算，请保证账户金额充足，单位：分 max_amount需要等于coupon_amount（面额） * max_coupons（发放总上限） 校验规则：批次总预算最多1000万元
- **max_coupons_per_user** (String) - Required - 单个用户可领个数

#### pattern_info (样式设置)
- **description** (String) - Required - 使用说明
- **merchant_logo** (String) - Conditional - (微信时生效)商户logo url
- **merchant_name** (String) - Optional - 品牌名称
- **background_color** (String) - Conditional - (微信时生效)券的背景颜色，可设置10种颜色，色值请参考[卡券背景颜色图](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter9_1_1.shtml#menu1)。颜色取值为颜色图中的颜色名称。可选枚举字段不用则不传，不可以传空值
- **coupon_image** (String) - Optional - 微信券详情图片 url,支付宝传resource_id
- **ali_coupon_image** (String) - Conditional - (支付宝时生效)券详情页封面图，支付宝resource_id，resource_id调用[2.3 上传营销图片](https://lcsw.yuque.com/eq5uy2/sqzg15/baq4t4/edit#nmDgb)获取，限制:1.指定可核销商品(available_items)时必传
- **ali_voucher_detail_images** (String) - Conditional - (支付宝时生效)支付宝券详细图列表，支付宝resource_id，多个resource_id以逗号分隔 ，resource_id调用[2.3 上传营销图片](https://lcsw.yuque.com/eq5uy2/sqzg15/baq4t4/edit#nmDgb)获取，限制：1.ali_coupon_image填入，该值才能填入； 2.最多3张；
- **customer_service_mobile** (String) - Conditional - (支付宝必传)商家客服电话，会展示在支付宝卡包券详情页。

#### coupon_use_rule (核销规则)
- **coupon_amount** (String) - Required - 面额，单位：分。
- **transaction_minimum** (String) - Required - 使用券金额门槛，单位：分。 若指定可核销商品编码，门槛则为可核销商品部分的消费金额，而不是订单的消费金额。
- **goods_tag** (array) - Conditional - (微信时生效)订单优惠标记，按json格式。 商户下单时需要传入相同的标记(goods_tag)，用户同时符合其他规则才能享受优惠 校验规则： 1、最多允许录入50个 2、每个订单优惠标记支持字母/数字/下划线，不超过128个UTF8字符。
- **available_items** (array) - Optional - (限制: 1、available_items与<br>unavailable_items只能二选一或者同时为空)<br>可核销商品编码,包含指定SKU商品编码的交易才可核销/使用代金券：活动商户在交易下单时，需传入用户购买的所有SKU商品编码，当命中代金券中设置的商品编码时可享受优惠。 校验规则： 1、单个商品编码的字符长度为【1，128】 2、条目个数限制为【1，50】<br>示例值：['123321','456654']
- **unavailable_items** (array) - Optional - (限制: 1、available_items与<br>unavailable_items只能二选一或者同时为空)包含指定SKU商品编码的交易不可核销/使用代金券。 校验规则： 1、单个商品编码的字符长度为【1，128】 2、条目个数限制为【1，50】 示例值：['123321','456654']
- **ali_available_merchants** (Object) - Optional - 优惠券可核销的直连商户PID,优惠券可核销的间连商户SMID
  - **available_pids** (array) - Conditional - 优惠券可核销的直连商户PID 限制： 1、available_pids和available_smids至少二选一。
  - **available_smids** (array) - Conditional - 优惠券可核销的间连商户SMID 限制： 1、available_pids和available_smids至少二选一。
- **wx_available_merchants** (array) - Optional - 微信可核销商户号

#### budget_info (营销资金预算)
- **budget_type** (String) - Required - 营销资金预算类型 枚举值: NO_CASH 免充值 RECHARGE 预充值
- **max_amount** (String) - Conditional - (微信必传,支付宝不传)最大发券预算，当营销经费no_cash选择预充值false时，激活批次时会从制券商户的余额中扣除预算，请保证账户金额充足，单位：分 max_amount需要等于coupon_amount（面额） * max_coupons（发放总上限） 校验规则：批次总预算最多1000万元
- **amount** (String) - Conditional - (支付宝预充值必传)营销资金预算,单位元。 总预算=优惠金额*总发券张数
- **logon_id** (String) - Conditional - (支付宝预充值必传)出资的支付宝登录账号 限制: 1、登录账号和用户ID必须且只能二选一<br>[username@gmail.com](mailto:username@gmail.com)
- **user_id** (String) - Conditional - (支付宝预充值必传)出资的支付宝用户id<br>2088512417841101 限制: 1、登录账号和用户ID必须且只能二选一

### Response
#### Success Response (200)
- **return_code** (String) - 响应码 01:成功 02:失败。响应码仅代表通信状态，不代表业务结果
- **return_msg** (String) - 返回信息提示
- **key_sign** (String) - 签名检验串,非空参数字典排序+令牌（机构令牌名称为key），32位md5加密转换
- **result_code** (String) - 业务结果 01:成功 02:失败
- **trace_no** (String) - 原请求流水号
- **merchant_no** (String) - 扫呗商户号
- **stock_no** (String) - 券批次编号,result_code为01时返回

```

--------------------------------

### POST account/open/createaccount

Source: https://help.lcsw.cn/xrmpic/tisnldchblgxohfl/ua4c1l

该接口用于商户虚拟账户开户，支持使用扫呗商户号或上传商户资料进行开户。请求参数包括api_ver、inst_no、brand_no、trace_no等，返回参数包括account_no、account_core_no等。

```APIDOC
## [POST] account/open/createaccount

### Description
该接口用于商户虚拟账户开户，支持使用扫呗商户号或上传商户资料进行开户。可用于账户之间的资金划拨。

### Method
POST

### Endpoint
- 测试域名: http://test.lcsw.cn:8045/lcsw_mch
- 生产域名: https://mch.lcsw.cn/lcsw
- API: account/open/createaccount

### Parameters
#### Path Parameters
无

#### Query Parameters
无

#### Request Body
- **api_ver** (String) - Required - 接口内业务逻辑兼容号，固定值100
- **inst_no** (String) - Required - 机构编号，扫呗分配
- **brand_no** (String) - Required - 品牌编号
- **trace_no** (String) - Required - 请求流水号，每次请求不可重复
- **merchant_no** (String) - Optional - 扫呗商户号(传扫呗商户号,则基于该商户的主体资料开户,cust_type和cust_info不需要传)
- **account_temp** (String) - Optional - 要复用资料开户的CBK账户（传了该字段后，就会使用该CBK账户的资料再次开户，不需要传详细的商户资料）
- **cust_type** (String) - Optional - 开户类型 1企业，2个体工商户，3个人(小微商户)(不传商户号时,此字段必填)
- **cust_info** (String) - Optional - 开户信息，不传merchant_no时，需要使用资料开户（JSON字符串,需要转义）
- **identity_id** (String) - Required - 账户类型id，值见下方说明。
- **bank_account_type** (String) - Optional - 银行账户类型：0普通账户 1产业结算通账户（平安分账通道使用）
- **key_sign** (String) - Required - 签名检验串，[点击查看签名算法](http://help.lcsw.cn/xrmpic/q6imdiojes7iq5y1/qg52lx#title-node7)

#### cust_info字段说明
- **license_no** (String) - Optional - 营业执照号码,与企业证件类型对应的企业注册号(企业与个体户必传)
- **license_name** (String) - Optional - 工商注册名称（与注册工商信息时一致）(企业与个体户必传)
- **license_expire** (String) - Optional - 营业执照到期日（格式YYYY-MM-DD），如果证件到期日期为“长期”，则传：“2999-12-31”(企业与个体户必传)
- **id_card_type** (int) - Optional - 身份证件类型 0身份证 1香港通行证 2澳门通行证 3台湾通行证，不传默认0
- **legal_name** (String) - Optional - 法人姓名,用于实名认证企业的法人姓名（与注册工商信息时一致）(企业与个体户必传)
- **legal_no** (String) - Optional - 法人证件号码,用于实名认证企业的法人身份证号码（与注册工商信息时一致）(企业与个体户必传)
- **id_card_start_date** (String) - Required - 证件发证日期 yyyy-MM-dd（企业与个体户传法人，小微传负责人）
- **id_card_end_date** (String) - Optional - 证件到期日期 yyyy-MM-dd,如果证件到期日期为“长期”，则传：“2999-12-31”（企业与个体户传法人，小微传负责人）
- **legal_phone** (String) - Optional - 法人联系电话(企业与个体户必传)
- **account_type** (String) - Required - 结算卡业务类型 枚举值：1：对公2：对私
- **account_name** (String) - Required - 结算卡开户姓名,绑定卡是对公卡，户名是企业名称，如果对私，户名是法人姓名（同一套资料开多个户时，需要设置merchant_name，且merchant_name名称不能重复）
- **merchant_name** (String) - Required - CBK账户名称或者简称。当account_name长度大于20时必传该字段，否则会因为account_name过长报错；❗**注意**：同一品牌下账户名称重复，或使用account_temp字段进行账户资料复用开户时必传，否则会报CBK名称已存在（一套资料创建多个账户时，可在CBK账户名称后增加数字或者其它简称）
- **settlement_type** (String) - Optional - 结算类型:1.法人结算 2.非法人结算（使用account_temp字段进行账户资料复用开户时必传）
- **account_cardno** (String) - Required - 结算银行卡号
- **account_phone** (String) - Required - 结算卡银行预留手机号。
- **account_idnum** (String) - Required - 结算卡身份证号
- **bank_name** (String) - Required - 开户支行名称
- **bank_no** (String) - Required - 支行编号。[银行编号表下载](https://oss.lcsw.cn/bank_new.xlsx).
- **province_code** (String) - Required - 银联省code [省市区编号表下载](https://oss.lcsw.cn/area_code_new.xlsx)
- **city_code** (String) - Required - 银联市code
- **county_code** (String) - Optional - 银联区code
- **image_business_license** (String) - Optional - 营业执照图片url
- **img_idcard_front** (String) - Optional - 身份证正面照url
- **img_idcard_back** (String) - Optional - 身份证背面照url

#### identity_id账户类型id可用值
- **6** - 入账方 - 仅能入账和提现，不能分账
- **8** - 门店 - 能入账、分账、提现。优先使用该类型
- **16** - 归集商户 - 富友归集场景可用，其它分账通道不可用。不能出账、不能入账，资金仅能被归集到总户。
- 其他类型需联系运营同事获取对应账户类型id

### Request Example
{
  "api_ver": "100",
  "inst_no": "12345678",
  "brand_no": "12345678",
  "trace_no": "12345678901234567890123456789012",
  "merchant_no": "123456789012345",
  "identity_id": "8",
  "key_sign": "签名串"
}

### Response
#### Success Response (200)
- **return_code** (String) - 业务响应码，01成功 02失败
- **return_msg** (String) - 业务响应描述
- **key_sign** (String) - 签名检验串
- **result_code** (String) - 业务处理响应码，01成功 02失败
- **trace_no** (String) - 原请求流水号
- **account_no** (String) - 扫呗CBK账户账号用于分账,提现,查询余额等接口交互
- **account_core_no** (String) - 通道子账户
- **cust_info** (String) - 返回信息,JSON字符串,需要转义

#### Response Example
{
  "return_code": "01",
  "return_msg": "成功",
  "key_sign": "签名串",
  "result_code": "01",
  "trace_no": "12345678901234567890123456789012",
  "account_no": "1234567890123456789",
  "account_core_no": "1234567890123456789",
  "cust_info": "{}"
}
```
Tokens:
Raw