开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
开发 > 服务端 > 支付产品 > 小程序支付产品升级指南 > 商家自研新小程序
收藏
订阅更新
我的文档
设置
注:本升级指南,面向商家自研新的小程序(未创建小程序,或小程序未上架经营、未完成支付功能集成)的客户。
简介
为帮助您准确选择小程序收款场景下的支付产品,获得更加全面的经营效果分析,同时优化您的客户在小程序内的下单体验,支付宝全新推出三款小程序的支付产品:“jsapi支付”、“预授权支付”和“商家扣款”。
即日起,您可根据小程序的收款场景选择:
收款场景
适用行业
原支付产品
新支付产品
用户在小程序里选择购买商品,通过支付宝收银台,输入支付密码,完成支付。

适用于扫码点餐、电商购物等
当面付、app支付、手机网站支付等
用户产生实际消费前,商家可以提前冻结用户的一部分资金作为“押金”,在用户实际消费发生后,商家再根据实际消费金额,向支付宝发出指令,从用户账户的“押金”中扣除。

适用于押金、预存场景,如住宿(民宿/酒店)、出行(传统租车/分时租赁/单车)、租物(3c 数码/充电宝/雨伞/手机/相机)等多个行业品类。
支付宝预授权
用户只需授权商家端进行扣款,授权成功后商家获取授权扣款协议号,后续按照约定的扣款规则进行自动扣款。

适用于周期自动扣款的业务和场景,例如会员费自动续费,周期租赁费、定期还款、定期缴费等。
周期扣款、商户代扣

若您的小程序已使用上述原支付产品,可按需切换成新产品。
总览
我是商家、自研开发新小程序:

升级步骤
1
2
3
4
5
6
创建小程序
产品开通(签约)
商户号关联小程序appid
集成验证
审核上架小程序
查看小程序交易数据
具体操作
二选一:
在开放平台创建小程序;
在商家平台创建小程序
二选一:
商家自助开通;
联系支付宝商务经理开通
商家自助关联
集成支付产品;
验证支付功能
小程序商家提交审核
商家查看交易数据
其他场景,请查看 升级总览
升级步骤
1. 创建小程序
商家自研开发小程序,通过以下方式二选一,创建小程序。
1.1 在开放平台创建小程序
支付宝账号要求:企业账号、个体工商户账号、个人账号
操作步骤:登录-进入控制台-选择小程序tab-点击新建小程序

1.2 在商家平台创建小程序
支付宝账号要求:企业账号、个体工商户账号、个人账号
操作步骤:登录-进入运营中心-点击小程序菜单项-点击创建小程序

2. 产品开通(签约)
签约准入条件:
1完成小程序创建,可使用当前商家账号名下小程序或其他账号名下小程序开通产品;使用其他账号名下小程序时,需要小程序归属商家账号确认授权;开通产品的商家账号,可管理用于哪些小程序收款;
2若提供的小程序未上架,可先上传小程序截图完成产品的开通,并在开通后30天内完成小程序上架并补全信息,以免影响后续收款;
3无需提供线下经营地址和门头照。
2.1 商家自助开通
商家自助开通小程序支付产品,jsapi支付、预授权支付、商家扣款支持商家自助开通。以jsapi支付为例,
具体操作路径:,选择支付产品:

进入产品页面,查看产品介绍,点击“立即开通”,在开通页面中选择(或确认)经营信息和交易场景,并提供小程序的具体信息,根据商家经营类目的不同,签约时所需要提交的资料以页面提示为准。其中,商家分账是可选功能,按需开通。
其中,小程序appid是指使用当前账号收款的小程序appid,商户号开通产品、商户号关联小程序appid后,签约小程序支付产品的商户号才能在该小程序内收款,当小程序归属于其他公司主体时需要对方授权。若需要关联绑定多个appid,可详见3.2。

确认价格信息、协议,点击提交,提交开通后等待支付宝审核。后续可在产品页面查看开通状态和开通详情。

2.2 支付宝商务经理代开通
联系您的商户经理开通产品,或拨打4007585858查询您的商务经理。
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 小程序商家确认授权
关联其他公司主体的小程序 appid,需要小程序归属商家确认授权。商户号发起申请后,小程序主体的商家账号登录商家平台-凯发k8官方网娱乐官方首页-待办中心 或支付宝 app 端-消息,确认授权,授权后商户号才能在小程序内收款。

4. 集成支付产品并完成功能验证
4.1 集成小程序支付产品
请按小程序收款场景,查看以下集成文档,完成接入。
小程序支付产品
集成文档
jsapi支付
预授权支付

商家扣款

其中jsapi支付,其 接口的关键特性说明如下:
1jsapi支付的产品码传参product_code值为jsapi_pay;
2指定op_app_id,即小程序经营主体 appid(指商户在小程序中,拉起收银台支付时,对应的小程序应用的 appid);发起创单交易订单的应用的商家账号与小程序经营主体要完成关联绑定,才能收款,即商户号关联小程appid;
3当商家需要在 > 数据中心(入口 1:数据中心 > 交易中心 > 小程序交易;入口 2:数据中心 > 小程序分析 > 交易)中查看对应业务场景下的数据明细时,可以通过 business_params 对象的 tiny_app_merchant_biz_type 指定业务场景值,支持传入的值详见:
在线接入jsapi支付:点击 可通过检测 接入jsapi支付 前,哪些配置项还未完成。

4.2 验证支付功能(线下环境支付功能调试)
jsapi支付支持沙箱调试,预授权支付、商家扣款暂不支持。
沙箱调试
通过查看沙箱应用和账号
支付宝开放平台提供了工具,可以帮您在沙箱环境简易的调试jsapi支付接口。
查看文档
真机调试
在小程序 ide 切换到 沙箱环境(新)(需要安装沙箱环境切换插件),点击 真机调试,通过沙箱钱包扫码唤起收银台完成支付。


4.3 常见问题
q:接口调用 出现错误码 isv.insufficient-isv-permissions
a:isv 权限不足(isv.insufficient-isv-permissions)是指开发者在调用接口前,由于无相关接口的调用权限而导致的报错,一般由于以下原因导致:
未开通产品功能。
应用未上线。
调用接口错误。
第三方授权方式调用但授权商家未签约。

q:接口调用 出现错误码 isv.invalid-signature
a:请求接口报错 isv.invalid-signature(无效签名),检查是否把私钥位置配置成公钥
密钥不匹配。
参数错误,如乱码、自定义参数、特殊字符 。
签名方法错误。

温馨提示:查看 更多常见问题,也可通过自助诊断工具排查更多报错问题
5. 审核上架
5.1 小程序商家提交审核
操作入口:-版本管理-提交审核
若支付功能集成异常,提审驳回,驳回提示:“支付存在异常:点击产品进行购买,页面报错,详见报错截图,请优化。”,请依照指引检查,更新集成并验证支付功能后再提审。

6. 查看数据
6.1 商家自运营查看交易数据
查看路径:或小程序分析-交易。
接入完成并产生交易数据后,可查看自己的交易数据明细,包括交易的核心数据、不同渠道的交易效果和用户画像等。

接入 jsapi支付 的商家可在 通过 business_params 对象的 tiny_app_merchant_biz_type 指定业务场景值,添加对应业务场景下的数据明细,进行业务场景信息的回传。

内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图