免研/需开发小程序对比 为了满足不同商家的需求，小程序提供了免研小程序（免开发小程序已升级为电子名片）和开发小程序两种开通方式。下表做简单比较： 免研/需开发小程序对比 免研小程序 开发小程序 描述 支付宝提供给商家的小程序，无需开发，直接开通即可使用。商家需要拥有支付宝账户，然后以开发者的身份进入支付宝开放平台，自行创建小程序应用，通过开发工具自行完成小程序的代码开发，版本报审后上架使用。 优点 纯平台后台配置，无需代码开发，开通即可使用。 无需有研发能力，上架时间短，成本低等。 集成能力丰富，可自行开发个性化小程序，商家自主性强，依赖平台提供能力。企业账号和个人账号均可创建小程序应用。 缺点 集成能力少。因为采用官方模板，商家自主性弱，依赖平台提供能力。商家需要开通刷脸支付产品，只有企业账号和个人企业账号才能开通，需要一定的研发能力和研发资金，有一定研发周期，上架时间长。 可集成刷脸支付产品、商家会员卡、轻会员、绑定生活账号、广告位等。目前全部开放研发投入成本低，商家在开放平台上简单配置即可上线使用免费研发的小程序。

高。自研小程序需要商家自行集成所需能力，涉及小程序前后端开发，建议有研发能力的商家接入。 问题排查 自研小程序使用过程中遇到问题，需要咨询商家服务热线。 自研小程序开发过程中遇到问题可以通过自助排查、工具排查、联系技术支持、联系售后等方式解决，商家问题可以通过商家服务热线咨询，常规错误分析示例（以下为自研小程序问题排查方法） 自研小程序自助排查 基础组件使用错误 常规自助排查 确认组件是否有版本要求，当前环境基础库是否满足要求。 检查引入的数据类型是否满足组件要求。 若样式不生效或者渲染异常，检查是否为原生组件，组件是否支持自定义样式（若支持自定义样式，属性会在属性列表中）。 使用IDE开发工具调试器提供的样式选择功能，检查添加的样式属性是否生效。确认代码是否保存，可以使用快捷键：Ctrl++S保存所有标签页/Ctrl+S保存当前标签页。相关基础组件实现代码可以在官方demo中查看并参考其中的写法，实际效果请以真机为准。如果部分机型异常或者iOS单边异常导致无法自行解决问题，请收集相关信息，如支付宝客户端版本、手机类型、简单可复现的demo代码（必要时收集可复现的支付宝账号、可复现时间）。

扩展组件使用错误 常规自助排查 扩展组件是利用小程序自定义组件能力实现的，基于小程序自定义组件规范。 检查是否已经安装对应的扩展组件库，UI 组件：antd-mini。 部分自定义组件属性和对象依赖编译。 检查IDE模拟器 > 详情 > 项目配置 > 开始编译 右上角是否勾选了开始编译。 你可以在官方demo中查看相关扩展组件实现代码，参考里面的写法。 使用IDE开发工具调试器提供的样式选择功能，检查添加的样式属性是否生效。 确认代码是否保存，可以使用快捷键：Ctrl++S 保存所有tab/Ctrl+S 保存当前tab，实际效果以真机为准，部分异常机型、iOS一端正常另一端异常等无法自行解决。 例如支付宝客户端版本、手机类型、简单可复现的demo代码（必要时收集并复现支付宝账号和复现时间）。 对于非官方小程序提供的组件，请咨询组件提供方。 API使用错误 常规自助排查 确认API是否有版本要求，当前环境的基础库是否满足要求，可以在官方demo中查看相关API实现代码，参考其中的写法。

确认代码是否保存，可以使用快捷键：Ctrl++S保存所有标签页/Ctrl+S保存当前标签页。 查看调试器是否报错，根据错误提示查看对应代码段。 添加fail回调函数，打印fail函数的返回，根据具体错误进行修改。 部分API模拟器可能不支持模拟，可以在真机模式下查看是否正常，实际效果以真机为准，部分异常机型、iOS一边正常一边异常，无法自行解决。例如支付宝客户端版本、手机类型、简单可复现的demo代码（必要时收集可复现的支付宝账号及可复现时间）。 自研小程序工具排查 小程序属于前端能力，小程序IDE开发工具提供编写、调试功能，开发者可以使用IDE开发工具调试能力排查开发过程中遇到的问题；具体使用请参考小程序调试文档。 自开发小程序联系技术支持 为了减少沟通时间，请在联系技术支持前收集相关信息。例如支付宝客户端版本、手机型号、简单可复现的演示代码（必要时收集支付宝账号和可复现时间）。 自开发小程序，请在联系技术支持前联系售后，减少沟通时间。例如支付宝客户端版本、手机型号、简单可复现的演示代码（必要时收集支付宝账号和可复现时间）。

业务对账问题：如对账有异议、交易遗留订单、订单资金未到账等，请前往商户服务中心在线咨询或联系商户服务电话：服务时间：8：00-24：00。 自开发小程序联系小程序运营相关智能客服：智能客服相关问题咨询请参考文档中提供的联系方式进行咨询。 开发能力合约问题：请前往商户服务中心在线咨询或拨打商户客服电话咨询：服务时间：8：00-24：00。 运营活动业务相关：请前往商户服务中心在线咨询或拨打商户客服电话咨询：服务时间：8：00-24：00。 用户信息申请审核：审核预计需时1个工作日，请耐心等待。 如有任何疑问，请前往商户服务中心在线咨询或拨打商户客服电话进行咨询： 服务时间：8：00-24：00。 小程序审核相关 小程序申请在线审核： 预计审核需1个工作日，请耐心等待，如有任何疑问，请前往商户服务中心在线咨询或拨打商户客服热线： 服务时间：8：00-24：00。 小程序申请信息修改审核： 预计审核需1个工作日，请耐心等待，如有任何疑问，请前往商户服务中心在线咨询或拨打商户客服热线： 服务时间：8：00-24：00。

小程序提交版本上架审核/拒绝/加急审核：审核预计需要2个工作日，请耐心等待。如有问题请前往商户服务中心在线咨询或拨打商户客服电话咨询：，服务时间：8：00-24：00。（技术相关信息请查阅智能在线蚂蚁问答）。账户受风控。商户账户受风控（所有交易提示风险错误）：请前往商户服务中心在线咨询或申诉电话：，服务时间：8：00-24：00。个人账户受风控（无法进行个人交易并提示有风险）：请前往商户服务中心在线咨询或申诉电话：，服务时间：8：00-24：00。 商家账单问题如对账有异议、交易遗留订单、订单资金未到账等，请前往商户服务中心在线咨询或联系商家服务电话：，服务时间：8：00-24：00。自研小程序全端支持：针对香港版小程序的咨询，支付宝有专门的团队支持国际业务的特殊性。 港版小程序咨询请点击以下链接进行咨询： 钉钉端咨询请点击以下链接进行钉钉小程序咨询： #// 淘宝端咨询请点击以下链接进行淘宝小程序咨询： #/ 高德端咨询请点击以下链接提交工单： 天猫精灵天猫精灵小程序咨询请点击以下链接进行咨询： 平台小程序咨询请点击以下链接进行咨询： 自研小程序常见错误案例分析 调用接口/API报：“ISV权限不足” 原因分析： 报ISV权限不足是因为开发者的小程序应用没有该接口/API的调用权限。

排查步骤： 登录支付宝开放平台，进入应用详情页>产品绑定，查看该接口/API对应产品是否已经添加并生效。 注意：如需开通，请开通后再调用；获取会员手机号及行使步骤，需要用主账号登录，在对应产品处申请用户信息并生效。 确认产品正确后，查看调用是否正确。 在IDE上调用前端接口报错 原因分析：部分接口不支持在IDE工具上调试。 问题处理：需要真机调试。 isv.self--（此用户不允许自行调用） 原因分析：第三方应用没有传入直接调用自调用接口。 问题处理：如果您的企业是第三方代商户调用接口，依然传第三方应用，但需要添加商户小程序授权，也就是参数。 如果您的业务不是服务商开发的，需要改为小程序。aop.-app-auth-( ) 错误描述：aop.-app-auth-( ) 错误原因： 解决方案：确认 参数值正确。

确认授权关系是否正确，商户是否释放了授权。必须对应到服务商，同一账户下其他第三方应用不能使用。商户取消授权，授权失效。授权状态必须为有效状态。请重新授权获取新的。isv.-app-id (参数无效) 错误描述：参数无效 错误原因：参数无效 排查方案： 配置的参数是否正确，比如是否有空格。检查配置是否对应正确的支付宝网关。如果是正式环境，请检查是否是生产环境，对应应用的状态是否为上线。正式环境的网关为：；如果是沙盒环境，对于沙盒应用，沙盒环境的网关为：。 如果小程序获取用户信息报参数无效，是获取的小程序和调用接口不一致导致的，需要获取的小程序和调用接口必须一致。 isv.-(无效签名) 错误描述：isv.-(无效签名) 解决方案：检查密钥是否匹配。

如果调用支付宝测试，一般是密钥错误，检查demo中配置的私钥和开放平台上传的公钥是否对应。 RSA2密钥匹配方法：如何检查RSA2密钥是否匹配。 密钥证书匹配方法：如何检查密钥证书是否匹配。 检查参数是否有错。比如乱码、不符合支付宝要求、自定义参数、特殊字符。建议只传递需要的参数进行测试，避免其他参数干扰。 签名方法错误，建议查看参考文档示例代码签名方法，更多详情见签名区。 注意：如果没有使用支付宝SDK，按照支付宝API接口自行开发，确认密钥正确后还需要确认签名参数是否按照支付宝要求处理。 isv.code-( code code) 错误描述：isv.code-( code code) 错误原因：授权码（）错误，状态不正确或者已过期 排查解决方案： 请确认传入的是否拼写错误或者未设置 请确认传入的是否已经使用 请确认传入的是否因为长期未使用而过期 请确认获取的拼接链接是否正确； 用户信息授权拼接示例，调用接口为......（换取授权访问令牌）。

是否使用了错误的获取码？第三方调用获取用户信息时，appi是商户的，而不是服务商的。是否应用中的商户授权和请求不一致，还是程序中刷新了？请重新发起授权流程，获取新的，再发起接口请求。 isv.--root-cert-sn ( root ) 错误描述：签名的公钥证书设置报错 isv.--root-cert-sn ( root ) 错误原因：签名涉及的-root-cert-sn数据错误排查方案：支付宝根证书路径设置错误。支付宝CA根证书文件路径(h)路径有问题，建议检查路径值是否正确，建议设置绝对路径，证书文件地址要和h设置路径地址一致。支付宝根证书引用错误。h设置路径引用的证书有误，该证书不是支付宝根证书。 注意：商户上传公钥后，支付宝CA根证书的文件路径必须在接口签名方式中的支付宝根证书位置，点击下载证书，文件名为：.crt。

设置错误。支付宝开放平台开发助手生成的公钥证书是RSA2格式，签名时必须是=RSA2。 PHP语言错误验证。PHP语言需要额外验证，下划线_后面的参数值如果以0X开头，需要进行转义。正常的数据是：=。建议更换PHP语言SDK到4.2.0以上版本。详情见签名公钥证书步骤。 isv.-auth-(授权关系无效) 错误描述：isv.-auth-(授权关系无效); 解决方案：检查调用接口产品是否支持第三方调用，比如单笔转账接口就不支持第三方调用。在支付宝第三方应用平台，检查调用对应参数是否无效，若无效可能是商户取消授权导致，建议重新授权即可获得有效的。 如果小程序my.报此错，建议查看授权关系无效错误的解决方案。

小程序页面白屏错误：系统错误，请稍后重试 系统错误，请稍后重试！ 一般是展示页面的axml渲染数据异常导致的。可以重点检查展示页面的渲染数据，比如直接渲染{{}}、{{}}这样的引用类型数据；渲染引用类型数据时，应该指定具体的属性值，如：{{.name}}、{{[].name}}。如果页面使用了组件或者其他组件。 注意：如果数据类型为[]，必须指定-key；在指定当前选择时，必须引用具体的数据，如：{{[].name}}。 - (签名验证错误) 签名验证错误的解决方法：密钥不匹配。建议使用支付宝开放平台助手检查密钥是否匹配。RSA2密钥匹配详见如何检查RSA2密钥是否匹配。公钥证书匹配详见如何检查密钥证书是否匹配。 编码格式不统一。 不一致会导致中文乱码，进而导致请求错误。参数乱码示例：“\\”:\\“鎮ㄥソ\\”。对于有中文字段的参数，请先设置123等数据，避免测试时出现中文乱码。

请求参数中有空格、转义符、特殊字符（基本都出现在中间），建议只传递测试需要的参数，不要随意添加转义符。请求参数中不要传递空值或者空格。回调地址中带有自定义参数如?id​​=123。或者自定义参数如?id​​=123不能添加。错误示例：你的域名/.php?id=123&test=abc。设置是否正确？如果出现“sign值与参数指定的签名类型不一致”的错误，建议检查签名方法和私钥的格式是否对应，比如私钥是2048位的，必须使用RSA2签名方法，私钥是1024位的，必须使用RSA签名方法。2018-01-05之后创建的应用必须使用公钥证书签名，必须设置为RSA2。根据接口签名方式选择对应的签名流程。 如果接口签名方式是公钥证书，必须使用公钥证书方法签名 如果接口签名方式是公钥，必须使用普通公钥方法签名 公钥证书签名调用方法错误 检查公钥证书请求方法是否正确：java语言中（）方法需要改为（）。

PHP语言的()方法依然使用()。.Net语言的()方法需要改为()。注意：公钥证书和普通公钥的调用方式是一样的，没有变化。检查SDK运行环境。.NET开发语言请注意，自查以上问题后，如未发现问题，请更新官方最新SDK后重新测试。官方最新.NET SDK下载地址： SDK。具体错误请参考错误处理流程。签名验证错误，建议检查签名字符串或签名私钥是否与应用程序公钥匹配，参考上面8种排查方案。签名验证错误，应用程序未配置对应签名算法的公钥或证书。签名验证错误，sign值与参数指定的签名类型不一致。签名验证错误，请确认参数放在URL查询字符串中且各参数值使用参数标示的字符集编码。 isv.- 错误描述：字符集错误 解决方法：请请求参数错误，目前支持的格式：GBK、UTF-8。