更新时间:2025-08-27 GMT+08:00
分享

常见问题

  1. 调试生产接口时,页面返回报错如下:
    调测失败,生产接口响应头缺少Body-Sign,或Body-Sign格式错误.
    • 云商店没有取到“Body-Sign”消息头时提示的错误消息。需要将Body-Sign放到接口的响应信息里,具体示例参考HTTP Body签名。开发生产接口时,商家返回的消息头中必须有“Body-Sign”,需要注意大小写,否则也无法调测成功。例如,消息头写成错误的“Body-sign”。
    • Body-Sign消息头中sign_type和signature的值没取到,可以看下返回给云商店的这两个值的格式正不正确。下面是正确的格式:
      sign_type="HMAC-SHA256", signature="******"

      若这里的引号没有加,云商店不能解析出这两个值,页面就会报这个错。

  2. 调试接口时,页面返回如下报错:
    调用失败,生产接口resultCode返回错误.

    云商店默认ResultCode=000000为成功,其它为失败,具体错误码参考调用结果码说明

  3. 调试接口时,页面返回如下报错:
    调测失败,接口响应缺少{fileId}.

    云商店校验了响应必填字段,具体如下:

    • 新购商品接口必须返回instanceId、frontEndUrl。
    • 查询实例信息接口必须返回instanceId,如果返回了UsageInfo,则必须返回usageValue和statisticalTime。
  4. 调试接口时,页面返回如下报错:
    调测失败,字段{fileId}长度不合法.

    云商店校验了响应字段的长度,如新购商品接口返回的frontEndUrl最大长度为512,字段长度限制具体参考"接口描述"。

  5. 调试接口时,页面返回如下报错:
    调测失败,解析响应体失败,响应格式参考{"resultCode":"000000","resultMsg":"success."}.

    云商店解析响应失败,接口未返回resultCode和resultMsg字段。

  6. 调试接口时,页面返回如下报错:
    调测失败,响应content-type格式错误,返回的格式为{contentType},正确的格式为"application/json".

    接口响应的content-type需要为"application/json"格式,否则会导致云商店解析响应体失败。

  7. 调试接口时,页面返回如下报错:
    调测失败,生产地址不可达.
    • 需要确认生产地址可用。
    • 需要确认生产地址公网可访问。
    • 需要确认是否被网关拦截。
  8. 调试接口时,页面返回如下报错:
    调测失败,调用接口超时20s.

    云商店调用商家接口设置的默认超时时间为20s,如果超过20s则调用失败。

    商家需检查日志,确认请求是否达到服务器。如果请求到达,则确认响应是否超过20s。如果请求未到达,则联系售后工程师处理。

  9. 调试接口时,页面返回如下报错:
    调测失败,接口响应httpCode={httpCode},请检查服务器日志,定位失败原因.

    云商店默认httpcode=200为调用成功,其它均表示调用失败。

  10. 调试报错“响应Http Body签名校验失败,预期的签名值:**********”,如何处理?

    这是因为httpbody在获取签名到最终发送消息之间,body内容被变动了,可能的原因是属性顺序变动、填加了空白、换行符等待(有的输出流会添加换行符\n),请进行排查。

  11. 调用verificateRequestParams方法遇到authToken与signature不一致,参数加号变空格时,如何处理?

    对authToken和signature都做一下URLDecoder.decode()

  12. 客户购买SaaS产品后,进入“资源中心 > 我的云商店 > 已购买的服务”,单击“管理”,为什么在详情页面看不到产品的用户名和密码?

    可能的原因:

    • 正式开通实例时,有些校验没有通过,例如用户密码的长度校验,加密之后的密文长度不能超过文档中规定的值。
    • 云商店解密失败。ISV要按照云商店提供的方法进行加密,当编码语言不一致时,需要比对当前语言加密的密文结果与使用云商店提供的代码加密的密文结果是否一致。若密文一致,还需要查看传给云商店的敏感信息加解密算法的encryptType参数是否正确传入,256加密(AES256_CBC_PKCS5Padding)时传1,128加密(AES128_CBC_PKCS5Padding)时传2。
  13. 为什么商家用云商店传过来的请求参数加密出来的authToken值与云商店传过来的authToken值不一致?

    请求的URL串中的参数都经过了url编码,不能直接用来生成authToken。应先将每一个参数url解码(其中客户的手机号和邮箱解码后是加密后的密文,不用解密),用解码后的参数来生成authToken。

  14. 用户名密码的长度限制是对明文的限制还是密文的限制?

    对密文值(包含向量iv)的限制。为了避免商家开通实例成功,但是云商店对用户名密码长度校验失败,导致商品在云商店“我的应用 > 已购买应用”页面展示开通中,建议商家对加密后的用户名密码做长度校验。

  15. 客户购买SaaS类商品支付成功后,云商店调用商家新购商品接口开通实例失败,并且已经达到调用次数上限,ISV应该怎么处理才能再次开通?

    找到开通实例失败的原因并作出修改后,然后登录卖家中心,选择左侧导航栏的“交易管理 > 生产接口消息”,在右侧页面单击“重新启动”。

  16. 商家在应用接入调试页面完成新购商品接口的调试就可以了吗?

    为了确保新购商品后续续费、过期、释放等业务的正常进行,请务必将新购、续费、过期、释放接口都调试通过,再发布SaaS产品。

  17. 应用接入调试的敏感信息加密算法,在发布SaaS产品时是在哪里定义的?

    在SaaS产品发布页面,勾选“需要用户授权”的选项时,会显示敏感信息加密算法,默认选择AES256_CBC_PKCS5Padding,用户可以根据自己需要选择加密算法。

  18. 新购商品接口在应用接入调试通过了,用户购买时却调用失败,该怎么办?
    1. 登录卖家中心,左侧导航栏选择“应用接入 > 应用接入调试”,使用用户购买时云商店发送的真实请求和返回给云商店的真实消息体,在应用接入调试页面调试。
    2. 如果调试通过,选择“交易管理 > 生产接口消息”,单击对应记录右侧的“ 重新启动”。反之,则联系运营经理处理。
  19. 同一个商品发布时,针对不同接口(新购、续费、过期和释放),是否可提供多个生产系统地址?

    不可以, 当前针对同一个商品,在发布时,只能配置一个“生产系统接口地址”。

相关文档