开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
凯发app官方网站的技术支持 & 案例 faq 
接入指南 > 案例分析 > 标准产品 > 小程序接入案例分析
收藏
我的文档
设置
免研/研发小程序对比
小程序为了满足不同商家需求,提供了 (免开发小程序已升级为电子名片)和 研发小程序 两种开通小程序的方式,下表对其进行了简单的对比:
免研/研发小程序对比
免研小程序
研发小程序
描述
支付宝官方提供商家的,无需开发,直接开通可使用的小程序。
需要商家拥有支付宝账户,然后以开发者身份入驻支付宝开放平台,自行创建小程序应用,通过开发工具自行完成小程序的代码研发,提交版本审核通过后,上架使用小程序。
优点
纯平台后台配置,无需代码开发,开通后即可使用。
无需拥有研发能力,上架时长短,耗资少等优点。
可集成能力丰富,可自行通过研发个性化小程序,商家自主性强,依赖平台提供能力较弱。
企业账号和个人账号均可创建小程序应用。
缺点
可集成能力较少。
由于使用的是官方模版,商家自主性弱,依赖平台提供能力较强。
需要商家开通当面付产品,只有企业账号和个体工商户账号才可开通。
需要拥有一定的研发能力和研发资金,需要一定的研发周期,上架时长较长。

可集成产品
当面付,商家会员卡,轻会员,绑定生活号,广告位。
目前所有开放
研发投入成本
低。商户在开放平台进行简单配置就可以上线使用免研小程序。
高。自研小程序需要商户自行集成所需能力、涉及到小程序前端及后台开发、建议具有研发能力商户接入。
问题排查
免研小程序使用过程中遇到问题需咨询商服电话 4007585858
自研小程序开发过程中遇到的问题可通过自助排查、工具排查、联系技术支、联系售后、业务问题可咨询商服电话、通用错误分析示例方式进行解决(以下是自研小程序问题排查方法
自研小程序自助排查
基础组件使用报错一般自助排查
确认组件是否有版本要求,当前环境基础库是否符合要求。
检查导入的数据类型是否符合组件要求。
如果是样式不生效或渲染异常,检查是不是原生组件, 组件是不是支持自定义样式(支持自定义样式回在属性列表中列车 class 属性)。
使用 ide 开发工具调试器提供的样式选取功能,排查添加样式属性是否生效。
确认代码是否保存,可以使用快捷键:ctrl shift s 保存全部 tab/ctrl s 保存当前 tab。
可查看官方 demo 内的相关基础组件实现代码,参考里面的写法。
实际效果请以真机为准。
个别机型异常、android 和 ios 一端正常一端异常等无法自行解决问题,收集相关信息。如 appid、支付宝客户端版本、手机类型、简易可复现 demo 代码(必要时收集复现支付宝账号,复现时间)。
扩展组件使用报错一般自助排查
扩展组件是使用小程序自定义组件能力实现的,基于 小程序自定义组件规范
检查是否已经安装对应扩展组件库,:antd-mini
有些自定义组件属性和对象依赖 component2 编译,检查 ide 模拟器右上角 > 详情 > 项目配置 > 启动 component2 编译 是否勾选启动。
可查看官方 demo 内的相关扩展组件实现代码,参考里面的写法。
使用 ide 开发工具调试器提供的样式选取功能,排查添加样式属性是否生效。
确认代码是否保存,可以使用快捷键:ctrl shift s 保存全部 tab/ctrl s 保存当前 tab。
实际效果请以真机为准。
个别机型异常、android 和 ios 一端正常一端异常等无法自行解决问题。如 appid、支付宝客户端版本、手机类型、简易可复现 demo 代码(必要时收集复现支付宝账号,复现时间)非小程序官方提供的组件请咨询组件提供者
api 使用报错一般自助排查
确认 api 是否有版本要求,当前环境基础库是否符合要求。
可查看官方 demo 内的相关 api 实现代码,参考里面的写法。
确认代码是否保存,可以使用快捷键:ctrl shift s 保存全部 tab/ctrl s 保存当前 tab。
查看调试器 console 是否有报错,根据报错提示检查对应代码段。
添加 fail 回调函数,打印 fail 函数的返回,根据具体错误修改。
有些 api 模拟器不一定支持模拟,可真机模式看下是否正常,实际效果请以真机为准。
个别机型异常、android 和 ios 一端正常一端异常等无法自行解决问题。如 appid、支付宝客户端版本、手机类型、简易可复现 demo 代码(必要时收集复现支付宝账号,复现时间)
自研小程序工具排查
小程序属于前端能力,小程序 ide 开发工具 提供了编写和调试功能,开发者可利用 ide 开发工具调试能力,排查开发过程中遇到的问题;具体使用请参考 小程序调试文档
自研小程序联系凯发app官方网站的技术支持
为了减少沟通耗时在联系凯发app官方网站的技术支持前,请先收集相关信息。如 appid、支付宝客户端版本、手机类型、简易可复现 demo 代码(必要时收集复现支付宝账号,复现时间)
自研小程序联系售后
为了减少沟通耗时在联系凯发app官方网站的技术支持前,请先收集相关信息。如 appid、支付宝客户端版本、手机类型、简易可复现 demo 代码(必要时收集复现支付宝账号,复现时间)
业务账单问题:对账有异议,遗留交易订单,订单资金未到账请到 在线咨询或联系商服电话:4007585858,服务时间:8:00-24:00。
自研小程序联系 4007585858
小程序运营相关
智能客服:智能客服相关问题咨询请参考文档提供 凯发k8官方网娱乐官方的联系方式 进行咨询。
开发能力签约问题:请到 在线咨询或拨打商户客服电话咨询:4007585858,服务时间:8:00-24:00。
运营活动业务相关:请到 在线咨询或拨打商户客服电话咨询:4007585858,服务时间:8:00-24:00。
用户信息申请审核:预计会有 1 个工作日的审核时间,请耐心等待。如有问题请到 在线咨询或拨打商户客服电话咨询:4007585858,服务时间:8:00-24:00。
小程序审核相关
小程序应用上线审核:预计会有1个工作日的审核时间,请耐心等待。如有问题请到 在线咨询或拨打商户客服电话咨询:4007585858,服务时间:8:00-24:00。
小程序应用信息修改审核:预计会有1个工作日的审核时间,请耐心等待。如有问题请到 在线咨询或拨打商户客服电话咨询:4007585858,服务时间:8:00-24:00。
小程序提交版本上架审核/驳回/催审:预计会有2个工作日的审核时间,请耐心等待。如有问题请到 在线咨询或拨打商户客服电话咨询:4007585858,服务时间:8:00-24:00。(技术相关可咨询智能在线 )。
账号被风控相关
商家账号被风控(所有交易提示风险报错):请到 在线咨询或申诉电话:4007585858,服务时间:8:00-24:00。
个人账号被风控(个人交易无法进行提示存在风险):请到 在线咨询或申诉电话:4007585858,服务时间:8:00-24:00。
业务账单问题
对账有异议,遗留交易订单,订单资金未到账请到 在线咨询或联系商服电话:4007585858,服务时间:8:00-24:00。
自研小程序各端支持:
香港版小程序问题咨询
针对国际业务的特殊性,支付宝有专门的团队支持,香港版小程序咨询请点击以下链接进行咨询:
钉钉端
钉钉小程序咨询请点击以下链接进行咨询:
淘宝端
淘宝小程序咨询请点击以下链接进行咨询:
高德端
高德小程序咨询请点击以下链接提交工单:
天猫精灵
天猫精灵小程序咨询请点击以下链接进行咨询:
mpaas平台
mpaas 小程序咨询请点击以下链接进行咨询:
自研小程序通用报错案例分析
调用接口/api 报:“isv 权限不足”
原因分析:报 isv 权限不足是由于开发者的小程序应用没有该接口/api 的调用权限导致。
排查步骤:
1登录 进入应用详情页 > 产品绑定,查看接口/api 对应所属产品是否已经添加并生效。 注意:需要开通的请开通生效后在调用;获取会员手机号和运动步数,需要使用主账号登录,在对应产品处申请用户信息并生效。
2确认产品无误后,检查调用 appid 是否正确。
ide 上调用前端接口报 error1
原因分析:有些接口不支持在 ide 工具上进行调试。
问题处理:需要在真机上进行调试。
isv.self-invoke-forbidden(此用户不允许自调用)
原因分析:三方应用 appid 未传入 app_auth_token 直接调用自调用接口。
问题处理:
如果您的业务是三方代商户调用接口,appid 仍传三方应用 appid,但是需要添加上商户小程序授权 token 即 app_auth_token 参数。
如果您的业务非服务商开发,需要把 appid 修改成小程序的 appid。
aop.invalid-app-auth-token(无效的应用授权令牌)
报错描述:aop.invalid-app-auth-token(无效的应用授权令牌)
报错原因:应用授权令牌无效
凯发app官方网站的解决方案:
确认应用授权令牌 app_auth_token 参数值是否正确。
确认授权关系是否正确,是否商户已经解除授权。app_auth_token 和服务商的 appid 必须对应,即使是同一账户内的其他第三方应用也无法使用。
商户取消授权,授权 app_auth_token 失效,授权状态必须是已生效状态,请重新授权获取新的令牌。
isv.invalid-app-id(无效的 appid 参数)
报错描述:无效的 appid 参数
报错原因: appid 参数无效
排查方案:
配置的 appid 参数是否正确,如是否有空格等。
检查配置 appid 对应的支付宝网关是否正确。
若是正式环境,请检查 app_id 是否为生产环境的 appid 且对应的应用的状态为已上线状态。
正式环境网关为: https://openapi.alipay.com/gateway.do;若是沙箱环境, appid 为沙箱应用的 appid ,沙箱环境网关为: https://openapi.alipaydev.com/gateway.do。
如果是小程序获取用户信息是报无效的 appid 参数则是获取 auth_code 的小程序 appid 和调用接口的 appid 不一致导致。需要获取 auth_code 的小程序 appid 和调用接口的 appid 保持一致。
isv.invalid-signature(无效签名)
报错描述:isv.invalid-signature(无效签名)
凯发app官方网站的解决方案:
检查密钥是否匹配。如果是调用支付宝 sdkdemo 测试,一般是密钥错误,检查 demo 中配置的私钥和开放平台上上传的公钥是否对应。
rsa2 密钥匹配方式:如何检验 rsa2 密钥是否匹配
密钥证书匹配方式:如何检验密钥证书是否匹配
检查参数是否错误。例如乱码,不符合支付宝要求,自定义参数,特殊字符。建议只传必传参数测试,避免其他参数干扰。
签名方法错误。建议检查参考文档示例代码签名方式。更多详见 签名专区注意:如果不是通过支付宝 sdk,自己根据支付宝 api 接口开发的话,确定密钥正确的情况下,还需要确定加签参数是否是按支付宝要求处理的。
isv.code-invalid(授权码 code 无效)
报错描述:isv.code-invalid(授权码 code 无效)
报错原因:授权码 (auth_code) 错误、状态不对或过期
排查方案:
请确定传入的 auth_code 是否拼写错误,或未设置。
请确定传入的 auth_code 是否已经被使用过。
请确定传入的 auth_code 是否因为长时间未使用,已经过期。
请确认获取 auth_code 的拼接链接是否正确;用户信息授权拼接示例 https://openauth.alipay.com/oauth2/publicappauthorize.htm?app_id=appid&scope=scope&redirect_uri=encoded_url,调用接口为 alipay.system.oauth.token(换取授权访问令牌)。
是否使用错误的 appid 获取 code。第三方调用获取用户信息,appi 为商户的 appid,而不是服务商的 appid。
是否应用下面商户授权和请求的 token 不一致,或者在程序中刷新了 token ,请重新发起授权流程,获取新的 auth_code 之后,发起接口请求。
isv.invalid-alipay-root-cert-sn (无效支付宝根证书序列号)
报错描述:公钥证书设置进行签名报错 isv.invalid-alipay-root-cert-sn(无效支付宝根证书序列号)
报错原因:参与签名的 alipay-root-cert-sn 数据错误
排查方案:
支付宝根证书路径设置错误。支付宝 ca 根证书文件路径(alipay_root_cert_path)路径存在问题,建议检查路径传值是否正确。建议设置绝对路径,且证书文件地址与 alipay_root_cert_path 设置路径地址一致。
支付宝根证书引用错误。alipay_root_cert_path 设置路径引用证书错误,不是支付宝根证书。 注意:支付宝 ca 根证书文件路径必须为商户上传公钥后,在 接口加签方式 中的 支付宝根证书 位置,点击 下载证书,文件名称为:alipayrootcert.crt。
sign_type 设置错误。支付宝开放平台开发助手生成的公钥证书为 rsa2 格式。签名时,sign_type 必须是 sign_type=rsa2。
php 语言报错核实。php 语言需额外核实,解析的 alipay_root_cert_sn 的参数值,若下划线_后面是以 0x 开头的需进行转义。正常数据如:alipay_root_cert_sn=687b59193f3f462dd5336e5abf83c5d8_02941eef3187dddf3d3b83462e1dfcf6。建议 php 语言 sdk 更换到 4.2.0 以上版本。
详见 公钥证书签名 步骤。
isv.invalid-auth-relations(无效的授权关系)
报错描述:isv.invalid-auth-relations(无效的授权关系);
凯发app官方网站的解决方案:
检查调用接口产品是否支持第三方调用,如单笔转账接口不支持第三方调用。
在支付宝第三方应用平台,检查调用 app_auth_token 的对应参数是否失效。若失效,可能是商家取消授权导致,建议重新授权获取生效的 app_auth_token。
如果小程序 my.getphonenumber 报该错,建议查看报错 无效的授权关系凯发app官方网站的解决方案
小程序页面白屏报错:系统错误,请稍后重试
系统错误,请稍后重试!一般是显示页面的 axml 渲染数据异常导致,可以侧重排查下显示页面的渲染数据,比如直接渲染了 {{object}}、{{objectarray}} 等引用类型数据;引用类型的数据渲染时应该指定到具体的属性值, 比如:{{object.name}}、{{objectarray[arrindex].name}}。
如果页面有使用 picker 组件或其他组件。 注意: range 的数据类型,如果是 object[],必须要指定 range-key;picker 内指定当前选择项时,要指到具体的数据, 比如:{{objectarray[arrindex].name}}。
invalid-signature(验签出错)
验签出错排查方案:
密钥不匹配。建议使用支付宝开放平台助手检查密钥是否匹配。
rsa2 密钥配详见 如何检验 rsa2 密钥是否匹配
公钥证书匹配详见 如何检验密钥证书是否匹配
编码格式不统一。不统一导致中文乱码,从而导致请求报错 乱码参数示例 :"subject\\":\\"鎮ㄥソ\\"。兼有有中文字段的参数先设置 123 等数据,避免中文乱码测试。
请求参数中有空格,转义符,特殊字符(基本上会出现在 biz_content 中)。
建议只传必传参数测试。
不可随意添加转义符。
请求参数中不要进行空传值,或者是有空格。
回调地址携带 ?id=123 这类自定义参数。notify_url 或者 return_url 不能加 ?id=123 这类自定义参数。 错误示例:https://您的域名/notify_url.php?id=123&test=abc。
sign_type 设置是否正确。如出现 sign 值与 sign_type 参数指定的签名类型不一致该错误,建议排查签名方式和私钥的格式是否对应,如私钥是 2048 位的需使用 rsa2 签名方式,如私钥是 1024 位的需使用 rsa 签名方式。 2018-01-05 之后创建的应用与公钥证书签名,sign_type 必须设置为 rsa2。
根据接口加签方式选择对应签名流程。
接口加签方式为 公钥证书,就必须使用公钥证书方式进行签名。
接口加签方式为 公钥,就必须使用普通公钥方式进行签名。
公钥证书签名调用方法错误。排查公钥证书的 response 请求方式是否正确:
java 语言 response 的 execute()方法需改成 certificateexecute()。
php 语言 response 的 execute()方法仍然使用 execute()。
.net 语言 response 的 execute()方法需改成 certificateexecute()。 注意:公钥证书和普通公钥的 pageexecute 和 sdkexecute 调用方法一致,未改变。
检查 sdk 运行环境。.net 开发语言请注意在自查上述问题,没有发现问题,请更新官方最新 sdk 在重新测试。官方最新 .net sdk 下载地址:服务端 sdk 
具体报错详见各报错处理流程
验签出错,建议检查签名字符串或签名私钥与应用公钥是否匹配,参见以上 8 个排查方案。
验签出错,应用未配置对应签名算法的公钥或者证书
验签出错,sign 值与 sign_type 参数指定的签名类型不一致
验签出错,请确认 charset 参数放在了 url 查询字符串中且各参数值使用 charset 参数指示的字符集编码
isv.invalid-charset
报错描述:字符集错误
凯发app官方网站的解决方案:请请求参数 charset 错误,目前支持格式:gbk、utf-8。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图