支付宝
通道概述
支付宝是国内最大的第三方支付平台。DaxPay 支持支付宝直连与服务商(ISV)两种接入模式,方式覆盖扫码、JSAPI、APP、H5、PC 网页与付款码六类,并支持分账接收方绑定与转账。
支付宝(直连)从通道侧准备到密钥配置的完整对接教程(含沙箱联调、公钥/证书双模式说明)见支付通道对接,本文是参数与结构的速查参考。
支付的支付产品
| 支付产品 | 接入模式 | 适用身份 |
|---|---|---|
alipay(直连) | 商户直连 | 有自己支付宝商户号的商户 |
alipay_isv(服务商) | 服务商代子商户发起 | 服务商帮旗下特约商户收款 |
支持的支付方式
| 支付方式 | 说明 | 前提 |
|---|---|---|
alipay_qr(扫码) | 返回二维码,用户扫码支付 | — |
alipay_jsapi(JSAPI) | 支付宝端内调起,含小程序场景 | 需 openId;应用类型须为小程序 |
alipay_app(APP) | 商户 APP 内调起支付宝 | 应用类型须为移动应用 |
alipay_h5(H5) | 手机网页内完成支付 | — |
alipay_pc(PC 网页) | 电脑网站支付 | — |
alipay_barcode(付款码) | 商户扫用户付款码 | — |
配置结构
支付宝的配置按「通道商户 → 应用 → 应用密钥」三层组织,密钥按应用维度配置,不是通道商户级一份:
- 创建通道商户:商户工作台 → 通道商户 → 创建通道商户,选支付产品后填写:
- 直连:商户名称 + 支付宝商家用户 ID(
2088开头的 PID) - 服务商:商户名称 + 支付宝应用(下拉选择)+ 子商户号 + 应用授权令牌(可后补)
- 直连:商户名称 + 支付宝商家用户 ID(
- 登记应用(直连在通道商户详情 → 应用管理;服务商在「支付宝服务商应用」页面维护):应用名称、应用类型(小程序 / 移动应用 / 网站应用)、支付宝应用 ID(AppId)
- 配置应用密钥:应用详情 → 密钥配置,认证方式二选一:
| 分组 | 字段 | 说明 |
|---|---|---|
| 基础配置 | 环境 | 生产 / 沙箱 |
| 应用 ID | 支付宝 AppId | |
| 认证方式 | 公钥模式 或 证书模式 | |
| 密钥配置(公钥模式) | 支付宝公钥 | 开放平台「开放平台密钥」页获取 |
| 应用私钥 | 密钥工具生成的商户私钥 | |
| 证书模式 | 应用公钥证书 / 支付宝公钥证书 / 支付宝根证书 | 三个证书缺一不可,安全性更高 |
| 通信密钥 | 通信密钥(AES) | 可选,接口加密场景 |
回调处理
- 异步通知由支付宝服务端 POST 到回调地址,平台完成验签与订单更新后应答
success; - 「等待买家付款」(
WAIT_BUYER_PAY)是中间态通知,不是支付成功,平台记录后忽略; - 回调地址由平台统一生成,无需在支付宝开放平台逐应用配置。
注意事项
- 先切环境再建商户:沙箱与生产要各建一套通道商户,环境不匹配的商户会被路由排除;
- 证书模式更安全,建议生产环境使用;
- JSAPI 支付依赖 openId,须用小程序类型的应用承接;
- 服务商模式下子商户的授权令牌会过期,可在通道商户详情「应用授权令牌」处手动更新或走代运营授权;
- 常见问题见 FAQ。