_注：本指南，面向代商家研发小程序，升级已上架小程序的支付产品（使用当面付、App支付等原支付产品，升级为三款小程序支付产品）的服务商。_
## 简介
为帮助您准确选择小程序收款场景下的支付产品，获得更加全面的经营效果分析，同时优化您的客户在小程序内的下单体验，支付宝全新推出三款小程序的支付产品：“JSAPI支付”、“预授权支付”和“商家扣款”。
即日起，您可根据小程序的收款场景选择：
| 收款场景 | 适用行业 | 原支付产品 | 新支付产品 |
| --- | --- | --- | --- |
| 用户在小程序里选择购买商品，通过支付宝收银台，输入支付密码，完成支付。
 | 适用于扫码点餐、电商购物等 | 当面付、APP支付、手机网站支付等 | [JSAPI支付](https://opendocs.alipay.com/mini/05x9ku) |
| 用户产生实际消费前，商家可以提前冻结用户的一部分资金作为“押金”，在用户实际消费发生后，商家再根据实际消费金额，向支付宝发出指令，从用户账户的“押金”中扣除。
 | 适用于押金、预存场景，如住宿（民宿/酒店）、出行（传统租车/分时租赁/单车）、租物（3C 数码/充电宝/雨伞/手机/相机）等多个行业品类。 | 支付宝预授权 | [预授权支付](https://opendocs.alipay.com/open/064jh5) |
| 用户只需授权商家端进行扣款，授权成功后商家获取授权扣款协议号，后续按照约定的扣款规则进行自动扣款。
 | 适用于周期自动扣款的业务和场景，例如会员费自动续费，周期租赁费、定期还款、定期缴费等。 | 周期扣款、商户代扣 | [商家扣款](https://opendocs.alipay.com/mini/repo-0243dw) |
若您的小程序已使用上述原支付产品，可按需升级成新产品。
## 总览
**我是服务商，代商家开发新的小程序：**
|
**升级步骤** | **1** | | **2** | 3 | 4 | 5 | 6 |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: | --- |
| | **产品开通（签约）** | | **商户号关联小程序AppID** | **商家授权** | **集成验证** | **审核上架小程序** | **查看小程序交易数据** |
| **具体操作** | **服务商代商家开通（商家已开通产品，可忽略）** | **支付宝代升级开通** | **商家自助关联；**
**服务商代商家关联** | **在“授权产品范围”中添加支付产品，并发起商家授权。** | **集成支付产品;**
**验证支付功能** | **服务商代提交审核（按需）** | **服务商代运营查看交易数据** |
其他场景，请查看 [升级总览](https://opendocs.alipay.com/mini/08e1af#%E6%80%BB%E8%A7%88)。
## 升级步骤
### 1. 产品开通（签约）
服务商在授权产品范围中添加产品，并发起商家授权，商家开通产品。
商户签约准入条件：
1. 完成小程序创建，可使用当前商家账号名下小程序或其他账号名下小程序开通产品；使用其他账号名下小程序时，需要小程序归属商家账号确认授权；开通产品的商家账号，可管理用于哪些小程序收款；
2. 若提供的小程序未上架，可先上传小程序截图完成产品的开通，并在开通后30天内完成小程序上架并补全信息，以免影响后续收款；
3. 无需提供线下经营地址和门头照。
#### 1.1 服务商代商家开通
开通路径：[服务商平台-服务商运营-特约商户授权产品](https://p.alipay.com/page/product/client-merchant)-支付产品（**注意：**如果是直付通模式，暂不支持自助开通，请联系支付宝业务人员代为开通）
选择商家列表中的商家“申请开通”，或者“向新的商家发起申请”：
选择（或确认）经营信息和交易场景，并提供小程序的具体信息，根据商家经营类目的不同，签约时所需要提交的资料以页面提示为准。
服务商可在“服务商运营-特约商户授权产品-商家列表”中查看产品开通状态
若商家需要查看开通信息，可引导商家登录“商家平台-产品中心”，点击JSAPI支付产品详情页面查看开通状态和开通详情。
此外，JSAPI支付 支持服务商接口代开通，详见[接口](https://opendocs.alipay.com/isv/04f527?pathHash=0dfc5cd9)
**1.2 支付宝代升级开通**
为了便利您的操作，我们也将在近期帮符合平台规则的商户统一升级开通小程序场景专用支付产品，具体升级时间，您的商家可关注支付宝平台的通知。收到通知后，您和商家需要完成后续步骤的操作以完成完整升级。
升级开通成功后，您的商家可以前往商家平台查看开通详情，具体操作路径：[商家平台-产品中心](https://b.alipay.com/page/product-mall/all-product)，选择支付产品[JSAPI支付](https://b.alipay.com/page/product-mall/product-detail/I1080300001000060370)：
服务商可以在服务商平台查看具体商户的升级开通详情，具体操作路径：[服务商平台-服务商运营-特约商户授权产品](https://p.alipay.com/page/product/client-merchant)-支付产品-JSAPI支付：
备注：如你是商户的支付服务商，针对支付宝代升级开通的JSAPI支付产品也可以进行相应费率调整：
### 2. 商户号关联小程序AppID
功能说明：管理商户号与小程序的支付收单关系。
基本规则：
1）小程序使用开通小程序支付产品的商户号收款，且需要完成商户号关联小程序AppID；
2）关联同一商户号名下、同一公司主体名下或已有品牌授权关系商家主体名下的小程序，申请后即关联；关联其他公司主体的小程序，需要小程序归属商家确认授权，待小程序归属商家在商家平台-待办通知或支付宝App端-消息中完成确认授权后即关联。
关联入口：
1）商户号开通JSAPI支付时，填写小程序AppID；
2）商户号开通JSAPI支付后，可在JSAPI支付产品详情页面继续管理（新增关联AppID、查看商家授权状态）。
#### 2.1 开通JSAPI支付产品时关联
开通JSAPI支付产品（服务商代开通或商户自助开通）时，声明小程序AppID，即发起商户号关联小程序AppID；
#### 2.2 商户号关联小程序管理
开通JSAPI支付产品后（商家自助开通、服务商代开通、支付宝商务经理开通3种渠道选其一），商家在商家平台-产品中心-支付产品-[JSAPI支付产品详情页面](https://b.alipay.com/page/product-mall/product-detail/I1080300001000060370) 管理商户号关联的小程序AppID，查看已关联的小程序AppID及状态；
新增关联请点击“添加关联小程序APPID”：
商户号发起关联：
待关联的小程序AppID列表，是当前账号名下的小程序，可快捷操作关联。
#### 2.3 服务商代商户号关联小程序
服务商代商户开通产品后，可在商家列表页-操作项“关联小程序”入口管理。
#### 2.4 小程序商家确认授权
关联其他公司主体的小程序AppID，需要小程序归属商家确认授权。商户号发起申请后，小程序主体的商家账号登录商家平台-首页-待办中心 或支付宝App端-消息，确认授权，授权后商户号才能在小程序内收款。
### 3. 商家授权
若商家小程序由商家在支付宝商家平台自助创建，服务商代开发需要商家授权给服务商的第三方应用。
操作步骤：
1. 服务商登录 [支付宝开放平台](https://open.alipay.com/) > **第三方应用** > **商家授权** > **授权范围选择** 页面，选择对应产品。
2. 服务商根据 [第三方应用授权](https://opendocs.alipay.com/isv/10467/xldcyq) 指引，获取商家代开发授权，以此获取 `app_auth_token`（商家授权令牌）用于调用产品相关接口。
支持通过[接口](https://opendocs.alipay.com/isv/10467/xldcyq)发起/查询商家授权。
### 4. 集成支付产品并完成功能验证
#### 4.1 集成小程序支付产品
- **第三方应用未集成支付宝支付产品**
若服务商的第三方应用未集成支付宝支付产品（如当面付、App支付、手机网站支付、商户代扣等），请按小程序收款场景，查看以下集成文档，完成接入。
| 小程序支付产品 | 集成文档 |
| --- | --- |
| JSAPI支付 | [https://opendocs.alipay.com/mini/05x9ku?pathHash=a7b61cca](https://opendocs.alipay.com/mini/05x9ku?pathHash=a7b61cca) |
| 预授权支付 | [https://opendocs.alipay.com/open/064jh8?pathHash=7e4809e0&ref=api](https://opendocs.alipay.com/open/064jh8?pathHash=7e4809e0&ref=api) |
| 商家扣款 | [https://opendocs.alipay.com/open/08ayiq](https://opendocs.alipay.com/open/08ayiq) |
其中JSAPI支付，其[创单交易订单](https://opendocs.alipay.com/mini/05x9ku?ref=api#%E5%88%9B%E5%BB%BA%E4%BA%A4%E6%98%93%E8%AE%A2%E5%8D%95)接口的关键特性说明如下：
1. JSAPI支付的产品码传参product_code值为JSAPI_PAY；
2. 指定op_app_id，即小程序经营主体 APPID（指商户在小程序中，拉起收银台支付时，对应的小程序应用的 APPID）；发起创单交易订单的应用的商家账号与小程序经营主体要完成关联绑定，才能收款，即商户号关联小程序APPID；
3. 当商家需要在 [商家平台](http://b.alipay.com/)> **数据中心**（入口 1：**数据中心 **>** 交易中心 **>** 小程序交易**；入口 2：**数据中心 **> **小程序分析 **>** 交易**）中查看对应业务场景下的数据明细时，可以通过 business_params 对象的 tiny_app_merchant_biz_type 指定业务场景值，支持传入的值详见：[小程序细分业务场景](https://opendocs.alipay.com/mini/08by8k?pathHash=96e03412)。
- **第三方应用已集成支付宝支付产品**
若服务商的第三方应用集成过支付宝支付产品（如当面付、App支付、手机网站支付、商户代扣等），以下以当面付升级至JSAPI支付为例，升级第三方应用和商家小程序的支付产品：
**1，集成准备
**
完成产品开通、商户号关联AppID。
**2，接口集成**（按照以下步骤升级即可）
**JSAPI支付** 是专门用于小程序场景收款的产品，**当面付** 是一款可以在多个场景收款的产品。小程序场景中，**JSAPI支付** 使用的接口，和当面付使用的接口一样，区别在于两点：
- 区别一：**JSAPI支付** 使用的产品码不一样，需要注意更换 product_code 的参数，从 FACE_TO_FACE_PAYMENT 变更为 JSAPI_PAY。
- 区别二：**JSAPI支付** 增加了一个必传字段，op_app_id。该字段指商户在小程序中，拉起收银台支付时的小程序应用的 APPID。
- 区别三：当商户需要在 商家平台（[b.alipay.com](https://b.alipay.com/page/portal/home)）—数据中心（入口 1：数据中心 > 交易中心 > 小程序交易；入口 2：数据中心 > 小程序分析 > 交易） 中查看对应业务场景下的数据明细时，可以通过business_params对象的tiny_app_merchant_biz_type指定业务场景值，支持传入的值详见：[小程序细分业务场景](https://opendocs.alipay.com/mini/08by8k?pathHash=96e03412)。
**注意**：请勿修改 **当面付 **产品的其它接口，仅需修改 [alipay.trade.create](https://opendocs.alipay.com/open/02ekfp?scene=32)（统一收单交易创建接口），即可升级为 **JSAPI支付**。
| **序号** | **接入流程** | **使用的接口** | **当面付** | **JSAPI支付** |
| --- | --- | --- | --- | --- |
| 1 | 发送订单信息 | 调用 [my.request](https://docs.alipay.com/mini/api/owycmh) 接口 | - | 无变化 |
| 2 | 创建交易订单 | 调用 [alipay.trade.create](https://opendocs.alipay.com/mini/05x9kv?scene=de4d6a1e0c6e423b9eefa7c3a6dcb7a5&pathHash=779dc517)（统一收单交易创建接口） | product_code：FACE_TO_FACE_PAYMENT |
- product_code：JSAPI_PAY
- 新增字段：op_app_id（小程序支付中，商户实际经营主体的小程序应用的APPID，指在小程序中，拉起收银台支付时的小程序应用的APPID）
|
| 3 | 唤起收银台支付 | 调用 [my.tradePay](https://opendocs.alipay.com/mini/05xhsr?pathHash=d4709298)接口 | 无限制 | 必须调用 [my.tradePay](https://opendocs.alipay.com/mini/05xhsr?pathHash=d4709298) 接口才能唤起收银台 |
| 4 | 异步通知 | 在 [alipay.trade.create](https://opendocs.alipay.com/mini/05x9kv?scene=de4d6a1e0c6e423b9eefa7c3a6dcb7a5&pathHash=779dc517) 设置异步通知（notify_url） | - | 无变化 |
| 5 | 交易辅助（查询、退款、撤销、关闭） | 调用 [alipay.trade.query](https://opendocs.alipay.com/mini/05xsky?scene=common&pathHash=354e8be3)（统一收单线下交易查询接口）
调用 [alipay.trade.refund](https://opendocs.alipay.com/mini/05xskz?pathHash=b18b975d)（统一收单交易退款接口）
调用 [alipay.trade.cancel](https://opendocs.alipay.com/mini/05xunj?pathHash=ca2a9ea6)（统一收单交易撤销接口）
调用 [alipay.trade.close](https://opendocs.alipay.com/mini/05xhst?pathHash=f30ab879)（统一收单交易关闭接口） | - | 无变化 |
更多请查看 [JSAPI支付接口详情](https://opendocs.alipay.com/mini/05xhsr?pathHash=d4709298&ref=api)。
**预授权支付** 是支付宝预授权的升级产品。小程序场景中，**预授权支付** 使用的接口，和支付宝预授权使用的接口一样，区别在于两点：
- 区别一：**预授权支付** 使用的产品码不一样，需要注意更换 alipay.fund.auth.order.app.freeze(线上资金授权冻结接口)与alipay.trade.pay(统一收单交易支付接口)的product_code 的参数，从 PRE_AUTH_ONLINE 变更为 PREAUTH_PAY。
- 区别二：当在小程序场景使用时，开通预授权支付产品时，**交易场景要包含小程序场景，**且调用接口的appid需为**小程序应用类型**。
**注意**：请勿修改 **支付宝预授权 **产品的其它接口，仅需修改 [alipay.fund.auth.order.app.freeze(线上资金授权冻结接口)](https://opendocs.alipay.com/open/064jhe?pathHash=d577d80a&ref=api&scene=2a9ad7e9012248b0acd5edd04c9f31b6)与[alipay.trade.pay(统一收单交易支付接口)](https://opendocs.alipay.com/open/064jhk?pathHash=a80ad29a&ref=api&scene=32f92b62c19b44cfaf3bf4d974fcbcf3)，即可升级为**预授权支付**。更多请查看[预授权支付接口详情](https://opendocs.alipay.com/open/064jhe?scene=2a9ad7e9012248b0acd5edd04c9f31b6&pathHash=d577d80a)。
**商家扣款** 是周期扣款的升级产品。小程序场景中，**商家扣款** 使用的接口，和周期扣款使用的接口一样，区别在于两点：
- 区别一：**商家扣款** 使用的产品码不一样，需要注意更换 alipay.user.agreement.page.sign(支付宝个人协议页面签约接口)与alipay.trade.pay(统一收单交易支付接口)的product_code 的参数，从 CYCLE_PAY_AUTH 变更为 GENERAL_WITHHOLDING。
- 区别二：当在小程序场景使用时，开通商家扣款产品时，**交易场景要包含小程序场景。**
**注意**：请勿修改 **周期扣款 **产品的其它接口，仅需修改[alipay.user.agreement.page.sign(支付宝个人协议页面签约接口)](https://opendocs.alipay.com/open/8bccfa0b_alipay.user.agreement.page.sign?scene=35&pathHash=80d2c50f)与[alipay.trade.pay(统一收单交易支付接口)](https://opendocs.alipay.com/open/38d751b1_alipay.trade.pay?scene=32&pathHash=0a222003)，即可升级为**商家扣款**。更多请查看[商家扣款接口详情](https://opendocs.alipay.com/open/8bccfa0b_alipay.user.agreement.page.sign?scene=35&pathHash=80d2c50f)。
**3，配置检测**
可通过[配置项检测工具](https://open.alipay.com/api/check?examCode=E000001956&from=center)检测 接入JSAPI支付 前，哪些配置项还未完成。
#### 4.2 支付功能验证（线下环境支付功能调试）
JSAPI支付支持沙箱调试，预授权支付、商家扣款暂不支持。
##### 沙箱调试
- 通过[沙箱控制台](https://open.alipay.com/develop/sandbox/app)查看沙箱应用和账号
- 支付宝开放平台提供了[API Explorer](https://open.alipay.com/api/errCheck?from=center)工具，可以帮您在沙箱环境简易的调试JSAPI支付接口。
- 查看文档 [JSAPI支付沙箱调试指南](https://opendocs.alipay.com/mini/0845zf?pathHash=5339b1d6)
##### 真机调试
在小程序 IDE 切换到 沙箱环境(新)（需要安装沙箱环境切换插件），点击 **真机调试**，通过沙箱钱包扫码唤起收银台完成支付。
#### 4.3 常见问题
Q：接口调用 出现错误码 **isv.insufficient-isv-permissions**
A：SV 权限不足（isv.insufficient-isv-permissions）是指开发者在调用接口前，由于无相关接口的调用权限而导致的报错，一般由于以下原因导致：
- 未开通产品功能。
- 应用未上线。
- 调用接口错误。
- 第三方授权方式调用但授权商家未签约。
[解决方案详情](https://opendocs.alipay.com/support/01rax6)
Q：接口调用 出现错误码 **isv.invalid-signature**
A：请求接口报错 isv.invalid-signature（无效签名），检查是否把私钥位置配置成公钥
- 密钥不匹配。
- 参数错误，如乱码、自定义参数、特殊字符 。
- 签名方法错误。
[解决方案详情](https://opendocs.alipay.com/support/01rax2)
**温馨提示：**查看 [更多常见问题](https://opendocs.alipay.com/mini/05xhsu?pathHash=bf2a1656)，也可通过[错误码排查工具](https://open.alipay.com/api/errCheck?from=center)和[配置项检测工具](https://open.alipay.com/api/check?examCode=E000001956&from=center)自助诊断工具排查更多报错问题
### 5. 审核上架
#### 服务商代提交审核
服务商代商家提交审核，或者商家登录服务商SaaS平台提交审核；
若支付功能集成异常，提审驳回，驳回提示：“支付存在异常：点击产品进行购买，页面报错，详见报错截图，请优化。”，请服务商依照指引检查，更新集成并验证支付功能后再提审。
### 6. 查看数据
#### 6.1 商家自运营查看交易数据
查看路径：[商家平台-数据中心-交易分析-小程序交易分析](https://b.alipay.com/page/data-analysis-center/appTrade)或小程序分析-交易。
接入完成并产生交易数据后，可查看自己的交易数据明细，包括交易的核心数据、不同渠道的交易效果和用户画像等。
接入 JSAPI支付 的商家可在 [alipay.trade.create（统一收单交易创建接口）](https://opendocs.alipay.com/mini/05x9kv) 通过 business_params 对象的 tiny_app_merchant_biz_type 指定业务场景值，添加对应业务场景下的数据明细，进行业务场景信息的回传。
#### 6.2 服务商代运营查看交易数据
查看路径：
- 服务商平台-代运营中心-商家数据-交易分析-小程序交易
- 服务商平台-代运营中心-商家小程序-小程序数据-交易
服务商获取到商家的代运营授权后，可以在P站查看商家小程序的交易数据
