Alipay Payment Integration

所有支付宝支付产品的文档均为在线动态链接，接入前务必先阅读对应产品的在线文档获取最新接口参数和代码示例。

文档访问规范

访问支付宝在线文档时，直接使用 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"   # 接入准备

接入路由表

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

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

快速决策树

用户咨询支付宝接入
        |
        +-- 线下门店收款？
        |       +-- 用户出示付款码，商家扫 --> 当面付
        |       +-- 商家出示二维码，用户扫 --> 订单码支付
        |
        +-- 线上支付？
        |       +-- 原生 App（iOS/Android/鸿蒙）--> App 支付
        |       +-- 支付宝小程序 --> JSAPI支付
        |       +-- 手机浏览器 H5 --> 手机网站支付
        |       +-- 电脑浏览器网页 --> 电脑网站支付
        |
        +-- 需要冻结资金/押金？
        |       +-- 预授权支付
        |
        +-- 周期性自动扣款？
                +-- 会员订阅/连续包月/自动续费 --> 商家扣款

场景关键词匹配

澄清话术

当用户描述模糊时：

请确认您的业务场景：

1. 线下门店收款
   - 当面付：用户出示付款码，商家用扫码枪收款
     适用：便利店、商超综合体、餐饮店、医院、学校、电影院、旅游景区等实体门店
   - 订单码支付：商家生成二维码，用户扫码付款
     适用：商品售卖、媒体广告支付等场景

2. 线上App支付
   - 原生 iOS/Android/鸿蒙 App 内调起支付宝付款
   - App 未安装支付宝客户端时可降级 H5 支付

3. 支付宝小程序支付
   - JSAPI支付：小程序内调起支付宝收银台完成支付
   - 适用：支付宝小程序内购物、服务购买等场景

4. 手机网站支付
   - 手机浏览器 H5 页面内唤起支付宝 App 或网页收银台
   - 适用：移动端网页内支付等场景

5. 电脑网站支付
   - 电脑浏览器跳转支付宝网页收银台
   - 支持扫码支付或登录账户支付
   - 适用：PC端电商网站、在线服务平台等

6. 预授权支付
   - 先冻结资金或信用额度，按实际消费扣款，剩余解冻归还
   - 适用：酒店民宿、传统租车、分时租赁、单车租赁、充电宝、雨伞、3C数码/手机/相机租赁等

7. 商家扣款（周期自动扣款）
   - 用户签约授权后，商家主动发起周期性扣款
   - 适用：会员包月、自动续费、定期还款等

请描述您的具体业务需求？

接入说明

注意事项

• 本 Skill 不支持商家分账产品接入，分账需求请查阅开放平台文档或咨询客服。
• 业务咨询和接入问题请查阅 开放平台在线文档 或咨询支付宝客服。
• 商家扣款产品已于 2026.3.28 完成产品升级，本文仅支持最新版本的接入。原有曾使用旧版本接入的商家仍可继续使用，但后续将不再进行能力更新，也不再接受新场景接入，相关文档前往开放平台在线文档 查看。
• 商家扣款当前只支持周期性扣款模式，用户主动免密支付场景暂不支持接入。
• 测试阶段建议开发者优先使用沙箱环境。
• 本文档中所有链接均指向支付宝在线文档，内容会动态更新，编写代码前务必通过阅读最新版本。