Agent Skills
返回列表
拉卡拉 MOSS 支付下单

拉卡拉 MOSS 支付下单

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_724f39e0/lakalamoss。

技能介绍

要解决什么问题

对接拉卡拉 MOSS 统一下单时，你需要同时处理 JSON 报文结构、head/request 字段约定、RSA SHA256（SHA256WithRSA / PKCS1v15） 签名与响应验签，并从返回体里稳定取出 response.counter_url。手工拼请求容易在 key 排序、金额单位或验签环节出错，导致下单失败或误信被篡改的响应。

技能如何工作

本技能围绕 scripts/create_order.py 走一条固定链路：

  • 收参：必需 --order-no、--total-amount（字符串，单位：分）；可选 --subject、--remark、--callback-url
  • 组报文：生成 serviceSn，填充默认商户号、支付方式等 MOSS 规范字段
  • 请求签名：对 request JSON 按 key 排序后序列化，用商户私钥签名，Base64 写入 head.sign
  • 调用 API：POST https://moss.lakala.com/ord-api/unified/v3，再使用拉卡拉公钥验签 head.sign
  • 解析结果：业务码 code 为 000000 时从 response.counter_url 取出支付链接，并带回服务流水号等信息

需要查错误码或字段细节时，可对照 references/moss-api-guide.md。

适用边界与注意点

  • 订单号必须唯一；金额务必用字符串传分，例如 "1" 为 1 分、"100" 为 1 元
  • 脚本内置测试用商户私钥与拉卡拉公钥；生产环境应替换真实商户号、渠道编码，并将密钥放到环境变量或密钥服务，禁止长期明文硬编码
  • 默认支持支付宝、微信、银联二维码；链接约 30 分钟有效；回调地址需公网可达并自行做安全校验
  • 验签失败应直接拒绝响应；金额建议在业务侧做双重校验，并保留请求/响应日志便于审计

使用场景

  • 后端要在联调环境用真实 MOSS 接口发起 1 分或 1 元测试单，并拿到可打开的 counter_url
  • 商户系统已有订单号与金额，需要快速生成 MOSS 支付链接发给用户扫码或跳转
  • 上线前需走通请求签名、调用 ord-api/unified/v3、响应验签的完整链路做回归
  • 排查下单失败时需对照 serviceSn、业务码 code 与 counter_url 是否按规范返回

适合人员

  • 负责商户收银台对接、要把订单号与分单位金额接到拉卡拉 MOSS 的后端工程师
  • 维护支付中台、需要核对 RSA SHA256 签名与拉卡拉公钥验签实现的平台开发
  • 准备替换脚本内置测试密钥与商户号、部署生产 MOSS 配置的商户侧运维或实施
  • 写支付回调处理逻辑、需确认 callback-url 与 30 分钟链接有效期约束的全栈或后端开发