技能介绍

解决的核心问题

集成汇付支付的商户进件与用户开户接口时，开发者常面临三类典型问题：首先，支付商户与分账/结算用户的接口边界模糊，误将用户开户接口用于商户进件，或混淆两类接口的字段规则；其次，字段合同复杂，如企业进件中 prov_id/area_id 可能指经营省市、结算卡省市或补充对公账户省市，同名字段在不同父对象下需独立处理，若误合并会导致请求参数错误；最后，SDK使用不规范，例如PHP图片上传若直接调用默认方法会关闭签名验证，或误将Python SDK产物复制到Java/PHP实现，引发签名或路由错误。

工作流程与关键步骤

技能采用分步确认机制，先明确目标实体类型（支付商户/分账用户）、主体类型（企业/个人）及接入阶段，未确认项会触发硬检查点停止生成。接着按场景精确路由参考文档，如企业商户进件需加载企业进件接口页和字段合同，确保字段类型、长度、必填性严格遵循官方冻结规则（如2026-08-10复审后的字段路径数量）。字段回答必须追溯完整路径和约束，避免将查询响应复制为开通请求。对于SDK，常规接口强制使用官方Java/PHP/Python SDK，仅图片上传允许PHP/Python受控降级，且需严格复刻multipart信封、签名和TLS校验。

适用边界与注意事项

支付交易（下单、查单、退款等）需交接给 $huifu-pay-integration 技能，本技能不提供支付终态实现。
用户业务入驻通知已锁定公共规范，但商户审核、电子协议回调的ACK、验签原文等仍标记 [需要官方确认]，禁止外推支付notify_url规则。
敏感信息如私钥、身份证、银行卡号禁止写入日志或示例，Java SDK需在初始化阶段全局设置 BasePay.debug=false，PHP需避免使用官方Demo的DEBUG开启入口。
商户费率查询在三语言SDK中无专属路由，需通过其他接口实现，禁止手写HTTP请求。