# APP支付产品接入目录 ## 产品简介 APP支付是指商家在商家移动端 App 中集成支付宝 SDK，调起支付宝来完成付款的一种支付产品。适用于在商家移动端 App 内使用支付宝支付功能的场景。该产品在签约完成后，需要技术集成完成后方可使用。
**核心特性**： - 费率：单笔收费 0.6%-1.0%（一般行业0.6%，特殊行业1.0%） - 结算：实时到账（新签约商家有90日或连续交易30日的结算周期限制） - 退款：默认交易发生后12个月内可退款，退款资金原路退还 - 支付工具：支付宝余额、银行卡(储蓄卡和信用卡)、花呗、花呗分期等 **申请条件**： - 支持支付宝企业账号、个人账号、个体工商户 - 需提供应用名称和已上架的应用市场，或Demo/产品说明文档 - 应用必须包含明确的经营内容和价格信息 --- ## 文档目录与路由表 ### 一、产品介绍 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 产品特色 | [产品介绍](https://ideservice.alipay.com/cms/site/0izcs9) | 产品概述、申请条件、费率、结算规则 | | 接入准备 | [接入准备](https://ideservice.alipay.com/cms/site/0izcsa) | 商家自研接入、服务商代开发接入流程 | | 常见问题 | [常见问题](https://ideservice.alipay.com/cms/site/0izct7) | 支付问题、退款问题解答 | ### 二、接入指南 #### 基础功能 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 界面规范 | [界面规范](https://ideservice.alipay.com/cms/site/0izcsd) | 支付界面设计规范 | | APP支付快速接入 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | 整体交互流程、服务端/客户端集成 | | iOS集成流程 | [iOS集成](https://ideservice.alipay.com/cms/site/0izcsf) | iOS客户端SDK集成 | | Android集成流程 | [Android集成](https://ideservice.alipay.com/cms/site/0izcsg) | Android客户端SDK集成 | | Harmony单框架集成 | [Harmony集成](https://ideservice.alipay.com/cms/site/0izcsh) | 鸿蒙系统SDK集成 | | 鸿蒙SDK接入说明 | [鸿蒙SDK](https://ideservice.alipay.com/cms/site/0izcsi) | 鸿蒙SDK详细说明 | | 同步通知说明 | [同步通知](https://ideservice.alipay.com/cms/site/0izcsj) | 客户端回调处理 | | 异步通知说明 | [异步通知](https://ideservice.alipay.com/cms/site/0izcsk) | 服务端异步通知处理 | #### 扩展功能 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 手机网站支付转APP支付 | [转换说明](https://ideservice.alipay.com/cms/site/0izcsn) | H5转APP支付接入 | | APP支付接入花呗分期 | [花呗分期](https://ideservice.alipay.com/cms/site/0izcso) | 花呗分期集成 | | 对账说明 | [对账说明](https://ideservice.alipay.com/cms/site/0izcsq) | 账单下载方式 | #### 集成工具 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 沙箱调试说明 | [沙箱说明](https://ideservice.alipay.com/cms/site/0izcsv) | 沙箱环境配置、调试注意事项 | | App支付客户端DEMO&SDK | [SDK获取](https://ideservice.alipay.com/cms/site/0izvui) | iOS/Android SDK下载 | ### 三、API接口列表 | 接口名称 | 接口英文名 | 文档链接 | 用途 | | --- | --- | --- | --- | | app支付接口2.0 | alipay.trade.app.pay | [接口文档](https://ideservice.alipay.com/cms/site/0izofu) | 生成支付订单字符串 | | 统一收单交易查询接口 | alipay.trade.query | [接口文档](https://ideservice.alipay.com/cms/site/0izofw) | 查询订单状态 | | 统一收单交易退款接口 | alipay.trade.refund | [接口文档](https://ideservice.alipay.com/cms/site/0izl4f) | 发起退款 | | 统一收单交易退款查询接口 | alipay.trade.fastpay.refund.query | [接口文档](https://ideservice.alipay.com/cms/site/0izl4h) | 查询退款状态 | | 收单退款冲退完成通知接口 | alipay.trade.refund.depositback.completed | [接口文档](https://ideservice.alipay.com/cms/site/0izofv) | 银行卡退款通知 | | 统一收单交易关闭接口 | alipay.trade.close | [接口文档](https://ideservice.alipay.com/cms/site/0izl4g) | 关闭未支付订单 | | 查询对账单下载地址接口 | alipay.data.dataservice.bill.downloadurl.query | [接口文档](https://ideservice.alipay.com/cms/site/0izl4e) | 对账单下载 | --- ## 核心接入流程 > 📖 详见：[APP支付快速接入](https://ideservice.alipay.com/cms/site/0izcse) **关键流程说明**： 1. 用户在商户App客户端下单 2. 商户App客户端将订单信息发送到服务端 3. 商家服务端调用 alipay.trade.app.pay 获取 orderStr 4. 商家将 orderStr 发送给商户App客户端 5. 客户端使用 orderStr 唤起支付宝App进行支付 6. 支付完成后回调商户App，并发送异步通知 --- ## 开发者核心关注要点 | 关注点 | 说明 | 文档链接 | | --- | --- | --- | | 服务端签名 | 签名必须在服务端完成，私钥绝不能保存在客户端 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | orderStr | 服务端生成的orderStr只是加签数据，需客户端请求后支付宝才会收到订单信息 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | 订单创建时机 | 订单在用户输入正确支付密码后创建，并非唤起收银台时创建 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | 支付超时 | 订单创建后默认15天内未支付自动关闭，可设置5min～15d | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | 支付结果判断 | 需依赖异步通知+查询方式判断，不能仅依赖同步返回 | [异步通知](https://ideservice.alipay.com/cms/site/0izcsk) | | 客户端回调 | App支付通过客户端配置完成回调，return_url设置不生效 | [同步通知](https://ideservice.alipay.com/cms/site/0izcsj) | | subject限制 | 订单标题不能使用特殊字符：/、=、& 等 | [接口文档](https://ideservice.alipay.com/cms/site/0izofu) | | 客户端数据不可信 | total_amount等金额必须在服务端校验，客户端数据不可信任 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | 交易状态判断 | 查询接口返回trade_status为TRADE_SUCCESS或TRADE_FINISHED才确认支付成功 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | resultStatus返回码 | 9000支付成功，8000/6004待处理，6001用户取消，6002网络错误，4000支付失败 | [同步通知](https://ideservice.alipay.com/cms/site/0izcsj) | | 同步回调验证 | 验签后还需校验out_trade_no、total_amount、seller_id、app_id是否匹配 | [同步通知](https://ideservice.alipay.com/cms/site/0izcsj) | | 异步通知重试 | 重试频率：4m、10m、10m、1h、2h、6h、15h | [异步通知](https://ideservice.alipay.com/cms/site/0izcsk) | | 异步通知响应 | 必须响应success，否则支付宝会持续重发通知 | [异步通知](https://ideservice.alipay.com/cms/site/0izcsk) | | 退款判断 | fund_change=Y表示本次退款成功，同订单多次退款后续返回N需通过查询接口确认 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | 退款期限 | 默认交易发生后12个月内可退款 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | | 退款手续费 | 退款时手续费不退回 | [快速接入](https://ideservice.alipay.com/cms/site/0izcse) | --- ## SDK配置 | 配置模式 | 适用场景 | 文档链接 | | --- | --- | --- | | 公钥模式 | 普通接口调用 | [接入准备](https://ideservice.alipay.com/cms/site/0izcsa) | | 公钥证书模式 | 涉及资金支出接口（必选） | [接入准备](https://ideservice.alipay.com/cms/site/0izcsa) | **客户端SDK下载**： | 平台 | 文档链接 | | --- | --- | | iOS | [iOS SDK](https://ideservice.alipay.com/cms/site/0izvui) | | Android | [Android SDK](https://ideservice.alipay.com/cms/site/0izvui) | | Harmony | [Harmony SDK](https://ideservice.alipay.com/cms/site/0izcsh) | --- ## 沙箱环境 | 配置项 | 值 | | --- | --- | | 沙箱网关 | [https://openapi-sandbox.dl.alipaydev.com/gateway.do](https://openapi-sandbox.dl.alipaydev.com/gateway.do) | | 沙箱说明 | [沙箱调试说明](https://ideservice.alipay.com/cms/site/0izcsv) | --- ## 相关链接 | 名称 | 链接 | | --- | --- | | 支付宝开放平台 | [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) | | APP支付产品开通 | [https://b.alipay.com/page/product-mall/product-detail/I1080300001000041313](https://b.alipay.com/page/product-mall/product-detail/I1080300001000041313) | | Universal Links配置 | [配置说明](https://ideservice.alipay.com/cms/site/0izct9) |