shizhongqi/huahuibao_document @ 429ab7b4282e9dac6c064cf9fc8c231106b6fa9e

type: task project: 通用 status: doing year: 2026 module: 支付进件 tags:

task
拉卡拉商户进件 created: 2026-06-01 updated: 2026-06-09 sensitive: false ---

产品： ghsApp 需求概括：

新增进件功能，它是由以下5步构成
    1. 执照信息
    2. 商户信息
    3. 结算信息
    4. 门店信息
    5. 业务信息 
由以上5步把所有信息收集完毕后提交进行进件申请，它们其实是由一个 vue 文件组成，只要用户填写了信息，有切换到“上一步”，进而呈现原有的编辑信息与可修改（即填写完当前步骤的信息后，点击下一步后，随时可以点击上一步对原先信息进行修改）

需要后端支持提交的进件进行保存，请实现对应的后端保存机制（例如：用户填写到一半的进件，下一次用户进入到“收款账户管理”页面时，可以看到并点击继续（或删除））。进件数据使用 mainId 进行关联。如果需要图片资源的保存，请使用项目里的阿里云 OSS 实现，保存时请新建保存目录及按 mainId 加日期的来创建子目录，数据库在要有对应申请的版本数据。

具体要实现的页面与细节：

在 admin/home/me.vue 下的门店设置下新增“收款账户管理”（如图：收款账户管理.png） ---- “收款账户管理”页面的内容是：
1. 获取历史上提交的进件（有不同状态：待审核、已驳回、认证通过）
2. 更换当前门店的收款账户（或停用）
3. 点击“收款银行卡更换”，则进入新页面进行变更银行卡信息，页面实现参照结算信息下的三种情况，下一步按钮变更为提交申请。
4. 审核状态通过商户审核状态查询接口进行获取，然后在本项目数据库中保存起来（有刷新功能，即重新查询）
5. 被驳回的，可以进行修改然后重新提交。
当点击“收款账户管理”页面下的“新增账户”按钮，就进入“执照信息”页面（如图：执照信息（小微）.png、执照信息(小微).png ）
- 商户类别是企业时，使用‘商户进件文件上传接口（对应测试用例是lakalasdk/openapi 包下的 example/jingjian_api/customer-file-upload.php）’上传营业执照（is_ocr 参数传 true， img_type 传 BUSINESS_LICENCE），接着‘OCR结果查询接口（对应测试用例是lakalasdk/openapi 包下的 example/jingjian_api/ocr-result.php）’使用‘商户进件文件上传接口’返回 batch_no 去获取营业执照的信息。然后，就同商户类别是小微一样的流程获取身份证信息。请根据表单信息从‘OCR结果查询接口’返回的数据自动获取对应数据进行填入。
- 商户类别是小微时，则只要法人的身份证信息，那么使用‘商户进件文件上传接口’分别上传身份证正反面，is_ocr 参数传 true，接着‘OCR结果查询接口’使用‘商户进件文件上传接口’返回 batch_no 去分别对应的信息。
填写好“执照信息”点击下一步进入到“商户信息”，此页面继续使用上面 2 中获取的营业执照的信息按说明自动填入，具体细节如下：
- 商户经营名称，使用地级市+商家名称（xhShop表的 merchantName），支持客户在修改
- 商户类型：花店（ 5992）、联系人姓名：石少华、手机号码：15280215347、邮箱： 479439056@qq.com ，此四项不在页面展示出来，但在表单中默认提交。
- 没有说明的按图片中提示默认自动生成，且能让客户修改
第三步：结算信息--分别有三种情况，初始化默认选中‘对私’
- 对私且是法人进件（如图：结算信息（对私）.png），只需上传银行卡照片；使用‘商户进件文件上传接口（对应测试用例是lakalasdk/openapi 包下的 example/jingjian_api/customer-file-upload.php）’上传银行卡照片（is_ocr 参数传 true， img_type 传 BANK_CARD ），接着利用‘OCR结果查询接口（对应测试用例是lakalasdk/openapi 包下的 example/jingjian_api/ocr-result.php）’使用‘商户进件文件上传接口’返回 batch_no 去获取银行卡的信息。
- 对私但是非法人进件（如图：结算信息（对私--非法人）.png），上传银行卡照片及上传身份证照片都是跟先前一样，只是这要多了上传法人授权函（上传的接口使用的都是‘商户进件文件上传接口‘，img_type 传 LETTER_OF_AUTHORIZATION）
- 对公（如图：结算信息（对公）.png），只需上传开户许可证，使用‘商户进件文件上传接口（对应测试用例是lakalasdk/openapi 包下的 example/jingjian_api/customer-file-upload.php）’上传银行卡照片（ img_type 传 OPENING_PERMIT ）
第四步：门店信息主要是上传三张门店相关的照片：门头照、内设照、收银台照，使用‘商户进件文件上传接口（对应测试用例是lakalasdk/openapi 包下的 example/jingjian_api/customer-file-upload.php）’上传，对应的 img_type 分别是 SHOP_OUTSIDE_IMG、CHECKSTAND_IMG、SHOP_INSIDE_IMG；门店名称及门店地址、详细地址从之前的表单带入下，门店联系人与联系手机号需要让用户手动填写下。（其他补充照片先删除掉）

第五步：业务信息这是进件综合所有先前的信息进行提交页面，但还需要在这页面上执行请求以下接口：

1. 执行增终进件接口，分别用 bz_pos = WECHAT_PAY 与 bz_pos = B2B_SYT 请求创建。
2. 结算周期指的是 settle_type 使用 D1；结算类型批的是 settlement_type 使用 AUTOMATIC
3. 执行电子合同接口（生成电子协议）请求--获取 contract_no ，然后传递给’新增商户进件‘的表单。电子合同接口有着此页面需要设置的各费率项，请结合页面进行生成，默认不让用户对费率变更，具体情况如下 ：
    刷卡类
    银联二维码贷记小额优惠  0.38 （零售）  0.33 （批发）
    银联二维码借记费率  0.38 （零售）  0.33 （批发）

    扫码类
    微信费率   0.38（零售）  0.33（批发）
    支付宝费率    0.38（零售）  0.33（批发）

    其他默认配置费率不修改
4. 生成电子协议时，成功请求时会返回 {"code":"000000","msg":"成功","resp_data":{"order_no":"2026061208203432970480","ec_apply_id":1117850953870880768,"result_url":"https://jrt.wsmsd.cn/signature/s/yxkusph1inogzv2f?rdm=1781252444861"}}，result_url 是待签约合同H5链接，要打开它，让客户签约，签约好后，才能点击页面最下边的提交。

所有的接口文档在 "/Users/shishao/dnmp/www/huahuibao.wiki/任务小笔记/26年/06-01：拉卡拉进件" 目录下，请根据需要进行查阅

注意点：

要区分测试与正式环境，因为证书不同。正式环境的证书获取与使用请参考 /Users/shishao/dnmp/www/huahuibao/common/components/lakala/Lakala.php，然后把融入到 lakalasdk/openapi 包中进行使用。
只需关注 lakalasdk/openapi 包中的 openapi/example/jingjian_api 与 openapi/v3 下的代码实现，其它的请忽略。
后期要实现客户文件上传文件在 oss 里备份一份

功能需求.md 7.2 KB History Raw

功能需求.md 7.2 KB

History Raw