商户进件 - 星富通科技有限公司

公共响应参数

字段	是否必选	字段类型	字段说明
`code`	是	String	错误码
`message`	是	String	错误信息
`result`	是	Boolean	返回结果
`data`	是	String	业务参数

图片上传接口

请求地址: https://xlink.91xft.cn/sys/image/save 请求参数

字段	是否必选	字段类型	字段说明
`pic_file`	是	File	图片，单张大小限制在1M以内

响应参数

字段	是否必选	字段类型	字段说明
`failure_code`	是	String	错误码
`failure_msg`	是	String	错误信息
`pic`	是	String	图片url

商户进件接口

请求地址: https://xlink.91xft.cn/merchant/signin/merchant 请求参数

字段	是否必选	字段类型	字段说明
`agent_code`	是	String	所属渠道编号，由系统分配
`app_id`	是	String	app_id, 由系统统一分配
`out_trade_no`	否	String	请求标识，确保唯一
`full_name`	是	String	商户全称
`name`	是	String	商户简称
`social_credit_code`	是	String	营业执照编号
`province_code`	否	String	省份编号
`city_code`	否	String	城市编号
`district_code`	否	String	区/县编号
`address`	是	String	详细地址
`contact_name`	是	String	联系人姓名
`contact_mobile`	是	String	联系人手机
`contact_email`	是	String	联系人邮箱
`contact_certification_type`	是	String	联系人证件类型，默认01，身份证
`contact_certification_no`	是	String	联系人证件号码
`sales_man`	否	String	拓展业务员（名字）
`custom_manager`	否	String	所属客户经理（名字）
`mcc`	是	String	经营类目
`legal_name`	是	String	法人姓名
`legal_certification_no`	是	String	法人身份证
`legal_type`	是	String	法人证件类型，默认01，身份证
`tel`	是	String	客服电话
`tobacco_license`	否	String	烟草许可证
`merchant_types`	是	String	商户类型 1:个体 2:企业
`bank_account`	是	String	结算信息（字符串）, 具体值请参看结算信息对象
`merchant_photo`	是	String	证件照信息（字符串）, 具体值请参看证件照信息对象
`institution_products`	是	String	支付类型及费率（字符串）
`notify`	否	String	商户进件通知地址
`trade_notify`	否	String	交易通知地址
`remark`	否	String	备注，预留，不必填
`social_credit_start`	否	String	营业执照编号有效期开始日期
`social_credit_end`	否	String	营业执照编号有效期结束日期
`legal_certification_start`	否	String	法人证件有效期开始日期
`legal_certification_end`	否	String	法人证件有效期结束日期
`sign`	是	String	签名值
`sign_type`	是	String	签名类型

bank_account（结算信息对象，JSON字符串）

字段	是否必选	字段类型	字段说明
`account_types`	是	String	结算账号标志 0-对公 1-对私
`bank_account_no`	是	String	银行账号
`bank_name`	是	String	开户人名称
`cycle`	是	String	结算周期 00-T+1 01-D+1
`bank_code`	是	String	联合行号

merchant_photo（证件照信息对象，JSON字符串）

字段	是否必选	字段类型	字段说明
`license_code_photo`	是	String	营业执照
`bank_card_front_photo`	否	String	银行卡正面
`open_account_license_photo`	否	String	结算银行开户许可证
`legal_certification_front_photo`	是	String	负责人身份证正面
`legal_certification_back_photo`	是	String	负责人身份证反面
`group_photo`	否	String	工作人员与商户负责人合影
`indoor_photo`	否	String	门店内景照
`door_head_photo`	否	String	门头照
`protocol_photo`	否	String	商户协议
`bank_card_license_photo`	否	String	结算账户指定书
`settle_certification_front_photo`	否	String	结算人身份证正面照片
`settle_certification_back_photo`	否	String	结算人身份证反面照片
`tobacco_license_photo`	否	String	烟草许可证照片
`contact_photo`	否	String	联系人身份证正面照片
`contact_back_photo`	否	String	联系人身份证反面照片
`additional_photo`	否	String	补充资料照片

additional_photo（补充资料照片，最多5张，一个json数组字符串）

字段	是否必选	字段类型	字段说明
`name`	是	String	补充资料图片名称
`url`	是	String	补充资料图片url

institutionProduct（支付类型对象，JSON字符串）

字段	是否必选	字段类型	字段说明
`institution_code`	是	String	支付通道编号
`institution_product_code`	是	String	支付产品编号
`rate`	是	String	费率（万分之）

响应参数

字段	是否必选	字段类型	字段说明
`failure_code`	是	String	错误码
`failure_msg`	是	String	错误信息
`merchant_code`	否	String	商户编号
`store_code`	否	String	门店编号
`sign`	是	String	签名值
`sign_type`	是	String	签名类型
`out_trade_no`	否	String	请求标识，请求时传了值则有值，否则为空

门店进件接口

请求地址: https://xlink.91xft.cn/merchant/signin/store 请求参数

字段	是否必选	字段类型	字段说明
`agent_code`	是	String	所属渠道编号，由系统分配
`merchant_code`	是	String	所属商户编号
`app_id`	是	String	app_id, 由系统统一分配
`out_trade_no`	否	String	请求标识，确保唯一
`full_name`	是	String	门店全称
`name`	是	String	门店简称
`province_code`	否	String	省份编号
`city_code`	否	String	城市编号
`district_code`	否	String	区/县编号
`address`	是	String	详细地址
`contact_name`	是	String	联系人姓名
`contact_mobile`	是	String	联系人手机
`contact_email`	是	String	联系人邮箱
`contact_certification_type`	是	String	联系人证件类型，默认01，身份证
`contact_certification_no`	是	String	联系人证件号码
`tel`	是	String	客服电话
`sign`	是	String	签名值
`sign_type`	是	String	签名类型

响应参数

字段	是否必选	字段类型	字段说明
`failure_code`	是	String	错误码
`failure_msg`	是	String	错误信息
`merchant_code`	否	String	商户编号
`store_code`	否	String	门店编号
`sign`	是	String	签名值
`sign_type`	是	String	签名类型
`out_trade_no`	否	String	请求标识

修改门店信息

请求地址: https://xlink.91xft.cn/merchant/signin/update/store 请参考门店进件接口使用。必选: agent_code, app_id, store_code, sign, sign_type；可选: name, contact_name, contact_mobile, contact_email, contact_certification_type, contact_certification_no, address, tel, out_trade_no。响应额外返回 state (1：成功 2：失败)。

进件查询接口

请求地址: https://xlink.91xft.cn/merchant/signin/query 请求参数

字段	是否必选	字段类型	字段说明
`agent_code`	是	String	所属渠道编号
`app_id`	是	String	app_id
`out_trade_no`	否	String	请求标识
`merchant_code`	是	String	商户编号
`sign`	是	String	签名值
`sign_type`	是	String	签名类型

响应参数

字段	是否必选	字段类型	字段说明
`failure_code`	是	String	错误码
`failure_msg`	是	String	错误信息
`merchant_code`	是	String	商户编号
`state`	是	String	0：未审核 1：审核通过 2：审核不通过 3：进件完成
`name`	是	String	商户名称
`sign`	是	String	签名值
`sign_type`	是	String	签名类型
`out_trade_no`	否	String	请求标识

审核通知

通知参数不需要加入统一响应参数 data 中，只需要直接接收以下参数

字段	是否必选	字段类型	字段说明
`failure_code`	是	String	错误码
`failure_msg`	是	String	错误信息
`merchant_code`	是	String	商户编号
`state`	是	String	0：未审核 1：审核通过 2：审核不通过 4：进件成功 5：进件失败 6：进件中
`tobacco_license`	否	String	烟草许可证
`sign`	是	String	签名值
`sign_type`	是	String	签名类型

添加授权目录

请求地址: https://xlink.91xft.cn/merchant/signin/add/auth 请求参数包含: agent_code, app_id, out_trade_no(否), merchant_code, auth_dir, sign, sign_type。响应返回 state (1：成功 2：失败)。

添加APPID

请求地址: https://xlink.91xft.cn/merchant/signin/add/appid 请求参数中 wx_app_id 为微信appId。响应返回 state (1：成功 2：失败)。

添加关注APPID

请求地址: https://xlink.91xft.cn/merchant/signin/add/subscribe/appid 请求参数中 wx_subscribe_app_id 为微信appId。响应返回 state (1：成功 2：失败)。

修改基础信息

请求地址: https://xlink.91xft.cn/merchant/signin/update/detail 请求参数包含: agent_code, app_id, merchant_code, name, contact_name, contact_mobile, contact_email, contact_certification_type, contact_certification_no, sales_man, custom_manager, tel, sign, sign_type。

修改结算信息

请求地址: https://xlink.91xft.cn/merchant/signin/update/bank/account 可修改字段：account_types, bank_account_no, bank_name, cycle, bank_code。

修改商户图片信息

请求地址: https://xlink.91xft.cn/merchant/signin/update/pic 可修改字段参考上面 merchant_photo 各项。

修改费率信息

请求地址: https://xlink.91xft.cn/merchant/signin/update/rate 请求参数: institution_code, institution_product_code, rate。

查询清分状态

请求地址: https://xlink.91xft.cn/merchant/signin/settle/query 请求参数：agent_code, app_id, out_trade_no(否), merchant_code, date (如：20190101), sign, sign_type。 响应参数

字段	是否必选	字段类型	字段说明
`merchant_code`	是	String	商户编号
`name`	是	String	商户名称
`institutionList`	是	String	上游通道清分状态（一个字符串json数组）
`sign`	是	String	签名值
`sign_type`	是	String	签名类型

上游渠道清分状态字段列表

字段	是否必选	字段类型	字段说明
`institution_code`	是	String	清分渠道
`state`	是	String	清分状态 0：处理中 1：清分成功 2：清分失败
`failure_code`	否	String	错误码
`failure_msg`	否	String	错误信息
`field1`	否	String	预留字段

查询固定二维码列表

请求地址: https://xlink.91xft.cn/transaction/unify/qrcode/query 请求参数：app_id, merchant_code, store_code(否), operator_id(否), sign。 响应参数

字段	是否必选	字段类型	字段说明
`qr_codes`	是	String	二维码信息列表（json串）
`sign`	是	String	签名值

二维码信息列表

字段	是否必选	字段类型	字段说明
`qr_code_url`	是	String	二维码内容
`qr_code_img`	是	String	二维码图片地址
`store_code`	否	String	二维码所属门店编号
`merchant_code`	是	String	二维码所属商户编号
`operator_id`	否	String	二维码所属收银员id

Documentation Index

​公共响应参数

​图片上传接口

​商户进件接口

​bank_account（结算信息对象，JSON字符串）

​merchant_photo（证件照信息对象，JSON字符串）

​additional_photo（补充资料照片，最多5张，一个json数组字符串）

​institutionProduct（支付类型对象，JSON字符串）

​门店进件接口

​修改门店信息

​进件查询接口

​审核通知

​添加授权目录

​添加APPID

​添加关注APPID

​修改基础信息

​修改结算信息

​修改商户图片信息

​修改费率信息

​查询清分状态

​查询固定二维码列表

公共响应参数

图片上传接口

商户进件接口

bank_account（结算信息对象，JSON字符串）

merchant_photo（证件照信息对象，JSON字符串）

additional_photo（补充资料照片，最多5张，一个json数组字符串）

institutionProduct（支付类型对象，JSON字符串）

门店进件接口

修改门店信息

进件查询接口

审核通知

添加授权目录

添加APPID

添加关注APPID

修改基础信息

修改结算信息

修改商户图片信息

修改费率信息

查询清分状态

查询固定二维码列表