支付宝 H5 支付说明

一、支付场景概述

智源论坛是面向技术开发者的内容付费平台，用户除了微信支付外，还可通过支付宝手机网站支付（H5支付）完成交易。支付宝作为国内主流的第三方支付工具，覆盖大量用户群体，是平台支付体系的重要组成部分。

应用场景

• 用户在手机浏览器（非支付宝客户端）打开智源论坛 H5网站
• 用户选择商品或服务后，点击"支付宝支付"
• 页面跳转至支付宝收银台，用户使用支付宝账号完成支付
• 支付成功后返回商户网站，显示订单结果

支持的交易类型

二、业务说明

2.1 商户主体信息

2.2 业务场景

业务类型	单笔金额	预估月交易笔数
付费课程	¥29 - ¥299	800 - 1500
会员订阅	¥39 - ¥299	500 - 1000
付费文章	¥9.9 - ¥29	1000 - 3000
咨询服务	¥99 - ¥999	50 - 150

三、支付流程

3.1 整体流程

┌─────────┐      ┌──────────┐      ┌──────────┐
│ 用户H5  │      │ 智源论坛  │      │  支付宝  │
│  页面   │      │  服务端  │      │   服务   │
└────┬────┘      └─────┬────┘      └─────┬────┘
     │                 │                 │
     │  1.浏览下单     │                 │
     │────────────────→│                 │
     │                 │                 │
     │                 │ 2.调用支付宝    │
     │                 │   手机网站支付  │
     │                 │────────────────→│
     │                 │                 │
     │                 │ 3.返回支付链接  │
     │                 │←────────────────│
     │                 │                 │
     │ 4.返回支付URL   │                 │
     │←────────────────│                 │
     │                 │                 │
     │ 5.跳转支付宝收银台                │
     │───────────────────────────────────→│
     │                 │                 │
     │ 6.完成支付      │                 │
     │←───────────────────────────────────│
     │                 │                 │
     │                 │ 7.异步通知       │
     │                 │←────────────────│
     │                 │                 │
     │ 8.跳转结果页    │                 │
     │←────────────────│                 │
     │                 │                 │

3.2 流程说明

1. 下单请求：用户在智源论坛 H5页面提交订单
2. 服务端下单：服务端调用支付宝 alipay.trade.wap.pay 接口
3. 返回支付URL：支付宝返回包含支付信息的表单HTML
4. 页面跳转：商户前端通过form表单自动跳转到支付宝收银台
5. 用户支付：用户在支付宝收银台完成支付
6. 同步回调：支付成功后跳转回商户return_url
7. 异步通知：支付宝通过notify_url通知商户支付结果

四、商户号申请

4.1 申请条件

• 持有有效的工商营业执照（企业或个体工商户）
• 法人身份证（正反面）
• 对公银行账户或法人个人银行账户
• 已完成ICP备案的网站
• 网站内容健康、符合法律法规

4.2 申请步骤

1. 访问 支付宝商家中心
2. 注册并登录商家账号，完成实名认证
3. 提交营业执照、法人证件、银行账户等资料
4. 创建应用，选择"手机网站支付"能力
5. 等待审核（一般1-3个工作日）
6. 审核通过后获取 APPID、支付宝公钥、应用私钥
7. 配置回调地址，进入开发阶段

4.3 申请材料清单

五、API接口说明

5.1 手机网站支付接口

接口名称： alipay.trade.wap.pay

接口功能：商户通过该接口发起手机网站支付请求，支付宝返回支付表单HTML或支付链接。

5.2 主要请求参数

5.3 biz_content 业务参数

{
  "out_trade_no": "20260920123456",   // 商户订单号
  "product_code": "QUICK_WAP_WAY",   // 产品码，固定值
  "total_amount": "99.00",           // 订单金额（元）
  "subject": "智源论坛付费课程",      // 订单标题
  "body": "Vue3组合式API完全指南",    // 订单描述
  "passback_params": "user_id=123",  // 回传参数
  "extend_params": {
    "sys_service_provider_id": "2088***"  // 服务商ID
  }
}

5.4 示例代码（Java）

import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.request.AlipayTradeWapPayRequest;

// 初始化AlipayClient
AlipayClient alipayClient = new DefaultAlipayClient(
    "https://openapi.alipay.com/gateway.do",
    APP_ID,           // 应用ID
    APP_PRIVATE_KEY,  // 应用私钥
    "json",
    "UTF-8",
    ALIPAY_PUBLIC_KEY, // 支付宝公钥
    "RSA2"
);

// 创建支付请求
AlipayTradeWapPayRequest request = new AlipayTradeWapPayRequest();
request.setNotifyUrl(NOTIFY_URL);
request.setReturnUrl(RETURN_URL);

// 设置业务参数
request.setBizContent("{" +
    "\"out_trade_no\":\"" + outTradeNo + "\"," +
    "\"total_amount\":\"99.00\"," +
    "\"subject\":\"智源论坛付费课程\"," +
    "\"product_code\":\"QUICK_WAP_WAY\"" +
    "}");

// 发起支付请求，获取支付表单HTML
String formHtml = alipayClient.pageExecute(request).getBody();

// 返回formHtml到浏览器自动跳转
response.setContentType("text/html;charset=UTF-8");
response.getWriter().write(formHtml);

六、安全说明

6.1 签名验证机制

• 使用RSA2（SHA256）签名算法
• 应用私钥用于签名，妥善保管
• 支付宝公钥用于验证支付宝回调签名

6.2 密钥管理

6.3 风险控制

• 验证所有支付宝回调的签名
• 检查订单金额、订单号一致性
• 实施幂等性处理，防止重复通知
• 记录所有交易日志

七、常见问题

Q1：H5支付和APP支付有什么区别？

A：H5支付适用于手机浏览器（包括支付宝外的浏览器），APP支付仅在原生APP内使用。本平台属于H5网站，使用手机网站支付。

Q2：支付宝费率是多少？

A：标准费率为0.6%，部分行业有特殊费率。可在商家中心查看具体费率。

Q3：结算到账时间？

A：T+1工作日到账。可申请实时到账功能（需满足条件）。

Q4：测试环境怎么对接？

A：支付宝提供沙箱环境（openapi.alipaydev.com），可使用沙箱账号进行支付流程测试。

Q5：H5支付为什么需要ICP备案？

A：根据监管要求，提供在线支付服务的网站必须完成ICP备案，确保网站合法合规。