xinetzone/SpecWeave / .agents/skills/alipay-payment-integration
alipay-payment-integration
Flagged支付宝开放平台支付产品接入最佳实践。涵盖当面付、订单码支付、App 支付、JSAPI 支付、手机网站支付、电脑网站支付、预授权支付、商家扣款等全场景产品选型与集成指导。 当用户提到"接入支付宝"、"集成支付宝支付"、"对接支付"、"支付宝收款"、"加个支付功能"、"支付宝下单"、"H5 支付"、"小程序支付"、"预授权"、"付款码"、"扫码支付"、"网页支付"、"PC 支付"、"周期扣款"、"自动续费"、"会员订阅"、"连续包月"、"代扣"时,或咨询支付产品相关报错、排查问题时使用此 Skill。
references/code-examples/interface-guide.md
View on GitHub# 接口说明与代码示例索引
本文件汇总了支付宝支付产品的通用接口和产品专用接口的参考文档及代码示例索引,供主 Skill 集成参考。
## 一、通用接口
下表所列接口适用于所有支付宝支付产品,请结合用户集成诉求按需查阅。
### 通用接口文档索引
| 接口名称 | 文档链接 |
| --- | --- |
| 统一收单交易查询接口 | <https://ideservice.alipay.com/cms/site/0izblf> |
| 统一收单交易退款接口 | <https://ideservice.alipay.com/cms/site/0izam4> |
| 统一收单交易退款查询接口 | <https://ideservice.alipay.com/cms/site/0izl48> |
| 收单退款冲退完成通知接口 | <https://ideservice.alipay.com/cms/site/0izofn> |
| 统一收单交易撤销接口 | <https://ideservice.alipay.com/cms/site/0izofo> |
| 查询对账单下载地址接口 | <https://ideservice.alipay.com/cms/site/0izofp> |
| 异步通知说明 | <https://ideservice.alipay.com/cms/site/0izal6> |
### 通用接口代码示例索引
各接口的代码示例按编程语言拆分,存放于各语言目录的 `1_通用接口/` 子目录下。请根据用户实际使用的编程语言查找所需接口的示例代码,**不要混用不同语言**。
表格中某语言列为空,表示该语言暂无对应接口的示例文档。此时请依据上述通用接口文档中的**公共请求参数**、**业务请求参数**及**响应参数**,获取字段名、类型、是否必填及取值规则,按照当前编程语言规范自行完成实现。
| 接口名称 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- |
| 统一收单交易查询接口 | [示例](java/1_通用接口/统一收单交易查询接口代码示例.md) | [示例](python/1_通用接口/统一收单交易查询接口代码示例.md) | [示例](nodejs/1_通用接口/统一收单交易查询接口代码示例.md) | [示例](php/1_通用接口/统一收单交易查询接口代码示例.md) | [示例](csharp/1_通用接口/统一收单交易查询接口代码示例.md) |
| 统一收单交易退款接口 | [示例](java/1_通用接口/统一收单交易退款接口代码示例.md) | [示例](python/1_通用接口/统一收单交易退款接口代码示例.md) | [示例](nodejs/1_通用接口/统一收单交易退款接口代码示例.md) | [示例](php/1_通用接口/统一收单交易退款接口代码示例.md) | [示例](csharp/1_通用接口/统一收单交易退款接口代码示例.md) |
| 统一收单交易退款查询接口 | [示例](java/1_通用接口/统一收单交易退款查询接口代码示例.md) | [示例](python/1_通用接口/统一收单交易退款查询接口代码示例.md) | [示例](nodejs/1_通用接口/统一收单交易退款查询接口代码示例.md) | [示例](php/1_通用接口/统一收单交易退款查询接口代码示例.md) | [示例](csharp/1_通用接口/统一收单交易退款查询接口代码示例.md) |
| 收单退款冲退完成通知接口 | [示例](java/1_通用接口/收单退款冲退完成通知接口代码示例.md) | [示例](python/1_通用接口/收单退款冲退完成通知接口代码示例.md) | [示例](nodejs/1_通用接口/收单退款冲退完成通知接口代码示例.md) | [示例](php/1_通用接口/收单退款冲退完成通知接口代码示例.md) | [示例](csharp/1_通用接口/收单退款冲退完成通知接口代码示例.md) |
| 统一收单交易撤销接口 | [示例](java/1_通用接口/统一收单交易撤销接口代码示例.md) | [示例](python/1_通用接口/统一收单交易撤销接口代码示例.md) | [示例](nodejs/1_通用接口/统一收单交易撤销接口代码示例.md) | [示例](php/1_通用接口/统一收单交易撤销接口代码示例.md) | [示例](csharp/1_通用接口/统一收单交易撤销接口代码示例.md) |
| 查询对账单下载地址接口 | [示例](java/1_通用接口/查询对账单下载地址接口代码示例.md) | [示例](python/1_通用接口/查询对账单下载地址接口代码示例.md) | [示例](nodejs/1_通用接口/查询对账单下载地址接口代码示例.md) | [示例](php/1_通用接口/查询对账单下载地址接口代码示例.md) | [示例](csharp/1_通用接口/查询对账单下载地址接口代码示例.md) |
---
## 二、产品专用接口
下表所列为各支付产品特有的接口,按产品分类。代码示例存放于各语言目录的对应产品子目录下(如 `2_当面付/`、`8_预授权支付/` 等)。
表格中某语言列为空,表示该语言暂无对应接口的示例文档。此时请依据对应产品在线文档中的**公共请求参数**、**业务请求参数**及**响应参数**,按照当前编程语言规范自行完成实现。
### 2_当面付
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| 统一收单交易支付接口 | [文档](https://ideservice.alipay.com/cms/site/0izcu3) | [示例](java/2_当面付/统一收单交易支付接口代码示例.md) | [示例](python/2_当面付/统一收单交易支付接口代码示例.md) | [示例](nodejs/2_当面付/统一收单交易支付接口代码示例.md) | [示例](php/2_当面付/统一收单交易支付接口代码示例.md) | [示例](csharp/2_当面付/统一收单交易支付接口代码示例.md) |
### 3_订单码支付
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| 统一收单线下交易预创建接口 | [文档](https://ideservice.alipay.com/cms/site/0izg0z) | [示例](java/3_订单码支付/统一收单线下交易预创建接口代码示例.md) | [示例](python/3_订单码支付/统一收单线下交易预创建接口代码示例.md) | [示例](nodejs/3_订单码支付/统一收单线下交易预创建接口代码示例.md) | [示例](php/3_订单码支付/统一收单线下交易预创建接口代码示例.md) | [示例](csharp/3_订单码支付/统一收单线下交易预创建接口代码示例.md) |
### 4_手机网站支付
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| 手机网站支付接口 | [文档](https://ideservice.alipay.com/cms/site/0izne3) | [示例](java/4_手机网站支付/手机网站支付接口代码示例.md) | [示例](python/4_手机网站支付/手机网站支付接口代码示例.md) | [示例](nodejs/4_手机网站支付/手机网站支付接口代码示例.md) | [示例](php/4_手机网站支付/手机网站支付接口代码示例.md) | [示例](csharp/4_手机网站支付/手机网站支付接口代码示例.md) |
### 5_电脑网站支付
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| 统一收单下单并支付页面接口 | [文档](https://ideservice.alipay.com/cms/site/0iztfv) | [示例](java/5_电脑网站支付/统一收单下单并支付页面接口代码示例.md) | [示例](python/5_电脑网站支付/统一收单下单并支付页面接口代码示例.md) | [示例](nodejs/5_电脑网站支付/统一收单下单并支付页面接口代码示例.md) | [示例](php/5_电脑网站支付/统一收单下单并支付页面接口代码示例.md) | [示例](csharp/5_电脑网站支付/统一收单下单并支付页面接口代码示例.md) |
### 6_JSAPI支付
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| 统一收单交易创建接口 | [文档](https://ideservice.alipay.com/cms/site/0izg0f) | [示例](java/6_JSAPI支付/统一收单交易创建接口代码示例.md) | | | [示例](php/6_JSAPI支付/统一收单交易创建接口代码示例.md) | [示例](csharp/6_JSAPI支付/统一收单交易创建接口代码示例.md) |
### 7_APP支付
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| APP支付接口 | [文档](https://ideservice.alipay.com/cms/site/0izsn4) | [示例](java/7_APP支付/APP支付接口代码示例.md) | [示例](python/7_APP支付/APP支付接口代码示例.md) | [示例](nodejs/7_APP支付/APP支付接口代码示例.md) | [示例](php/7_APP支付/APP支付接口代码示例.md) | [示例](csharp/7_APP支付/APP支付接口代码示例.md) |
### 8_预授权支付
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| 线上资金授权冻结接口 | [文档](https://ideservice.alipay.com/cms/site/0j0lyx) | [示例](java/8_预授权支付/线上资金授权冻结接口代码示例.md) | | | [示例](php/8_预授权支付/线上资金授权冻结接口代码示例.md) | [示例](csharp/8_预授权支付/线上资金授权冻结接口代码示例.md) |
| 资金授权冻结接口 | [文档](https://ideservice.alipay.com/cms/site/0j0lyx) | [示例](java/8_预授权支付/资金授权冻结接口代码示例.md) | | | [示例](php/8_预授权支付/资金授权冻结接口代码示例.md) | [示例](csharp/8_预授权支付/资金授权冻结接口代码示例.md) |
| 资金授权解冻接口 | [文档](https://ideservice.alipay.com/cms/site/0j0lyx) | [示例](java/8_预授权支付/资金授权解冻接口代码示例.md) | | | [示例](php/8_预授权支付/资金授权解冻接口代码示例.md) | [示例](csharp/8_预授权支付/资金授权解冻接口代码示例.md) |
| 资金授权撤销接口 | [文档](https://ideservice.alipay.com/cms/site/0j0lyx) | [示例](java/8_预授权支付/资金授权撤销接口代码示例.md) | | | [示例](php/8_预授权支付/资金授权撤销接口代码示例.md) | [示例](csharp/8_预授权支付/资金授权撤销接口代码示例.md) |
| 资金授权操作查询接口 | [文档](https://ideservice.alipay.com/cms/site/0j0lyx) | [示例](java/8_预授权支付/资金授权操作查询接口代码示例.md) | | | [示例](php/8_预授权支付/资金授权操作查询接口代码示例.md) | [示例](csharp/8_预授权支付/资金授权操作查询接口代码示例.md) |
| 资金授权发码接口 | [文档](https://ideservice.alipay.com/cms/site/0j0lyx) | [示例](java/8_预授权支付/资金授权发码接口代码示例.md) | | | [示例](php/8_预授权支付/资金授权发码接口代码示例.md) | [示例](csharp/8_预授权支付/资金授权发码接口代码示例.md) |
| 统一收单交易支付接口(预授权转支付) | [文档](https://ideservice.alipay.com/cms/site/0j0lyx) | [示例](java/8_预授权支付/统一收单交易支付接口(预授权转支付)代码示例.md) | | [示例](nodejs/8_预授权支付/统一收单交易支付接口(预授权转支付)代码示例.md) | [示例](php/8_预授权支付/统一收单交易支付接口(预授权转支付)代码示例.md) | [示例](csharp/8_预授权支付/统一收单交易支付接口(预授权转支付)代码示例.md) |
### 9_商家扣款
| 接口名称 | 文档链接 | Java | Python | Node.js | PHP | C# |
| --- | --- | --- | --- | --- | --- | --- |
| 支付宝个人代扣协议查询接口 | [文档](https://ideservice.alipay.com/cms/site/0j0g6k) | [示例](java/9_商家扣款/支付宝个人代扣协议查询接口代码示例.md) | | | [示例](php/9_商家扣款/支付宝个人代扣协议查询接口代码示例.md) | [示例](csharp/9_商家扣款/支付宝个人代扣协议查询接口代码示例.md) |
| 支付宝个人代扣协议解约接口 | [文档](https://ideservice.alipay.com/cms/site/0j0g6k) | [示例](java/9_商家扣款/支付宝个人代扣协议解约接口代码示例.md) | | | [示例](php/9_商家扣款/支付宝个人代扣协议解约接口代码示例.md) | [示例](csharp/9_商家扣款/支付宝个人代扣协议解约接口代码示例.md) |
| 统一收单交易支付接口(商家扣款) | [文档](https://ideservice.alipay.com/cms/site/0j0g6k) | [示例](java/9_商家扣款/统一收单交易支付接口(商家扣款)代码示例.md) | | [示例](nodejs/9_商家扣款/统一收单交易支付接口(商家扣款)代码示例.md) | [示例](php/9_商家扣款/统一收单交易支付接口(商家扣款)代码示例.md) | [示例](csharp/9_商家扣款/统一收单交易支付接口(商家扣款)代码示例.md) |
| APP支付接口(支付并签约) | [文档](https://ideservice.alipay.com/cms/site/0j0g6k) | [示例](java/9_商家扣款/APP支付接口(支付并签约)代码示例.md) | | [示例](nodejs/9_商家扣款/APP支付接口(支付并签约)代码示例.md) | [示例](php/9_商家扣款/APP支付接口(支付并签约)代码示例.md) | [示例](csharp/9_商家扣款/APP支付接口(支付并签约)代码示例.md) |Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |