支付宝接口开发指南

SPA页面抓取

支付宝文档站(opendocs.alipay.com)为SPA，已通过PreToolUse hook自动拦截WebFetch并使用playwright预渲染，无需手动处理。

接口分类

所有支付宝接口分三类：

发送信息

使用POST/GET主动向支付宝服务器发送消息并获取回复，最常见。

接收消息(回调/订阅)

支付宝服务器向己方服务器推送消息，在控制台订阅后随时可能发生。因为在控制台指定了接口，必定只有该接口收到消息。通过携带的method字段判断消息种类。

上传文件

本质是发送消息，但支付宝有两种方式：base64编码附加到指定字段、直接附加二进制内容。最少见。

文档页面结构

支付宝接口文档需查看以下几项（可作为HTML搜索标志词）：

• •公共请求参数
• •业务请求参数 — 一般作为公共请求参数biz_content的子项，需递归创建所有键
• •常见请求示例(cURL/Java/C#/PHP) — 查看发送的具体内容
• •公共响应参数
• •业务响应参数 — 一般被包装在形如alipay_open_mini_icp_apply_response的键内，code=10000为成功
• •响应示例(正常/异常) — 查看具体响应代码