# 接入Skill说明

鸿蒙支付服务接入Skill是一套面向开发者/外部商户接入的能力，基于Payment Kit文档沉淀标准流程与关键校验点，将"文档阅读"转化为"任务清单执行"，帮助开发者更快完成鸿蒙支付服务接入的能力。

接入Skill能力可获得：

* 标准接入路径：基础支付最小闭环，从预下单到拉起收银台到回调处理一步到位
* 关键安全内置：签名规则、SM2回调验签、先验签后入库、私钥保护等红线控制
* 稳定性保障：回调3秒响应要求、重试处理与幂等策略、上线切换检查清单
* 排障提效：应用端和服务端错误码定位路径与修复建议

## 能力覆盖范围

当前支持：

* 基础支付（直连/平台/服务商通用接入逻辑）
* 回调验签（SM2）与幂等处理方法
* 沙盒联调指导与生产环境切换检查清单
* 常见错误码排障（应用端/服务端）

## 使用方式

[下载Skill](https://gitcode.com/HarmonyOS_Samples/paymentkit-sample-code-serverdemo-java/tree/master/skills)，把Skill放到AI编码工具的skills目录（不同工具规范不一致，按工具要求处理），工具就能在对话中自动或按需使用它。

### 在工具里触发Skill的使用

在对话中出现这些关键词时会更容易触发：

**鸿蒙支付服务接入/Payment Kit/预下单/orderStr/回调验签/幂等/错误码。**

也可以直接这样提问以"强制触发"：

* 使用"huawei-payment-integration"Skill，给出基础支付最小闭环接入清单。
* 使用该Skill帮忙设计回调SM2验签与幂等方案，并给出验收点。

## 注意事项

* 私钥严禁出现在客户端、日志、公共仓库
* 回调必须先验签再更新订单状态
* 不以客户端返回作为最终交易结果依据
* 生产上线前务必完成回调幂等与压测验证

## 声明

为保障平台及开发者双方的合法权益，特此声明如下：

1. 代码生成责任：我方不对生成代码的正确性、安全性做任何担保。使用本Skill文档自动生成的代码，开发者在使用过程中应自行审核、测试并确保其适用性与准确性。因代码错误、不兼容或使用不当所引发的任何直接或间接损失，包括但不限于经济损失、数据丢失、系统故障等，均由开发者自行承担全部责任。
2. 平台免责：开发者应自行选择合法合规的AI工具，严格遵循所选AI工具的版权规定及使用规范。我们不对因使用本Skill文档生成的代码所导致的任何问题承担责任，包括但不限于法律纠纷、第三方索赔、系统运行异常等。
3. 使用前提：开发者在使用本Skill文档前，应充分理解并接受其使用风险，建议在正式上线前进行充分测试与验证。
4. 合规提示：开发者应确保其使用行为符合相关法律法规及行业规范，平台不对开发者的行为合法性进行担保或审查。
5. 版权声明：本Skill文档的版权归属我方所有，开发者不得擅自篡改、传播、转售、出租本文档，不得用于与接入鸿蒙支付服务无关的其他用途。如开发者存在前述违规使用行为，我方有权追究法律责任。