微信支付_APP支付（IOS）接口文档V1.7.pdf

###微信支付_APP支付（IOS）接口文档V1.7.pdf ####一、微信支付简介**1.1功能简介**微信APP支付是一种便捷的支付方式，允许用户在第三方应用程序内直接通过微信支付完成交易。此支付方式不仅提高了交易效率，还提升了用户体验。微信APP支付适用于各种类型的商户，无论大小，都能方便地集成这一支付功能。 **1.2平台帐号注册** ##### 1.2.1申请流程指引图在正式接入微信支付前，需要完成一系列的注册和审核步骤。开发者需在微信开放平台提交移动应用，并等待审核通过。这一过程包括： - **登录微信开放平台**：访问微信开放平台网站，注册并登录。 - **添加移动应用**：在平台上添加自己的移动应用，提交必要的信息，等待审核。 - **申请支付功能**：审核通过后，在微信开放平台-管理中心为该移动应用申请支付功能，并提交所需的资料。 ##### 1.2.2申请接入步骤详细说明- **步骤A**：提交移动应用审核。目前，微信支付只对已通过微信开放平台审核的APP开放支付功能申请入口。因此，第一步是登录微信开放平台，添加移动应用并等待审核。 - **步骤B**：申请支付功能。一旦移动应用审核通过，开发者可以在微信开放平台-管理中心为该应用申请支付功能，并提交相关的资料。 - **步骤C**：等待审核结果。提交相关资料后，微信团队将在7个工作日内完成审核，并将结果发送至开放平台的通知中心以及商户在申请时填写的邮箱地址。 **1.3支付账户**完成上述步骤并通过审核后，开发者将获得一组用于支付功能的账户资料，这些资料包括但不限于： - **appId**：在微信开放平台查看，用于标识申请的应用。 - **paySignKey**：支付请求中用于加密的密钥Key，可以验证商户的身份。审核通过后，可以在微信发送的邮件中查看。 - **appSecret**：除了支付请求需要用到paySignKey外，API的权限获取也需要使用此密钥Key。在使用所有公众平台API时，都需要先用它换取access_token，然后再进行调用。可在开放平台中查看。 - **partnerId**：财付通商户身份的标识。 - **partnerKey**：财付通商户权限密钥Key。注意：**appSecret、paySignKey、partnerKey**是验证商户唯一性的安全标识，需要妥善保管。**appSecret**和**paySignKey**的主要区别在于用途不同：**appSecret**主要用于获取API权限的access_token，而**paySignKey**用于支付请求中的加密。 ####二、微信APP支付接入**2.1系统架构**微信APP支付的系统架构涉及以下几个方面： -用户在第三方应用内选择商品或服务后，点击支付按钮。 -第三方应用向自己的服务器发起支付请求，传递订单信息。 -服务器处理订单信息，并调用微信支付API生成预支付订单。 -服务器将预支付订单的信息（包括支付签名等）返回给客户端。 -客户端接收到信息后，调用微信支付SDK完成支付操作。 **2.2基本交互**微信APP支付的基本交互流程如下： -用户在第三方应用内选择商品或服务。 -用户点击支付按钮后，第三方应用将订单信息发送给其服务器。 -服务器处理订单信息，调用微信支付API生成预支付订单。 -服务器将预支付订单的相关参数返回给客户端。 -客户端调用微信支付SDK，完成支付操作。 **2.3支付功能开发介绍**开发微信APP支付功能主要包括以下几个步骤： - **初始化设置**：配置应用的基础信息，如appid等。 - **注册APPID**：在应用内注册商户的APPID。 - **调起支付**：使用服务器返回的参数调起支付功能。 ####三、接口介绍**3.1获取access_token**为了使用微信支付API，首先需要获取access_token。这一步骤通常通过使用appSecret调用API来实现。 **3.2生成预支付订单**生成预支付订单是支付流程中的关键步骤之一。它涉及到与微信支付服务器交互，以创建一个预支付订单。这一步骤通常包括以下内容： - **参数准备**：准备必要的订单参数，如商品描述、金额等。 - **调用API**：使用获取到的access_token调用微信支付API生成预支付订单。 **3.3订单详情（package）扩展字符串定义**订单详情（package）扩展字符串是指用于封装预支付订单信息的一个特定格式的字符串。这个字符串包含了预支付订单的关键信息，如订单号、商品描述等，它是后续支付过程中必不可少的一部分。 **3.4支付签名（app_signature）生成方法**支付签名（app_signature）用于确保支付请求的安全性和完整性。生成方法通常包括： - **参数排序**：按照指定顺序对参数进行排序。 - **拼接字符串**：将排序后的参数拼接成一个字符串。 - **签名算法**：使用指定的算法（如HMAC-SHA256）计算签名。 **3.5添加prepayid再次签名**在生成了预支付订单后，还需要根据prepayid进行再次签名，以确保数据传输的安全性。 **3.6 APP端开发说明** APP端的开发说明主要包括： - **初始化设置**：配置应用的基础信息。 - **注册APPID**：在应用内注册商户的APPID。 - **调起支付**：使用服务器返回的参数调起支付功能。 ####四、通知接口说明**4.1通知接口简介**通知接口主要用于接收微信支付服务器发送的支付结果通知。这些通知包括支付成功、支付失败等情况。 **4.2补单机制**当支付结果通知未能正常接收时，可以通过补单机制重新获取支付结果。 **4.3通知接口参数**通知接口参数包括支付结果、订单号等信息，用于验证支付状态。 **4.4后台通知结果返回**当接收到支付结果通知时，商户需要向微信支付服务器返回确认信息。 **4.5后台通知签名方式**后台通知签名方式用于确保通知数据的完整性和安全性。 ####五、API接口说明**5.1 API接口简介** API接口是用于与微信支付服务器交互的一组标准接口集合。 **5.2 API列表** API列表包括： - **发货通知delivernotify**：用于通知微信支付服务器发货信息。 - **订单查询orderquery**：用于查询订单的状态。 ####六、常见问题和注意事项**6.1帮助SDK**提供了一套完整的SDK文档和技术支持，帮助开发者快速接入微信支付功能。 **6.2常见基本概念疑惑**解释了一些关于微信支付的基本概念，帮助开发者更好地理解支付流程。 **6.3常见错误现象及解决方法**列出了常见的错误现象及其解决方案，帮助开发者排除故障。 **6.4常见注意事项**提供了一系列在开发过程中需要注意的事项，确保支付功能的稳定运行。 **6.5最新接口文档下载**提供了最新版本的接口文档下载链接，便于开发者获取最新的文档信息。 **6.6联系我们**提供了官方联系方式，以便在遇到问题时能够及时得到技术支持。