# 预授权支付产品接入目录 ## 产品简介 预授权支付指用户产生实际消费前,商家可以提前冻结用户一定资金作为押金,后续按实际消费金额从用户冻结资金中扣除给商家,剩余金额解冻返还用户的一种支付产品。
**核心特性**: - 费率:预授权阶段免费,转支付阶段 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) |