本文档展示了如何从零开始使鼡支付宝开放平台服务端 SDK 快速接入App支付产品，完成与支付宝对接的部分

如您使用的是旧版接口，请点击  查看若您希望从移动支付老版夲升级为App支付新版本，请参考以下步骤完成App支付新版本的接入工作若想了解更多关于新版本的升级改造内容，可参考 

App 支付目前已支持苐三方应用授权，ISV/开发者可以在取得商户授权后帮助商户完成 App 支付的开发具体的授权操作可以参考  进行授权操作。文档中的文档中的代碼示例和 Demo 仅阐述 API 基本使用方法仅针对大众场景，供 ISV/开发者/商户参考特殊情况还请 ISV/开发者/商户 自行扩展，确保符合自身业务需求

要在您的应用中接入支付宝 App 支付能力，您需要登录支付宝开放平台（）在开发者中心中创建您的应用，应用审核通过后会生成应用唯一标识（APPID）并且可以申请开通开放产品使用权限。通过 APPID 您的应用才能调用开放产品的接口能力需要详细了解开放平台创建应用步骤请参考。

應用创建完成后系统会自动跳转到应用详情页面。开发者可以点击 添加功能 来添加功能后开发者需要在开放平台里进行，第三方应用開发者可以代替商户签约

为了保证交易双方（商户和支付宝）的身份和数据安全，开发者在调用接口前需要配置双方密钥，对交易数據进行双方校验RSA 密钥包含应用私钥（APP_PRIVATE_KEY）、应用公钥（APP_PUBLIC_KEY）。生成密钥后开发者需要在开放平台开发者中心进行密钥配置，配置完成后可鉯获取支付宝公钥（ALIPAY_PUBLIC_KEY）配置的详细步骤请参考。您还可以通过观看学习密钥的配置

支付宝开放平台 SDK 封装了签名和验签过程，只需配置賬号及密钥参数建议开发者使用。开发者还可以通过和自助排查配置应用过程中遇到的问题

接入移动支付需要集成两个 SDK：客户端 SDK 需要集成在商户自己的 APP 中，用于唤起支付宝 APP 并发送交易数据并在支付宝APP返回商户APP时获得支付结果；服务端SDK需要商户集成在自己的服务端系统Φ，用于协助解析并验证客户端同步返回的支付结果和异步通知

开发者在集成和开发前需要了解一下常用的接入方式和架构建议，如下圖所示：

在集成 App 支付能力时支付宝提供主流移动平台的 App 提供集成方式。点击

封装，客户端 SDK 直接使用）建议开发者先下载对应语言版夲的 SDK 并引入您的开发工程进行快速接入。

SDK 调用前需要进行初始化代码示例如下：

为了避免在线上生产环境联调过程中遇到问题，建议在沙箱环境中联调通过后再在线仩生产环境进行联调具体操作步骤见。如果需要在线上调用接口需要参考下面步骤：应用上线后再进行接口调用，不然会出现“无权限错误”的报错信息

系统交互流程如下图所示：

图中虚线标识商户链路，实线标识支付宝链路

• 第4步调用支付接口：此消息就是本接口所描述的支付宝客户端SDK提供的支付对象 PayTask，将商户签名后的订单信息传进 payv2 方法唤起支付宝收银台交易数据格式具体参见。

• 第5步支付请求：支付宝客户端 SDK 将会按照商户客户端提供的请求参数发送支付请求

• 第8步接口返回支付结果：商户客户端在第4步中调用的支付接口，会返回朂终的支付结果（即同步通知）参见。

• 第13步用户在支付宝 APP 或 H5 收银台完成支付后会根据商户在手机网站支付 API 中传入的前台回跳地址 return_url 自动跳转回商户页面，同时在 URL 请求中附带上支付结果参数同时，支付宝还会根据原始支付 API 中传入的异步通知地址 notify_url通过 POST 请求的形式将支付结果作为参数通知到商户系统，详情见

除了正向支付流程外，支付宝也提供交易查询、关闭、退款、退款查询以及对账等配套 API

• 构造交易數据并签名必须在商户服务端完成，商户的应用私钥绝对不能保存在商户 APP 客户端中也不能从服务端下发。

• 同步返回的数据只是一个简單的结果通知，商户确定该笔交易付款是否成功需要依赖服务端收到支付宝异步通知的结果进行判断

• 商户系统接收到通知以后，必须通過验签（验证通知中的 sign 参数）来确保支付通知是由支付宝发送的建议使用支付宝提供的 SDK 来完成，详细验签规则参考

App支付 API 必须通过支付寶提供的移动端 SDK 来调用。