Ping++ 合规分账集成

解决什么问题

在 Java Spring Boot 项目中接入 Ping++ 合规分账，最怕两类问题：一类是凭直觉写 SDK 调用，类名或方法签名对不上当前 jar 版本，编译期就失败；另一类是敏感字段没加密、用了废弃重载，上线后触发运行时错误或安全隐患。这个技能把接口文档和真实 jar 之间的差异交给 javap 来验证，避免手写猜测。

核心能力与关键步骤

• 前置确认：检查 SDK jar、API 文档、app_id、RSA 签名私钥、SM2 加密公钥和 RSA 验签公钥是否齐备，并扫描项目构建工具与现有配置。
• SDK 验证门禁：对目标接口的 Model 和 Response 类执行 javap，生成已验证方法清单，作为代码生成的唯一输入。
• 代码生成：生成 config/model/service/webhook/exception 模块，写接口使用强类型 Request DTO，内部转换为 Map 后调用 SDK。
• 敏感字段保护：password、bank_acct_no、id_no、mobile_number 等字段先经 Pingpp.encryptField(value) 再放入 params。
• 资源与测试：创建密钥占位文件、application.yml 配置块，并为接入接口生成单元测试；查询类测试必须通过。

关键规则

• params key 使用下划线命名，例如 out_order_no、out_user_id，与 API 文档保持一致。
• 全局配置通过 Pingpp.setAppId()、Pingpp.setSignPrivateKeyPath() 等静态方法在 @PostConstruct 中完成。
• 优先使用带 RequestOptions 的方法重载，传入 RequestOptions.getDefault()。
• 默认兼容 Java 8，不使用 var、List.of()、record、switch expression 等高版本语法。

适用边界

适合需要写代码的 Ping++ 合规分账接入；不适用于只讨论分账业务逻辑，或对接其他支付产品的场景。