跳到主要内容

接入Skill能力说明

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

接入Skill能力可获得:

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

能力覆盖范围

当前支持:

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

使用方式

下载Skill技能,把Skill放到AI编码工具的skills目录,工具就能在对话中自动或按需使用它。

在工具里触发Skill的使用

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

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

也可以直接这样提问以“强制触发”:

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

注意事项

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

声明

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

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