易支付
将以下提示词粘贴到你的 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 参数与签名逻辑