支付宝支付集成 Skill
前置说明
- 本 Skill 主要提供支付宝支付产品集成指引和集成问题排查指引。
- 请开发人员审查 AI 生成的接入代码，自行确认代码逻辑，上线前充分测试确保其适用性与准确性。
文档访问规范
所有支付宝支付产品的文档地址均为在线动态链接，务必使用 curl 获取在线文档内容：
# 示例：获取当面付文档
curl -sL "https://ideservice.alipay.com/cms/site/0izcu3"递归访问
文档页面内包含的链接需要递归访问以获取完整内容。访问流程：
- 首先访问主文档 URL。
- 解析文档中的链接（产品介绍、接入准备、接口文档等）。
- 递归访问这些链接获取详细内容。
# 访问当面付子链接示例
curl -sL "https://ideservice.alipay.com/cms/site/0izal0" # 产品介绍
curl -sL "https://ideservice.alipay.com/cms/site/0izal1" # 接入准备功能一：支付产品集成指引
触发条件：用户需要集成支付宝支付产品。
步骤 1.1 产品决策
阅读 产品决策，根据用户输入匹配关键词，决策支付产品。当用户描述模糊时，使用 澄清话术模板 进行产品确认。
步骤 1.2 获取集成文档
接入前必须阅读下列文档：
- SDK 选择：为了帮助开发者调用开放接口，支付宝提供了开放平台服务端 SDK，包含 Java、PHP、Node.js、Python 和.NET 五种语言，封装了签名与验签、HTTP 接口请求等基础功能。请先下载对应语言版本的最新版服务端 SDK 并引入开发工程。下载地址
- 加签方式：签名请使用 RSA2。加签说明
- 接入规范与常见陷阱：接入规范
- 产品文档：根据用户的产品集成诉求，访问 产品文档路由 中对应的产品文档。阅读产品文档中的快速接入、接口列表、异步通知说明、注意事项等部分，根据用户集成诉求尽可能多地收集信息。
⛔ 阻塞检查点：步骤 1.2 完成标准（下列事项必须全部满足才能继续执行后续步骤）
- 已读取 SDK 选择
- 已读取 加签方式
- 已读取 接入规范与常见陷阱
- 已读取 产品文档（必须递归阅读项：快速接入、接口列表、异步通知说明）
集成环境说明
- 建议开发者在测试阶段优先使用沙箱环境。
- 沙箱环境：地址：
https://openapi-sandbox.dl.alipaydev.com/gateway.do详见：沙箱环境说明 - 正式环境：地址：
https://openapi.alipay.com/gateway.do
步骤 1.3 集成校验
- 在集成过程中及发布上线前按照 集成校验清单 进行校验，确保签名验签、异步通知、异常处理等符合规范。校验结果供参考，开发者务必按照支付宝最新开放平台文档进行检查。
安全红线
⛔ 以下规则为支付宝支付接入的安全红线，违反可能导致资金损失或安全事故，必须严格遵守，产品集成过程中务必提醒开发者注意以下安全事项。
- 私钥禁止存客户端：构造交易数据并签名必须在商家服务端完成，私钥严禁保存在商家 APP 客户端中。
- 私钥禁止记日志：私钥不得出现在任何日志中。
- 私钥禁止传公共仓库：私钥不得上传到 GitHub、GitLab 等公共代码仓库。
- 前台支付结果不可信：前台同步跳转结果不可信，必须以支付宝异步通知或调用交易查询接口获取结果为准。
- 未确认不重付：在未确认支付结果前，不得要求用户再次付款，必须先通过异步通知或查询接口确认支付结果。
- 异步通知必须先验签：收到异步通知后必须先验签，确保通知来自支付宝。
功能二：集成问题排查指引
触发条件：用户在集成支付宝支付产品过程中遇到报错或其他问题。
⚠️ 支付产品信息确认（必须遵守）：执行下述问题排查步骤之前，必须明确用户当前集成的支付产品，否则暂停输出并要求用户澄清，严禁在支付产品信息缺失时尝试查阅文档或猜测支付产品。
步骤 2.1 问题识别与分流
根据用户输入判断问题类型，分流到对应排查路径：
用户问题
|
+-- 有明确错误码（如 "ACQ.TRADE_HAS_SUCCESS"、"INVALID_PARAMETER"）
| |
| └───> 步骤 2.2 错误码排查
|
+-- 无明确错误码（如流程疑问、功能异常等）
|
└───> 步骤 2.3 常见问题排查步骤 2.2 错误码排查
适用：用户提供了明确的错误码。
⚠️ 报错接口信息确认（必须完成）：错误码查询前，必须确认发生报错的接口信息，否则暂停输出并要求用户澄清，严禁在报错接口信息缺失时尝试查阅文档或猜测报错接口。
排查流程
- 查公共错误码：查阅 公共错误码说明，根据用户提供的错误码检索相关内容。如有匹配结果，输出排查结论；否则，查业务错误码。
- 查业务错误码：基于确定的支付产品和报错接口信息，查阅 产品文档路由 中对应的产品文档，进一步找到报错接口对应的接口文档，并在接口文档中根据用户提供的错误码检索相关内容。
- 输出排查结论：根据查询到的错误码关联内容，输出排查结论。
步骤 2.3 常见问题排查
适用：无明确错误码的其他类型问题。
排查流程
- 根据用户输入和确定的支付产品，查阅对应的产品常见问题文档，匹配问题解决方案，回答用户问题时，务必以支付宝文档为准。
- 若根据支付产品常见问题文档未找到解决方案，引导用户查阅 开放平台在线文档 或咨询 支付宝技术支持，严禁编造常见问题文档以外的解决方案。
常见问题文档索引
| 产品类别 | 常见问题文档 |
|---|---|
| 当面付 | 当面付常见问题 |
| 订单码支付 | 订单码支付常见问题 |
| APP 支付 | APP 支付常见问题 |
| 电脑网站支付 | 电脑网站支付常见问题 |
| 手机网站支付 | 手机网站支付常见问题 |
| 商家扣款 | 商家扣款常见问题 |
| 预授权支付 | 预授权支付常见问题 |
| JSAPI 支付 | JSAPI 支付常见问题 |
产品文档路由
根据用户的业务场景，路由到对应的产品文档：
| 支付产品 | 核心 API | 在线文档 |
|---|---|---|
| 当面付 | alipay.trade.pay | 当面付文档 |
| 订单码支付 | alipay.trade.precreate | 订单码支付文档 |
| 手机网站支付 | alipay.trade.wap.pay | 手机网站支付文档 |
| 电脑网站支付 | alipay.trade.page.pay | 电脑网站支付文档 |
| JSAPI 支付 | alipay.trade.create + my.tradePay | JSAPI 支付文档 |
| App 支付 | alipay.trade.app.pay | App 支付文档 |
| 预授权支付 | alipay.fund.auth.order.app.freeze | 预授权支付文档 |
| 商家扣款 | alipay.trade.app.pay（支付并签约）+ alipay.trade.pay（后续扣款） | 商家扣款文档 |
注意：回答任何接入问题或编写代码前，先通过 curl 阅读上表中对应的在线文档链接。文档内包含最新的接口参数、代码示例和注意事项。