Agent Skills
返回列表
易支付

易支付

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_07e78b9e/epay-skill。

技能介绍

要解决什么问题

业务侧要同时接微信和支付宝,往往要面对多套商户配置、不同签名规则与回调验签逻辑。易支付把通道聚合成一套 HTTP API,但接口参数、签名顺序和回调字段仍需要对照文档逐项实现,漏字段或把「文档未定义」的 JSON 键当成必填,容易在升级或灰度时把支付链路搞挂。

技能如何帮你对接

本技能以易支付接入指南为主线,把常用端点整理成可检索的说明,便于在写代码或让 Agent 改对接层时对齐官方行为:

  • 创建订单:https://epay.jylt.cc/api/createOrder(GET/POST)
  • 查询订单信息:https://epay.jylt.cc/api/getOrder
  • 查询订单状态:https://epay.jylt.cc/api/checkOrder
  • 生成签名:https://epay.jylt.cc/api/generateSign
  • 支付回调:服务端以 GET 方式接收平台通知,需按文档验签并幂等更新订单

对接时建议把「下单 → 查单/轮询状态 → 异步回调确认」串成一条状态机,签名统一走 generateSign 或与文档一致的本地算法,避免各接口各写一套。

注意点与边界

文档强调:只处理接口文档中已明确定义的返回值字段;其余字段应忽略,且不应因未知键导致反序列化失败。在 Java 等栈里可为 Jackson 等配置忽略未知属性。本技能覆盖的是易支付(epay.jylt.cc)这一套 API 约定,不包含微信支付/支付宝官方直连 SDK 的替代方案;生产环境仍需自行保管密钥、校验回调来源并做好对账与重试策略。

使用场景

  • 独立站或 SaaS 要在结账页调用易支付创建订单,并拿到支付跳转或二维码所需参数
  • 支付完成后需轮询 `checkOrder` 或在用户返回页用 `getOrder` 核对金额与商户订单号
  • 接入异步 GET 回调时,要按文档验签并只更新文档定义的订单状态字段
  • 本地签名与平台不一致时,对照 `generateSign` 接口或文档规则排查参数字典序与空值处理

适合人员

  • 负责会员/订阅付费的后端,要把微信与支付宝统一接到易支付而非两套官方 SDK
  • 维护电商订单状态机的全栈,需要理清下单、查单与回调幂等更新的字段边界
  • 接第三方支付的新手工程师,需要按 SKILL 约束配置 JSON 反序列化以忽略未知返回字段
  • 排查线上「支付成功但订单未更新」的运维开发,要核对回调 URL、GET 参数与签名逻辑