拉卡拉MOSS安全支付

要解决的问题

AI 开发者给 Agent 接入收款时，通常要分别对接微信支付、支付宝、银联云闪付：三套 API、三套签名规则、三套回调格式。任何一处出错，不是掉单就是被伪造回调。MOSS 把三个渠道聚合成统一接口，而这个 Skill 负责把 MOSS 协议里最容易踩坑的部分——加密、加签、验签、解密——封装成可直接调用的脚本。

核心能力

Skill 覆盖支付全生命周期的六个操作：

• create_order.py：下单，支持扫码、JSAPI、小程序、APP、H5 等场景，金额单位为分
• query_order.py：按订单号或平台流水号查状态（NOTPAY / SUCCESS / CLOSED / REFUND / PARTIAL_REFUND）
• refund_order.py / query_refund.py：退款与退款查询
• close_order.py：关单；对账通过 moss_api.py 调用 lfops.moss.bill.download

安全链路为 RSA 2048 非对称加密：请求体用内置的 MOSS 平台公钥加密，再用商户私钥对 head + requestEncrypted 加签；响应与回调必须用平台公钥验签，敏感数据再用商户私钥解密。平台公钥由内置数学组件自动重建，商户只需在 MOSS 控台「重置密钥」后复制密钥并上传公钥，然后运行 setup.py 交互向导写入 assets/config.json。

接入流程与边界

调用前需完成商户入网，拿到 app_id（C 开头）和 merchant_id（M 开头）。沙箱商户自动走测试环境，API 地址不变，后端按商户 ID 路由。几个容易翻车的点：

• order_no 必须全局唯一，建议业务前缀加时间戳
• 回调处理要做幂等与金额校验，且必须返回字符串 success，否则 MOSS 最多重试 6 次
• 验签失败（999029）先排查商户公私钥是否配对、公钥是否已上传控台
• 商户私钥仅存本地、权限 600，不要提交到仓库或写进日志
• 测试与生产通过替换配置切换，不要硬编码密钥