# 预授权支付产品接入目录
## 产品简介
预授权支付指用户产生实际消费前,商家可以提前冻结用户一定资金作为押金,后续按实际消费金额从用户冻结资金中扣除给商家,剩余金额解冻返还用户的一种支付产品。
**核心特性**:
- 费率:预授权阶段免费,转支付阶段 0.6%-1%
- 结算:T+1日到账
- 退款:默认交易发生后12个月内可退款,退款资金原路退还,退款时手续费一并退还
- 支付工具:支付宝余额、银行卡(储蓄卡和信用卡)、花呗等
**典型场景**:
- 住宿:民宿/酒店
- 出行:传统租车/分时租赁/单车
- 租物:3C数码/充电宝/雨伞/手机/相机
**交易场景**:
- 线上场景:移动设备(App/H5)、小程序
- 线下场景:特定经营类目开放(酒旅景区、物流运输、零售批发、车主生活等)
**使用说明**:
- 商家开通产品时必须明确选择实际的交易场景
- 线下场所只针对特定经营类目开放
- 当在小程序使用时,交易场景要包含小程序场景,且调用接口的APPID需为小程序应用类型
- 商家分账产品默认按退款比例自动退分账
**准入条件**:
- 仅支持支付宝企业账号
- 小程序场景:需提供已创建的小程序APPID、小程序经营内容截图
- 移动设备:需提供已上线的APP、网站信息
- 线下场所:需提供经营场所照片、店铺名称、实际经营地址
---
## 文档目录与路由表
### 一、产品介绍
| 主题 | 文档链接 | 核心内容 |
| --- | --- | --- |
| 产品特色 | [产品介绍](https://ideservice.alipay.com/cms/site/0izajy) | 产品概述、典型场景、准入条件、费率 |
| 接入准备 | [接入准备](https://ideservice.alipay.com/cms/site/0izajz) | 创建应用、配置应用、开通产品 |
| 常见问题 | [常见问题](https://ideservice.alipay.com/cms/site/0izakp) | 预授权问题解答 |
### 二、接入指南
#### 线上场景
| 主题 | 文档链接 | 核心内容 |
| --- | --- | --- |
| 快速接入 | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) | 支付流程、冻结资金、转支付、解冻 |
| iOS集成流程 | [iOS集成](https://ideservice.alipay.com/cms/site/0izak3) | iOS客户端SDK集成 |
| Android集成流程 | [Android集成](https://ideservice.alipay.com/cms/site/0izak4) | Android客户端SDK集成 |
#### 线下场景
| 主题 | 文档链接 | 核心内容 |
| --- | --- | --- |
| 快速接入 | [快速接入](https://ideservice.alipay.com/cms/site/0izak6) | 商家扫用户付款码、用户扫商家二维码 |
### 三、相关资料
| 主题 | 文档链接 | 核心内容 |
| --- | --- | --- |
| 对账说明 | [对账说明](https://ideservice.alipay.com/cms/site/0izakr) | 账单下载方式 |
| 异步通知说明 | [异步通知](https://ideservice.alipay.com/cms/site/0izaks) | 异步通知参数、验签流程 |
| 支付渠道说明 | [支付渠道](https://ideservice.alipay.com/cms/site/0izakt) | 支持的支付渠道 |
| 沙箱调试说明 | [沙箱说明](https://ideservice.alipay.com/cms/site/0izaku) | 沙箱环境配置 |
### 四、API接口列表
#### 预授权接口
| 接口名称 | 接口英文名 | 文档链接 | 用途 |
| --- | --- | --- | --- |
| 小程序支付接口 | my.tradePay | [接口文档](https://ideservice.alipay.com/cms/site/0iziyf) | 客户端唤起支付收银台 |
| 线上资金授权冻结接口 | alipay.fund.auth.order.app.freeze | [接口文档](https://ideservice.alipay.com/cms/site/0izg0g) | 线上场景冻结资金 |
| 资金授权冻结接口 | alipay.fund.auth.order.freeze | [接口文档](https://ideservice.alipay.com/cms/site/0iziyh) | 线下场景冻结资金 |
| 资金授权操作查询接口 | alipay.fund.auth.operation.detail.query | [接口文档](https://ideservice.alipay.com/cms/site/0izcu9) | 查询授权状态 |
| 资金授权撤销接口 | alipay.fund.auth.operation.cancel | [接口文档](https://ideservice.alipay.com/cms/site/0iziyg) | 撤销授权 |
| 资金授权解冻接口 | alipay.fund.auth.order.unfreeze | [接口文档](https://ideservice.alipay.com/cms/site/0izg0h) | 解冻剩余资金 |
| 资金授权发码接口 | alipay.fund.auth.order.voucher.create | [接口文档](https://ideservice.alipay.com/cms/site/0izf6b) | 生成授权二维码 |
#### 交易接口
| 接口名称 | 接口英文名 | 文档链接 | 用途 |
| --- | --- | --- | --- |
| 统一收单交易支付接口 | alipay.trade.pay | [接口文档](https://ideservice.alipay.com/cms/site/0izg0i) | 转支付扣款 |
| 统一收单交易查询接口 | alipay.trade.query | [接口文档](https://ideservice.alipay.com/cms/site/0izhis) | 查询交易状态 |
| 统一收单交易退款接口 | alipay.trade.refund | [接口文档](https://ideservice.alipay.com/cms/site/0iziyj) | 发起退款 |
| 统一收单交易退款查询接口 | alipay.trade.fastpay.refund.query | [接口文档](https://ideservice.alipay.com/cms/site/0izhir) | 查询退款状态 |
| 统一收单交易关闭接口 | alipay.trade.close | [接口文档](https://ideservice.alipay.com/cms/site/0izhiq) | 关闭订单 |
---
## 核心接入流程
> 📖 详见:[线上场景快速接入](https://ideservice.alipay.com/cms/site/0izak2) | [线下场景快速接入](https://ideservice.alipay.com/cms/site/0izak6)
**关键流程说明**:
1. 冻结资金:调用冻结接口冻结用户资金作为押金
2. 服务完成:用户消费完成后,进行转支付扣款
3. 转支付:从冻结资金中扣除消费金额
4. 解冻:剩余金额解冻返还用户
---
## 开发者核心关注要点
| 关注点 | 说明 | 文档链接 |
| --- | --- | --- |
| 交易场景选择 | 开通产品时必须选择实际交易场景,否则不允许交易 | [产品介绍](https://ideservice.alipay.com/cms/site/0izajy) |
| 线下场景限制 | 仅特定经营类目开放(酒店、租车、3C数码等) | [产品介绍](https://ideservice.alipay.com/cms/site/0izajy) |
| 冻结金额预估 | 需根据业务合理预估,支持一次授权多次扣款,累计扣款不能超过冻结金额 | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) |
| 小程序场景 | 交易场景需包含小程序,且APPID需为小程序应用类型 | [产品介绍](https://ideservice.alipay.com/cms/site/0izajy) |
| 结算周期 | T+1日到账,当日资金在对账中心不可用余额中查看 | [产品介绍](https://ideservice.alipay.com/cms/site/0izajy) |
| 线上vs线下冻结接口 | 线上场景使用alipay.fund.auth.order.app.freeze,线下场景使用alipay.fund.auth.order.freeze | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) |
| auth_confirm_mode | 转支付时传COMPLETE表示同时解冻剩余资金,NOT_COMPLETE表示不解冻需单独解冻 | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) |
| 解冻remark说明 | 解冻接口的remark参数会展示在用户的账单详情中 | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) |
| 撤销vs解冻 | 撤销仅用于冻结超时或结果未知时,正常业务场景应使用解冻 | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) |
| 转支付后解冻 | 若auth_confirm_mode=NOT_COMPLETE,转支付后需立即解冻剩余资金 | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) |
| 解冻幂等规则 | 解冻接口支持幂等,out_request_no相同的请求只执行一次 | [快速接入](https://ideservice.alipay.com/cms/site/0izak2) |
| extra_param类目 | 线下场景需传category字段:CHARGE_PILE_CAR(充电桩)、HOTEL(酒店)、TRAD_RENT_CAR(租车) | [快速接入](https://ideservice.alipay.com/cms/site/0izak6) |
| 线下场景必传 | 线下资金授权场景需传store_id和terminal_id | [快速接入](https://ideservice.alipay.com/cms/site/0izak6) |
---
## SDK配置
| 配置模式 | 适用场景 | 文档链接 |
| --- | --- | --- |
| 公钥模式 | 普通接口调用 | [接入准备](https://ideservice.alipay.com/cms/site/0izajz) |
| 公钥证书模式 | 涉及资金支出接口(必选) | [接入准备](https://ideservice.alipay.com/cms/site/0izajz) |
---
## 沙箱环境
| 配置项 | 值 |
| --- | --- |
| 沙箱网关 | [https://openapi-sandbox.dl.alipaydev.com/gateway.do](https://openapi-sandbox.dl.alipaydev.com/gateway.do) |
| 沙箱说明 | [沙箱调试说明](https://ideservice.alipay.com/cms/site/0izaku) |
---
## 相关链接
| 名称 | 链接 |
| --- | --- |
| 支付宝开放平台 | [https://open.alipay.com/](https://open.alipay.com/) |
| 商家平台 | [https://b.alipay.com/](https://b.alipay.com/) |
| 产品开通情况查询 | [https://mrchportalweb.alipay.com/dynlink/productSign/signManage.htm](https://mrchportalweb.alipay.com/dynlink/productSign/signManage.htm) |
| 预授权支付产品开通 | [https://b.alipay.com/page/product-mall/product-detail/I1080300001000065324](https://b.alipay.com/page/product-mall/product-detail/I1080300001000065324) |