> ## Documentation Index > Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt > Use this file to discover all available pages before exploring further. # 商户进件 ## 公共响应参数 | 字段 | 是否必选 | 字段类型 | 字段说明 | | --------- | ---- | ------- | ---- | | `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 |