xinetzone/SpecWeave / .agents/skills/alipay-payment-integration
alipay-payment-integration
Flagged支付宝开放平台支付产品接入最佳实践。涵盖当面付、订单码支付、App 支付、JSAPI 支付、手机网站支付、电脑网站支付、预授权支付、商家扣款等全场景产品选型与集成指导。 当用户提到"接入支付宝"、"集成支付宝支付"、"对接支付"、"支付宝收款"、"加个支付功能"、"支付宝下单"、"H5 支付"、"小程序支付"、"预授权"、"付款码"、"扫码支付"、"网页支付"、"PC 支付"、"周期扣款"、"自动续费"、"会员订阅"、"连续包月"、"代扣"时,或咨询支付产品相关报错、排查问题时使用此 Skill。
references/main/product-decision.md
View on GitHub# 产品决策
用于用户集成支付宝支付产品或集成问题排查时的产品决策。
---
## 产品决策树
```
用户咨询支付宝接入
|
+-- 线下门店收款?
| +-- 用户出示付款码,商家扫 --> 当面付
| +-- 商家出示二维码,用户扫 --> 订单码支付
|
+-- 线上支付?
| +-- 原生 App(iOS/Android/鸿蒙)--> App 支付
| +-- 支付宝小程序 --> JSAPI 支付
| +-- 手机浏览器 H5 --> 手机网站支付
| +-- 电脑浏览器网页 --> 电脑网站支付
|
+-- 需要冻结资金/押金?
| +-- 预授权支付
|
+-- 周期性自动扣款?
+-- 会员订阅/连续包月/自动续费 --> 商家扣款
```
---
## 场景关键词匹配
根据用户输入的关键词快速路由到对应产品:
| 关键词 | 路由产品 |
| --- | --- |
| 付款码、条码支付、扫码枪、被扫、线下门店、便利店、商超、餐饮、收银台扫码、实体店、面对面收款、扫码枪收款、用户出示付款码 | 当面付 |
| 订单码、商家二维码、主扫、预下单、商家生成二维码、用户扫码支付、商品二维码、预创建订单 | 订单码支付 |
| H5支付、WAP支付、手机网站、手机浏览器、移动端网页、手机网页支付、wap收银台、手机端网页、移动H5 | 手机网站支付 |
| PC支付、电脑网站、网页支付、电脑端支付、PC网页、电脑浏览器、网站支付、传统网页支付、网页收银台 | 电脑网站支付 |
| 小程序支付、JSAPI、支付宝小程序、生活号、小程序内支付、小程序收银台、小程序JSAPI、my.tradePay、小程序下单、支付宝内小程序 | JSAPI 支付 |
| App支付、移动应用支付、iOS支付、Android支付、鸿蒙支付、App内支付、原生App支付、手机App支付、移动端App、SDK支付、客户端支付 | App 支付 |
| 预授权、押金、资金冻结、信用住、免押、先享后付、酒店押金、租车押金、充电宝押金、单车押金、民宿押金、冻结资金、授权冻结、押金退还 | 预授权支付 |
| 周期扣款、自动续费、会员订阅、连续包月、代扣、商家扣款、定期扣款、会员自动续费、包月会员、订阅制、定期扣费、委托扣款、协议扣款 | 商家扣款 |
---
## 产品决策参考
### 不支持的场景
| 场景 | 说明 |
|------|------|
| 商家分账产品 | 不支持,请查阅开放平台文档或咨询支付宝技术支持 |
| 商家扣款 - 用户主动免密支付 | 暂不支持,当前仅支持周期性扣款模式 |
### 商家扣款版本说明
| 版本 | 说明 |
|------|------|
| **新版**(2026-04-02 升级后) | 本文档适用,支持新场景接入;仅支持周期性扣款 |
| **旧版**(2026-04-02 前接入) | 可继续使用,不再更新,不接受新场景接入,请前往 [开放平台在线文档](https://open.alipay.com?form=payskill) 查看相关文档 |
---
## 澄清话术
当用户描述模糊或关键词匹配不明确时,使用以下模板进行产品决策:
### 标准澄清模板
```
请确认您的业务场景:
1. 线下门店收款
- 当面付:用户出示付款码,商家用扫码枪收款
适用:便利店、商超综合体、餐饮店、医院、学校、电影院、旅游景区等实体门店
- 订单码支付:商家生成二维码,用户扫码付款
适用:商品售卖、媒体广告支付等场景
2. 线上App支付
- 原生 iOS/Android/鸿蒙 App 内调起支付宝付款
- App 未安装支付宝客户端时可降级 H5 支付
3. 支付宝小程序支付
- JSAPI 支付:小程序内调起支付宝收银台完成支付
- 适用:支付宝小程序内购物、服务购买等场景
4. 手机网站支付
- 手机浏览器 H5 页面内唤起支付宝 App 或网页收银台
- 适用:移动端网页内支付等场景
5. 电脑网站支付
- 电脑浏览器跳转支付宝网页收银台
- 支持扫码支付或登录账户支付
- 适用:PC端电商网站、在线服务平台等
6. 预授权支付
- 先冻结资金或信用额度,按实际消费扣款,剩余解冻归还
- 适用:酒店民宿、传统租车、分时租赁、单车租赁、充电宝、雨伞、3C数码/手机/相机租赁等
7. 商家扣款(周期自动扣款)
- 用户签约授权后,商家主动发起周期性扣款
- 适用:会员包月、自动续费、定期还款等
请描述您的具体业务需求?
```
### 不支持场景回复模板
```
抱歉,当前仅支持以下支付产品:当面付、订单码支付、手机网站支付、电脑网站支付、JSAPI 支付、App 支付、预授权支付、商家扣款。
您咨询的场景不在支持范围内,请查阅[开放平台在线文档](https://open.alipay.com?form=payskill)或咨询支付宝技术支持。
```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: 472k | 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 |