更新时间：2024-10-23 18:09:33收藏订阅更新我的文档设置返回文档注：本指南，面向商家自研、已有的小程序（使用当面付、app支付等原支付产品在小程序内收款）的客户。简介 为帮助您准确选择小程序收款场景下的支付产品，获得更加全面的经营效果分析，同时优化您的客户在小程序内的下单体验，支付宝全新推出三款小程序的支付产品：“jsapi支付”、“预授权支付”和“商家扣款”。即日起，您可根据小程序的收款场景选择：收款场景适用行业原支付产品新支付产品用户在小程序里选择购买商品，通过支付宝收银台，输入支付密码，完成支付。适用于扫码点餐、电商购物等当面付、app支付、手机网站支付等jsapi支付用户产生实际消费前，商家可以提前冻结用户的一部分资金作为“押金”，在用户实际消费发生后，商家再根据实际消费金额，向支付宝发出指令，从用户账户的“押金”中扣除。适用于押金、预存场景，如住宿（民宿/酒店）、出行（传统租车/分时租赁/单车）、租物（3c 数码/充电宝/雨伞/手机/相机）等多个行业品类。支付宝预授权预授权支付用户只需授权商家端进行扣款，授权成功后商家获取授权扣款协议号，后续按照约定的扣款规则进行自动扣款。适用于周期自动扣款的业务和场景，例如会员费自动续费，周期租赁费、定期还款、定期缴费等。周期扣款、商户代扣若您的小程序已使用上述原支付产品，可按需升级成新产品。总览我是商家，自研开发，升级已有小程序的支付功能：升级步骤12345产品开通（签约）商户号关联小程序appid集成验证审核上架小程序查看小程序交易数据具体操作商家自助开通，或联系支付宝商务经理开通支付宝代升级开通商家自助关联集成支付产品；验证支付功能小程序商家提交审核商家查看交易数据升级步骤1. 产品开通（签约）签约准入条件：1）完成小程序创建，可使用当前商家账号名下小程序或其他账号名下小程序开通产品；使用其他账号名下小程序时，需要小程序归属商家账号确认授权；开通产品的商家账号，可管理用于哪些小程序收款；2）若提供的小程序未上架，可先上传小程序截图完成产品的开通，并在开通后30天内完成小程序上架并补全信息，以免影响后续收款；3）无需提供线下经营地址和门头照。1.1 商家自助开通商家自助开通小程序支付产品，jsapi支付、预授权支付、商家扣款支持商家自助开通（注意：如果是直付通模式，暂不支持自助开通，请联系您的支付宝业务人员代为开通）。以jsapi支付为例，具体操作路径：，选择支付产品： 进入产品页面，查看产品介绍，点击“立即开通”，在开通页面中选择（或确认）经营信息和交易场景，并提供小程序的具体信息，根据商家经营类目的不同，签约时所需要提交的资料以页面提示为准。其中，商家分账是可选功能，按需开通。填写的小程序appid即商户号开通产品的收款小程序，若需要关联绑定多个appid，可详见2.2确认价格信息、协议，点击提交，提交开通后等待支付宝审核。后续可在产品页面查看开通状态和开通详情。1.2 支付宝商务经理代开通联系您的商户经理开通产品，或拨打4007585858查询您的商务经理。1.3 支付宝代升级开通为了便利您的操作，我们也将在近期帮符合平台规则的商户统一升级开通小程序场景专用支付产品，升级开通成功后，需要完成后续步骤的操作以完成完整升级。升级开通成功后，您可以前往商家平台查看开通详情，具体操作路径：，选择支付产品：2. 商户号关联小程序appid功能说明：管理商户号与小程序的支付收单关系。基本规则： 1）小程序使用开通小程序支付产品的商户号收款，且需要完成商户号关联小程序appid； 2）关联同一商户号名下、同一公司主体名下或已有品牌授权关系商家主体名下的小程序，申请后即关联；关联其他公司主体的小程序，需要小程序归属商家确认授权，待小程序归属商家在商家平台-待办通知或支付宝app端-消息中完成确认授权后即关联。关联入口： 1）商户号开通jsapi支付时，填写小程序appid； 2）商户号开通jsapi支付后，可在jsapi支付产品详情页面继续管理（新增关联appid、查看商家授权状态）。2.1 开通jsapi支付产品时关联开通jsapi支付产品时，声明小程序appid，即发起商户号关联小程序appid；2.2 商户号关联小程序管理开通jsapi支付产品后（商家自助开通、服务商代开通、支付宝商务经理开通3种渠道选其一），商家在商家平台-凯发k8官方网娱乐官方的产品中心-支付产品- 管理商户号关联的小程序appid，查看已关联的小程序appid及状态；新增关联请点击“添加关联小程序appid”：商户号发起关联：待关联的小程序appid列表，是当前账号名下的小程序，可快捷操作关联。2.3 小程序商家确认授权关联其他公司主体的小程序appid，需要小程序归属商家确认授权。商户号发起申请后，小程序主体的商家账号登录商家平台-凯发k8官方网娱乐官方首页-待办中心 或支付宝app端-消息，确认授权，授权后商户号才能在小程序内收款。3. 集成支付产品并完成功能验证3.1 集成小程序支付产品1，集成准备（以当面付升级至jsapi支付为例，接入预授权支付、商家扣款等其他小程序支付可参考）完成产品开通、商户号关联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支付 前，哪些配置项还未完成。3.2 验证支付功能（线下环境支付功能调试）jsapi支付支持沙箱调试，预授权支付、商家扣款暂不支持。1. 沙箱调试●通过查看沙箱应用和账号●支付宝开放平台提供了工具，可以帮您在沙箱环境简易的调试jsapi支付接口。●查看文档 2. 真机调试在小程序 ide 切换到 沙箱环境(新)（需要安装沙箱环境切换插件），点击 真机调试，通过沙箱钱包扫码唤起收银台完成支付。3.3 常见问题q：接口调用 出现错误码 isv.insufficient-isv-permissionsa：isv 权限不足（isv.insufficient-isv-permissions）是指开发者在调用接口前，由于无相关接口的调用权限而导致的报错，一般由于以下原因导致：●未开通产品功能。●应用未上线。●调用接口错误。●第三方授权方式调用但授权商家未签约。q：接口调用 出现错误码 isv.invalid-signaturea：请求接口报错 isv.invalid-signature（无效签名），检查是否把私钥位置配置成公钥●密钥不匹配。●参数错误，如乱码、自定义参数、特殊字符 。●签名方法错误。温馨提示：查看 更多常见问题，也可通过和自助诊断工具排查更多报错问题4. 审核上架4.1 小程序商家提交审核操作入口：-版本管理-提交审核若支付功能集成异常，提审驳回，驳回提示：“支付存在异常：点击产品进行购买，页面报错，详见报错截图，请优化。”，请依照指引检查，更新集成并验证支付功能后再提审。5. 查看数据5.1 商家自运营查看交易数据查看路径： 或小程序分析-交易。接入完成并产生交易数据后，可查看自己的交易数据明细，包括交易的核心数据、不同渠道的交易效果和用户画像等。接入 jsapi支付 的商家可在 通过 business_params 对象的 tiny_app_merchant_biz_type 指定业务场景值，添加对应业务场景下的数据明细，进行业务场景信息的回传。
