更新时间:2024-04-12 14:33:07收藏我的文档设置返回文档免研/研发小程序对比小程序为了满足不同商家需求,提供了 (免开发小程序已升级为电子名片)和 研发小程序 两种开通小程序的方式,下表对其进行了简单的对比:免研/研发小程序对比免研小程序研发小程序描述支付宝官方提供商家的,无需开发,直接开通可使用的小程序。需要商家拥有支付宝账户,然后以开发者身份入驻支付宝开放平台,自行创建小程序应用,通过开发工具自行完成小程序的代码研发,提交版本审核通过后,上架使用小程序。优点纯平台后台配置,无需代码开发,开通后即可使用。无需拥有研发能力,上架时长短,耗资少等优点。可集成能力丰富,可自行通过研发个性化小程序,商家自主性强,依赖平台提供能力较弱。企业账号和个人账号均可创建小程序应用。缺点可集成能力较少。由于使用的是官方模版,商家自主性弱,依赖平台提供能力较强。需要商家开通当面付产品,只有企业账号和个体工商户账号才可开通。需要拥有一定的研发能力和研发资金,需要一定的研发周期,上架时长较长。可集成产品当面付,商家会员卡,轻会员,绑定生活号,广告位。目前所有开放的研发投入成本低。商户在开放平台进行简单配置就可以上线使用免研小程序。高。自研小程序需要商户自行集成所需能力、涉及到小程序前端及后台开发、建议具有研发能力商户接入。问题排查免研小程序使用过程中遇到问题需咨询商服电话 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。