更新时间：2024-10-23 18:07:02收藏订阅更新我的文档设置返回文档注：本指南，面向服务商代商家研发新的小程序（未上架经营，或未完成支付功能集成）的客户。简介 为帮助您准确选择小程序收款场景下的支付产品，获得更加全面的经营效果分析，同时优化您的客户在小程序内的下单体验，支付宝全新推出三款小程序的支付产品：“jsapi支付”、“预授权支付”和“商家扣款”。即日起，您可根据小程序的收款场景选择：收款场景适用行业原支付产品新支付产品用户在小程序里选择购买商品，通过支付宝收银台，输入支付密码，完成支付。适用于扫码点餐、电商购物等当面付、app支付、手机网站支付等jsapi支付用户产生实际消费前，商家可以提前冻结用户的一部分资金作为“押金”，在用户实际消费发生后，商家再根据实际消费金额，向支付宝发出指令，从用户账户的“押金”中扣除。适用于押金、预存场景，如住宿（民宿/酒店）、出行（传统租车/分时租赁/单车）、租物（3c 数码/充电宝/雨伞/手机/相机）等多个行业品类。支付宝预授权预授权支付用户只需授权商家端进行扣款，授权成功后商家获取授权扣款协议号，后续按照约定的扣款规则进行自动扣款。适用于周期自动扣款的业务和场景，例如会员费自动续费，周期租赁费、定期还款、定期缴费等。周期扣款、商户代扣本次升级的适用范围，包括直连商户、直付通平台商户。请您合理安排时间，如带来不便，敬请谅解。总览我是服务商，代商家开发新的小程序：接入步骤1234567创建小程序产品开通（签约）商户号关联小程序appid商家授权集成验证审核上架小程序查看小程序交易数据具体操作接口代商家创建小程序服务商代商家开通（商家已开通产品，可忽略）商家自助关联；服务商代商家关联在“授权产品范围”中添加支付产品，并发起商家授权。集成支付产品;验证支付功能服务商代提交审核（按需）服务商代运营查看交易数据其他场景，请查看 升级总览。升级步骤1. 创建小程序服务商可通过接口代商家创建小程序，若商家已通过支付商家平台创建小程序，服务商的第三方应用发起商家授权，商家小程序应用代开发授权。1.1 接口代创建小程序服务商通过接口发起代创建，商家通过支付宝app端消息，进入“商家消息平台”小程序-点击待办通知-确认创建并授权。1.2 商家平台创建小程序操作步骤：登录-进入运营中心-点击小程序菜单项-点击创建小程序小程序创建后，服务商登录-进入控制台-选择第三方应用-商家授权发起商家小程序应用代开发授权。2. 产品开通（签约）服务商在授权产品范围中添加产品，并发起商家授权，商家开通产品。商户签约准入条件：1完成小程序创建，可使用当前商家账号名下小程序或其他账号名下小程序开通产品；使用其他账号名下小程序时，需要小程序归属商家账号确认授权；开通产品的商家账号，可管理用于哪些小程序收款；2若提供的小程序未上架，可先上传小程序截图完成产品的开通，并在开通后30天内完成小程序上架并补全信息，以免影响后续收款；3无需提供线下经营地址和门头照。2.1 服务商代商家开通开通路径：-支付产品选择商家列表中的商家“申请开通”，或者“向新的商家发起申请”：选择（或确认）经营信息和交易场景，并提供小程序的具体信息，根据商家经营类目的不同，签约时所需要提交的资料以页面提示为准。服务商可在“服务商运营-特约商户授权产品-商家列表”中查看产品开通状态若商家需要查看开通信息，可引导商家登录“商家平台-凯发k8官方网娱乐官方的产品中心”，点击jsapi支付产品详情页面查看开通状态和开通详情。此外，jsapi支付 支持服务商接口代开通，详见3. 商户号关联小程序appid功能说明：管理商户号与小程序的支付收单关系。基本规则： 1）小程序使用开通小程序支付产品的商户号收款，且需要完成商户号关联小程序appid； 2）关联同一商户号名下、同一公司主体名下或已有品牌授权关系商家主体名下的小程序，申请后即关联；关联其他公司主体的小程序，需要小程序归属商家确认授权，待小程序归属商家在商家平台-待办通知或支付宝app端-消息中完成确认授权后即关联。关联入口： 1）商户号开通jsapi支付时，填写小程序appid； 2）商户号开通jsapi支付后，可在jsapi支付产品详情页面继续管理（新增关联appid、查看商家授权状态）。3.1 开通jsapi支付产品时关联开通jsapi支付产品（服务商代开通或商户自助开通）时，声明小程序appid，即发起商户号关联小程序appid；3.2 商户号关联小程序管理开通jsapi支付产品后（商家自助开通、服务商代开通、支付宝商务经理开通3种渠道选其一），商家在商家平台-凯发k8官方网娱乐官方的产品中心-支付产品- 管理商户号关联的小程序appid，查看已关联的小程序appid及状态；新增关联请点击“添加关联小程序appid”：商户号发起关联：待关联的小程序appid列表，是当前账号名下的小程序，可快捷操作关联。3.3 服务商代商户号关联小程序服务商代商户开通产品后，可在商家列表页-操作项“关联小程序”入口管理。3.4 小程序商家确认授权关联其他公司主体的小程序appid，需要小程序归属商家确认授权。商户号发起申请后，小程序主体的商家账号登录商家平台-凯发k8官方网娱乐官方首页-待办中心 或支付宝app端-消息，确认授权，授权后商户号才能在小程序内收款。4. 商家授权若商家小程序由商家在支付宝商家平台自助创建，服务商代开发需要商家授权给服务商的第三方应用。操作步骤：1服务商登录 > 第三方应用 > 商家授权 > 授权范围选择 页面，选择对应产品。2服务商根据 第三方应用授权 指引，获取商家代开发授权，以此获取 app_auth_token（商家授权令牌）用于调用产品相关接口。支持通过接口发起/查询商家授权。5. 集成支付产品并完成功能验证5.1 集成小程序支付产品●第三方应用未集成支付宝支付产品若服务商的第三方应用未集成支付宝支付产品（如当面付、app支付、手机网站支付、商户代扣等），请按小程序收款场景，查看以下集成文档，完成接入。小程序支付产品集成文档jsapi支付https://opendocs.alipay.com/mini/05x9ku?pathhash=a7b61cca预授权支付商家扣款其中jsapi支付，其接口的关键特性说明如下：1jsapi支付的产品码传参product_code值为jsapi_pay；2指定op_app_id，即小程序经营主体 appid（指商户在小程序中，拉起收银台支付时，对应的小程序应用的 appid）；发起创单交易订单的应用的商家账号与小程序经营主体要完成关联绑定，才能收款，即商户号关联小程序appid；3当商家需要在 > 数据中心（入口 1：数据中心 > 交易中心 > 小程序交易；入口 2：数据中心 > 小程序分析 > 交易）中查看对应业务场景下的数据明细时，可以通过 business_params 对象的 tiny_app_merchant_biz_type 指定业务场景值，支持传入的值详见：。●第三方应用已集成支付宝支付产品若服务商的第三方应用集成过支付宝支付产品（如当面付、app支付、手机网站支付、商户代扣等），以下以当面付切换至jsapi支付为例，升级第三方应用和商家小程序的支付产品：1，集成准备完成产品开通、商户号关联appid。2，接口集成（按照以下步骤升级即可）jsapi支付 是专门用于小程序场景收款的产品，当面付 是一款可以在多个场景收款的产品。小程序场景中，jsapi支付 使用的接口，和当面付使用的接口一样，区别在于两点：●区别一：jsapi支付 使用的产品码不一样，需要注意更换 product_code 的参数，从 face_to_face_payment 变更为 jsapi_pay。●区别二：jsapi支付 增加了一个必传字段，op_app_id。该字段指商户在小程序中，拉起收银台支付时的小程序应用的 appid。●区别三：当商户需要在 商家平台（）—数据中心 中查看对应业务场景下的数据明细时，可以通过business_params对象的tiny_app_merchant_biz_type指定业务场景值，支持传入的值详见：；注意：请勿修改 当面付 产品的其它接口，仅需修改 alipay.trade.create（统一收单交易创建接口），即可升级为 jsapi支付。序号接入流程使用的接口当面付jsapi支付1发送订单信息调用 接口-无变化2创建交易订单调用 alipay.trade.create（统一收单交易创建接口）product_code：face_to_face_payment●product_code：jsapi_pay●新增字段：op_app_id（小程序支付中，商户实际经营主体的小程序应用的appid，指在小程序中，拉起收银台支付时的小程序应用的appid）3唤起收银台支付调用 接口无限制必须调用 接口才能唤起收银台4异步通知在 alipay.trade.create 设置异步通知（notify_url）-无变化5交易辅助（查询、退款、撤销、关闭）调用 alipay.trade.query（统一收单线下交易查询接口）调用 （统一收单交易退款接口）调用 （统一收单交易撤销接口）调用 （统一收单交易关闭接口）-无变化更多请查看 。预授权支付 是支付宝预授权的升级产品。小程序场景中，预授权支付 使用的接口，和支付宝预授权使用的接口一样，区别在于两点：●区别一：预授权支付 使用的产品码不一样，需要注意更换 alipay.fund.auth.order.app.freeze(线上资金授权冻结接口)与alipay.trade.pay(统一收单交易支付接口)的product_code 的参数，从 pre_auth_online 变更为 preauth_pay。●区别二：当在小程序场景使用时，开通预授权支付产品时，交易场景要包含小程序场景，且调用接口的appid需为小程序应用类型。注意：请勿修改 支付宝预授权 产品的其它接口，仅需修改 与，即可升级为预授权支付。更多请查看。商家扣款 是周期扣款的升级产品。小程序场景中，商家扣款 使用的接口，和周期扣款使用的接口一样，区别在于两点：●区别一：商家扣款 使用的产品码不一样，需要注意更换 alipay.user.agreement.page.sign(支付宝个人协议页面签约接口)与alipay.trade.pay(统一收单交易支付接口)的product_code 的参数，从 cycle_pay_auth 变更为 general_withholding。●区别二：当在小程序场景使用时，开通商家扣款产品时，交易场景要包含小程序场景。注意：请勿修改 周期扣款 产品的其它接口，仅需修改alipay.user.agreement.page.sign(支付宝个人协议页面签约接口)与alipay.trade.pay(统一收单交易支付接口)，即可升级为商家扣款。更多请查看商家扣款接口详情。3，配置检测可通过检测 接入jsapi支付 前，哪些配置项还未完成。5.2 支付功能验证（线下环境支付功能调试）jsapi支付支持沙箱调试，预授权支付、商家扣款暂不支持。沙箱调试●通过查看沙箱应用和账号●支付宝开放平台提供了工具，可以帮您在沙箱环境简易的调试jsapi支付接口。●查看文档 真机调试在小程序 ide 切换到 沙箱环境(新)（需要安装沙箱环境切换插件），点击 真机调试，通过沙箱钱包扫码唤起收银台完成支付。5.3 常见问题q：接口调用 出现错误码 isv.insufficient-isv-permissionsa：isv 权限不足（isv.insufficient-isv-permissions）是指开发者在调用接口前，由于无相关接口的调用权限而导致的报错，一般由于以下原因导致：●未开通产品功能。●应用未上线。●调用接口错误。●第三方授权方式调用但授权商家未签约。q：接口调用 出现错误码 isv.invalid-signaturea：请求接口报错 isv.invalid-signature（无效签名），检查是否把私钥位置配置成公钥●密钥不匹配。●参数错误，如乱码、自定义参数、特殊字符 。●签名方法错误。温馨提示：查看 更多常见问题，也可通过和自助诊断工具排查更多报错问题6 审核上架服务商代提交审核服务商代商家提交审核，或者商家登录服务商saas平台提交审核；若支付功能集成异常，提审驳回，驳回提示：“支付存在异常：点击产品进行购买，页面报错，详见报错截图，请优化。”，请服务商依照指引检查，更新集成并验证支付功能后再提审。7. 查看数据7.1 商家自运营查看交易数据查看路径：或小程序分析-交易。接入完成并产生交易数据后，可查看自己的交易数据明细，包括交易的核心数据、不同渠道的交易效果和用户画像等。接入 jsapi支付 的商家可在 通过 business_params 对象的 tiny_app_merchant_biz_type 指定业务场景值，添加对应业务场景下的数据明细，进行业务场景信息的回传。7.2 服务商代运营查看交易数据查看路径：●服务商平台-代运营中心-商家数据-交易分析-小程序交易●服务商平台-代运营中心-商家小程序-小程序数据-交易服务商获取到商家的代运营授权后，可以在p站查看商家小程序的交易数据
