Agent Skills
返回列表
支付宝支付集成

支付宝支付集成

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8509461a/alipay-payment-integration。

技能介绍

问题:支付宝接入场景多,选错产品会返工

做支付功能时,用户常只说“加个支付宝”或“H5 支付”,但支付宝实际有当面付、订单码、手机网站、电脑网站、JSAPI、App、预授权和商家扣款等多条路径。选错 alipay.trade.pay、alipay.trade.precreate 或 my.tradePay 这类 API,会导致收银台链路、SDK 依赖、签约扣款逻辑都不匹配。

工作方式:先按业务关键词路由,再读动态文档

该 Skill 的核心是一张接入路由表和关键词匹配表:线下付款码收款走当面付,商家生成二维码走订单码支付,手机浏览器走 alipay.trade.wap.pay,PC 网页走 alipay.trade.page.pay,小程序走 JSAPI,原生 App 走 alipay.trade.app.pay,押金冻结走预授权,自动续费走商家扣款。它还会要求编码前用 curl 访问对应在线文档,并递归解析接口文档,确保拿到最新参数、错误码和示例。接入说明覆盖 RSA2 加签、正式网关、沙箱网关、服务端 SDK 和常见错误码。

适用边界:只覆盖收单,不覆盖非支付场景

它不适用于微信、银联、支付宝转账、对账或红包,也不支持商家分账接入。商家扣款当前仅支持周期性扣款,用户主动免密支付暂不支持。测试阶段建议使用沙箱环境,正式代码前务必以支付宝在线文档为准。

使用场景

  • 线下门店收银时,把用户付款码转成扫码枪收款,并确认当面付参数与回调。
  • 商家要在商品页生成二维码,让用户打开支付宝扫码付款,需要选择订单码支付并预创建订单。
  • H5 活动页在手机浏览器里唤起支付宝付款,需要确认手机网站支付网关与签名方式。
  • 支付宝小程序内完成下单和调起支付,需要区分创建订单与前端 my.tradePay 调用。

适合人员

  • 负责门店收银系统的后端工程师,要把扫码枪付款码接入当面付并处理异步通知。
  • 负责电商商品页的前端工程师,要生成商家二维码并让用户扫码完成支付。
  • 负责 H5 活动页的全栈工程师,要在手机浏览器里接入支付宝收银台并配置签名网关。
  • 负责会员订阅的后端工程师,要区分周期扣款签约和后续扣款接口。