alipay-payment-integration（支付宝支付整合）

支付宝支付集成 Skill

前置说明

1. 本 Skill 主要提供支付宝支付产品集成指引和集成问题排查指引。
2. 请开发人员审查 AI 生成的接入代码，自行确认代码逻辑，上线前充分测试确保其适用性与准确性。

文档访问规范

所有支付宝支付产品的文档地址均为在线动态链接，务必使用 curl 获取在线文档内容：

# 示例：获取当面付文档
curl -sL "https://ideservice.alipay.com/cms/site/0izcu3"

递归访问

文档页面内包含的链接需要递归访问以获取完整内容。访问流程：

1. 首先访问主文档 URL。
2. 解析文档中的链接（产品介绍、接入准备、接口文档等）。
3. 递归访问这些链接获取详细内容。

# 访问当面付子链接示例
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 错误码排查

适用：用户提供了明确的错误码。

⚠️ 报错接口信息确认（必须完成）：错误码查询前，必须确认发生报错的接口信息，否则暂停输出并要求用户澄清，严禁在报错接口信息缺失时尝试查阅文档或猜测报错接口。

排查流程

1. 查公共错误码：查阅 公共错误码说明，根据用户提供的错误码检索相关内容。如有匹配结果，输出排查结论；否则，查业务错误码。
2. 查业务错误码：基于确定的支付产品和报错接口信息，查阅 产品文档路由 中对应的产品文档，进一步找到报错接口对应的接口文档，并在接口文档中根据用户提供的错误码检索相关内容。
3. 输出排查结论：根据查询到的错误码关联内容，输出排查结论。

步骤 2.3 常见问题排查

适用：无明确错误码的其他类型问题。

排查流程

1. 根据用户输入和确定的支付产品，查阅对应的产品常见问题文档，匹配问题解决方案，回答用户问题时，务必以支付宝文档为准。
2. 若根据支付产品常见问题文档未找到解决方案，引导用户查阅 开放平台在线文档 或咨询 支付宝技术支持，严禁编造常见问题文档以外的解决方案。

常见问题文档索引

产品文档路由

根据用户的业务场景，路由到对应的产品文档：

注意：回答任何接入问题或编写代码前，先通过 curl 阅读上表中对应的在线文档链接。文档内包含最新的接口参数、代码示例和注意事项。