华为云用户手册

联营SaaS接入流程介绍 如上图所示，联营SaaS接入分成为2个阶段： Kit对接：商家根据业务所需进行接口调试（参考基础接口描述和联营Kit接口描述）； 账号测试：商家在云商店的“卖家中心”进行接口调试，申请应用凭证和测试账号获取，完成用户登录测试。 对于商家来说，完成接口对接与测试后，可以申请发布联营SaaS产品；本文档涉及Kit对接和验证用户账号登录，关于买家如何完成应用的购买与配置，请参考商品购买流程、SaaS类商品升配&扩容流程。 父主题： 联营SaaS类商品接入指南 V1.0

HTTP Body签名 Body签名，需要包含在每个接口的响应中，包含两部分： 参数 取值 描述 sign_type HMAC-SHA256 当前取值: HMAC-SHA256 signature base64_encode(HMAC_SHA256(key, httpBody)) base64_encode(HMAC_SHA256(key, httpBody)) httpBody：整个HTTP Body，包括开始和结束的空格、TAB符等。 key = Key值 HTTP响应头域示例： Body-Sign: sign_type="HMAC-SHA256", signature= "******" 消息头的格式请严格按照示例添加，sign_type和signature的值必须要加双引号。 代码示例请参见ISV Server对响应消息体进行签名。 父主题： 接口安全令牌

举例 商家收到的调用请求数据示例如下： http://www.isvwebsite.com/saasproduce?p1=1&p2=2&p3=3&authToken=xxxxxxxxxxxxxx&timeStamp=201706211855321 获取所有的http get请求参数：p1、p2、p3、timeStamp 进行字典排序：sort(p1, p2, p3,timeStamp)，假设排序后的顺序是p1、p3、p2、timeStamp 生成authToken值：base64_encode(HMAC_SHA256(Key+timeStamp, p1=1&p3=3&p2=2&timeStamp=201706211855321)) 所有参数的值云商店都经过了URL编码，商家取到参数值应先进行URL解码。

接口安全令牌 在云商店发布SaaS类商品时，商家需要开发生产接口与云商店平台对接，根据接口规则实现相关的接口定义。用户在云商店购买SaaS商品后，云商店会回调商家实现的生产接口来开通SaaS应用实例，从而为用户提供服务SaaS服务。每一次接口调用和接口响应都必须进行安全校验，本文为您介绍接口的安全令牌方案。 获取Key值 authToken取值说明 HTTP Body签名 父主题： 通用和自服务SaaS类商品接入指南 V1.0

接入流程 SaaS类商品接入云商店的流程如下图所示： 流程说明如下： 申请入驻云商店，成为商家。 云商店运营人员审核公司的资质信息。 准备生产接口服务器，根据本接入指南开发生产接口。 在卖家中心调试生产接口。 在卖家中心完成安全 漏洞扫描 。 在卖家中心申请发布SaaS商品。 云商店运营人员审批通过后产品发布成功。 在卖家中心自助管理生产接口通知消息。 2024年4月27日后新入驻的商家或者上架新商品，统一按照《SaaS类商品接入指南 V2.0》规范进行接口开发和调测。 SaaS 2.0接口协议提供更高的安全性、可靠性、易用性。 父主题： 通用和自服务SaaS类商品接入指南 V1.0

调用结果码说明 模块 结果码 结果码说明 公共 000000 成功 000001 鉴权失败 000002 请求参数不合法 000003 实例ID不存在（商品续费、过期、资源释放接口可能返回） 000004 请求处理中 000005 其它服务内部错误 新购商品 000100 无可用实例资源分配 000101 Mobile number not specified or already exists//手机号为空或重复 000102 Email address is not specified or already exists//邮箱号为空或重复 000103 Product already purchased//该商品不可重复购买 000104 Internal service error//该商品内部服务异常 000105 Account has already subscribed to benefits//该账号已购买权益，无法再开通 000106 Product resources sold out.//该商品资源已售罄 000107 SaaS email domain already exists.//该SaaS邮箱 域名 重复 父主题： 通用和自服务SaaS类商品接入指南 V1.0

请求方法：GET 参数 是否必选 类型 最大字符长度 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 释放场景取值：releaseInstance authToken M String 50 安全校验令牌。 取值请参见authToken取值说明。 instanceId M String 64 实例ID。 orderId M String 64 新购商品时对应的订单ID。 authToken M String 50 安全校验令牌。 取值请参见authToken取值说明。 timeStamp M String 20 请求发起时的时间戳，取UTC时间。 格式：yyyyMMddHHmmssSSS orderAmount O bigdecimal 20 订单金额。 说明： 该金额为用户实际支付金额，供商家对账参考。 金额值大于等于0，最大三位小数。 单位：元 testFlag O Integer 1 是否调测数据。 1：接口调测数据 不传参数：真实买家同步数据 请求消息示例： https://example.isv.com?activity=releaseInstance&instanceId=03pf80c2bae96vc49b80b917bea776d7&timeStamp=20170725025113409&testFlag=1&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应消息 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 说明 resultCode M String 6 调用结果码。 具体请参见调用结果码说明。 resultMsg O String 255 调用结果描述。 商家的服务器在处理接口请求时，需要做好幂等性处理。 云商店服务有可能重发请求，针对同一instanceId，商家的服务器不应该重复做实例资源释放处理，返回成功响应即可。 响应消息示例： { "resultCode":"000000", "resultMsg":"success." }

请求方法：GET 参数 是否必选 类型 最大字符长度 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 过期场景取值：expireInstance authToken M String 50 安全校验令牌。 取值请参见authToken取值说明。 instanceId M String 64 实例ID orderId M String 64 新购商品时对应的订单ID。 timeStamp M String 20 请求发起时的时间戳，取UTC时间。 格式：yyyyMMddHHmmssSSS testFlag O Integer 1 是否调测数据。 1：接口调测数据 不传参数：真实买家同步数据 请求消息示例： https://example.isv.com?activity=expireInstance&instanceId=03pf80c2bae96vc49b80b917bea776d7 &timeStamp=20170725025113409&testFlag=1&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应消息 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 说明 resultCode M String 6 调用结果码。 具体请参见调用结果码说明。 resultMsg O String 255 调用结果描述。 商家的服务器在处理接口请求时，需要做好幂等性处理。 云商店服务有可能重发请求，针对同一instanceId，商家的服务器不应该重复做实例过期处理，返回成功响应即可。 响应消息示例： { "resultCode":"000000", "resultMsg":"success." }

响应消息 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 说明 resultCode M String 6 调用结果码。 具体请参见调用结果码说明。 resultMsg O String 255 调用结果描述。 商家的服务器在处理接口请求时，需要做好幂等性处理。 云商店服务有可能重发请求，针对同一订单号，商家的服务器应当返回成功的响应，不应该再做实例延期处理，返回成功响应即可。 响应消息示例： { "resultCode":"000000", "resultMsg":"success." }

请求方法：GET 参数 是否必选 类型 最大字符长度 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 续费场景取值：refreshInstance authToken M String 50 安全校验令牌。 取值请参见authToken取值说明。 orderId M String 64 云商店订单ID。 说明： 续费、退续费操作会产生新的订单，与新购时订单ID不一致，请通过instance Id做资源识别。 instanceId M String 64 实例ID。 productId O String 64 产品标识，租户续费或转正产品实例时，如果订购周期类型发生变化，会传入变化后的产品类型对应的productId。 expireTime M String 20 过期时间。 格式：yyyyMMddHHmmss trialToFormal O String 2 是否是试用转正请求 不传参数：不是 1：是（试用转包周期） 默认不是试用转正。 timeStamp M String 20 请求发起时的时间戳，取UTC时间。 格式：yyyyMMddHHmmssSSS periodType O String 10 周期类型。 说明： 非必传，如需此参数，计费类型需选择包周期chargingMode=1，包周期购买场景请求时传该参数 年："year" 月："month" chargingMode=3，按次数购买场景请求时不传该参数。 periodNumber O integer 2 周期数量。 说明： 非必传，如需此参数，计费类型需选择包周期chargingMode=1，包周期购买场景请求时传该参数。 周期数量：1,2,3… orderAmount O bigdecimal 20 订单金额。 说明： 该金额为用户实际支付金额，供商家对账参考。 ① 续费场景： 金额值大于等于0，最大三位小数。 ② 退续费场景：金额值为负数，最大三位小数。 单位：元 testFlag O Integer 1 是否调测数据。 1：接口调测数据 不传参数：真实买家同步数据 2018年5月12日新增接口参数：productId和trialToFormal。 2018年5月12日之后发布产品或已发布成功的产品新增规格时，请填写此新参数并通过接口调试（productId为空或者填值，trialToFormal“不传参数”或为“1”都要求调试通过）。 2018年5月12日之前已发布成功的产品，如果不涉及免费试用变更，不要求做接口调试。 请求消息示例： https://example.isv.com?activity=refreshInstance& expireTime=20180725000000&instanceId=03pf80c2bae96vc49b80b917bea776d7&orderId=HWS001014ED483AA1E8&timeStamp=20170725025113409&testFlag=1&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应消息 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 参数说明 resultCode M String 6 调用结果码。 具体请参见调用结果码说明。 resultMsg O String 255 调用结果描述。 encryptType O String 3 敏感信息加密算法 1：AES256_CBC_PK CS 5Padding（默认值） 2：AES128_CBC_PKCS5Padding 说明： 敏感信息加密算法是AES256_CBC_PKCS5Padding时返回值为1，敏感信息加密算法是AES128_CBC_PKCS5Padding时返回值为2。 instanceId M String 64 实例ID，商家提供的唯一标识。 建议此ID直接使用该订单首次请求时云商店传入的businessId，以确保instanceId的唯一性。 说明： 云商店每次请求时的businessId皆不一致，如取businessId作为instanceId，取订单首次调用时的businessId即可。 若通过其他方式生成instanceId，请确保该参数的全局唯一性，例如使用UUID生成。避免生成的instanceId发生重复，导致用户开通SaaS实例失败。 appInfo O AppInfo N/A 应用实例信息。 客户购买商品后，商家需要返回登录服务地址（网站地址）或免登地址供客户后续操作。 说明： SaaS商品必须向客户提供应用使用信息，包括使用地址、账号、密码等。 如可实现通过短信、邮件等其他方式发送使用信息，则接口中允许不响应；否则，必须在接口中返回应用实例信息。 如使用信息不仅包含使用地址及账号密码，可通过如下memo参数灵活返回其他使用信息或使用说明等。 appInfo数据结构定义请参见下表。 AppInfo数据结构定义如下： 参数 是否必选 类型及范围 最大字符长度 参数说明 frontEndUrl M String 512 前台地址。 客户购买商品后，可以访问的网站地址。 adminUrl O String 512 管理地址。 客户购买商品后，可以访问的管理后台地址。 userName O String 128 加密后的管理员账号。 客户购买商品后，访问商家管理后台的账号（一般为邮箱和手机号）。该值由16位iv加密向量和base编码后的用户名密文组成。 iv+encryptAESCBCEncode(userName, accessKey, iv, keySize) 需要使用Key值对账号做加密处理，加密算法以encryptType参数为准。代码示例请参见ISV Server对资源开通后的用户名和密码加密。 password O String 128 加密后的管理员初始密码。 客户购买商品后，访问商家管理后台的密码（一般由商家生成）。该值由16位iv加密向量和base编码后的密码密文组成。 iv+encryptAESCBCEncode(password, accessKey, iv, keySize) 需要使用Key值对密码做加密处理，加密算法以encryptType参数为准。代码示例请参见ISV Server对资源开通后的用户名和密码加密。 memo O String 1024 备注。 说明： 如果备注包含中文内容，请将中文转换成unicode编码，例如：“中文”可以转换成“\u4e2d\u6587”。 获取accessKey，请参见获取Key值。 用户名密码所校验的长度是密文的长度（包括iv向量）。 商家的服务器在处理接口请求时，需要做好幂等性处理。 云商店服务有可能重发请求，针对同一订单号，商家的服务器应当返回成功的响应及应用实例信息，不应该创建新的SaaS实例，返回之前成功创建的实例信息即可。 SaaS实例信息如果有变化，例如，adminUrl发生变化，在云商店服务重新调用此接口，传入相同的orderId时，商家的服务器需要返回更新后的SaaS实例信息。为保证安全，云商店不持久存储SaaS实例信息。 ISV生产接口响应中，除memo参数外，其他参数请不要返回中文。 响应消息示例： { "resultCode":"000000", "resultMsg":"success.", "instanceId":"03pf80c2bae96vc49b80b917bea776d7", "encryptType":"1", "appInfo":{ "frontEndUrl":"https://marketplace.huaweicloud.com/", "adminUrl":"https://marketplace.huaweicloud.com", "userName":"luQ***TobyT***Rx***pwMRg==", "password":"7Bx***5***hC***atExg==", "memo" : "have a test, 测试！" } }

资产安全检测标准 商家提交应用资产发布申请后，云商店会对资产中的软件包进行自动化安全扫描，扫描内容如下 检测项 具体要求 病毒扫描 软件包不能包含病毒、木马、恶意程序 软件包漏洞扫描 软件包不能包含CVSS评分≥7.0的高风险级别的漏洞。 支持检测文件的编程语言类型：C/C++/Java/Go/JavaScript/Python/Rust/Swift/C#/PHP。 支持检测的文件：.7z、.arj、.cpio、.phar、.rar、.tar、.xar、.zip、.jar、.apk、.war等格式文件，及Android OTA Images、Android sparse、Intel HEX、RockChip、U-Boot等固件。

华为云云商店能给伙伴什么？ 面向伙伴，云商店提供了商品分发、变现的全旅程赋能与支持，通过强大而灵活的平台能力，加速伙伴商业增长: 商品上架 云商店提供了多达11种应用的上架接入方式和结构化的商品信息配置页面，最短可在3个工作日内完成软件商品的审核，实现“极速上架”； 随着华为云全球更多Region的服务上线，通过中国站、国际站及多个本地应用商店，可帮助伙伴商品“一点接入，全球分发”； 云商店发布 “组合销售”能力，支持跨场景、跨伙伴的不同商品“打包组合”进行销售，灵活匹配行业客户多样化的业务场景需求，伙伴也可以基于该模式获得更多的销售分成。 商品营销 将华为公司多年积累的成熟的商品Go to Market能力和经验，沉淀为平台的工具和资源赋能伙伴商品，并与伙伴共享商机，创造更多商业化价值。 持续运营 为伙伴提供经营数据和用户数据等维度的分析能力看板，以及多样灵活的交易结算能力，为伙伴在云商店的稳健经营提供保障。

云商店商业模式 商品类型 说明 开票主体 通用商品 此类商品使用商家品牌和名称，由商家负责 定价 、销售、运营、产品质量管理、交付及售后，云商店仅承担交易平台责任。 云商店商家 联营商品 此类商品使用商家品牌和名称，由云商店和商家共同负责定价、销售、运营及产品质量管理，由商家负责商品交付及售后服务。 华为云计算 技术有限公司 华为商品 此类商品由华为或华为子公司投资并进行产品研发或集成，由华为云负责销售、运营、交付、售后等端到端服务。 华为云计算技术有限公司

订单通知接口描述 客户购买商品并付款成功后，云商店将调用本接口通知商家。 云商店将调用订单通知接口，将订单号同步至商家生产系统中。 商家系统收到该请求信息，需调用云商店查询订单接口，获取本次订购的相关信息。 订单通知接口调用流程如下图所示： 请求参数说明请参见下表。云商店会结合商家创建上架的商品售卖模式来对应请求，商家也需要根据请求的信息来对应执行生产。 请求方式：POST Body参数 参数 是否必选 参数类型 最大字符长度 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 新购场景取值：orderNotify orderId M String 64 云商店订单ID。 orderLineId M String 64 云商店订单行ID。 testFlag M String 2 是否为调试请求。 · 1：调试请求 · 0：非调试请求 默认取值为“0”。 请求消息实例 curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=31BACBD867C7652D7581E8577A46D8FE778F3BC02553C4F130170613CD8C32F9×tamp=1729566664115&nonce=Of4lsV7H1qrzVDI52O5CFk2ofPcZRaA6' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf-8' -d '{"activity":"orderNotify","orderId":"CS2211181819B4LVS","orderLineId":"CS2211181819B4LVS-000001","testFlag":"1"}' 响应参数说明请参见下表： 参数 是否必选 类型 最大字符长度 说明 resultCode M String 6 调用结果码。 成功：“000000” resultMsg O String 255 调用结果描述。 响应消息示例： { "resultCode":"000000", "resultMsg":"success" , } 父主题： 订单通知

操作步骤 接口开发并调测成功后，点击“配置”。 商家根据需求，可以选择“接入类型”或“按商品”的场景进行通知。 下面以“接入类型”为例： ① 勾选客户购买需要订单通知的商品类型。 ② 点击确认后，即生效，后续这类接入类型的所有商品产生的订单都会通知。 订单通知可按照接入类型或按照商品维度进行通知，两种配置方式可单独选择或组合选择，如组合选择后有交集的商品产生订单后仅发送一次通知。 订单通知节点：以选中的通知方式下的商品范围被新购、续费、变更、退订生成订单后进行接口通知。 同一个接入类型或商品仅支持关联一个生产地址，如需更改生产地址请先删除后再在对应生产地址下配置接入类型或商品。 当某个接入类型关联了A生产接口地址，商品关联了B生产接口地址，系统会取商品级的生产地址进行通知。

举例 商家收到的调用请求数据示例如下： curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=31BACBD867C7652D7581E8577A46D8FE778F3BC02553C4F130170613CD8C32F9×tamp=1729566664115&nonce=Of4lsV7H1qrzVDI52O5CFk2ofPcZRaA6' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf-8' -d '{"activity":"orderNotify","orderId":"CS2211181819B4LVS","orderLineId":"CS2211181819B4LVS-000001","testFlag":"1"}'

生成规则 对请求参数排序，根据参数名自然排序，例如，以字母a开头的参数名会排在以b开头的参数前面，如果首字母相同，将会对第二个字母进行排序，以此类推，直到字符串结束 获取规范请求字符串，规则： canonicalRequest = accessKey + nonce + timestamp + Lowercase(HexEncode(HMAC_SHA256 (RequestPayload))) 3.根据规则对规范请求字符串，密钥取signature值，规则： signature = HexEncode(HMAC_SHA256(canonicalRequest))

定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature，并且将signature通过URL PA RAM S的方式添加到URL上，商家在接收到请求后需要同样的规则对请求体进行重新计算signature，并且与云商店传递的signature相比较，完全相同即为校验通过，通过URL PARAMS传递的参数有： 参数 取值 描述 signature String 加密签名，通过一定的规则对请求进行签名产生的值。 timestamp Long UNIX 时间戳（单位毫秒），商家需要校验这个时间戳与当前时间相差不超过60s。 nonce String 随机字符串，云商店在每次调用时会随机生成，商家可以通过对这个随机数的缓存来防御API重放攻击。

资产安全检测标准 商家提交应用资产发布申请后，云商店会对资产中的软件包进行自动化安全扫描，扫描内容如下 检测项 具体要求 病毒扫描 软件包不能包含病毒、木马、恶意程序 软件包漏洞扫描 软件包不能包含CVSS评分≥7.0的高风险级别的漏洞。 支持检测文件的编程语言类型：C/C++/Java/Go/JavaScript/Python/Rust/Swift/C#/PHP。 支持检测的文件：.7z、.arj、.cpio、.phar、.rar、.tar、.xar、.zip、.jar、.apk、.war等格式文件，及Android OTA Images、Android sparse、Intel HEX、RockChip、U-Boot等固件。

联营商品服务支持条款发布说明 联营商品服务支持条款发布说明 联营商品服务支持条款涉及商家与买家、华为云三方，因此商家拟定条款时应使用云商店提供的模板。 接入类型 模板 SaaS、镜像、API、容器、数据资产、AI资产类 联营商品服务支持条款（SaaS、镜像、API、容器、数据资产、AI资产类）.docx License 联营商品服务支持条款（License）.docx 人工服务 联营商品服务支持条款（人工服务）.docx 硬件 联营商品服务支持条款（硬件）.docx 您需根据模板内注释要求修改（如下图，下载模板后可见），请在填写之后对照检查常见错误： 未使用联营服务支持条款模板更新。 使用与本次发布商品接入类型不一致的模板更新。 条款首段：商家公司名称填写不全或与发布主体不符。您可进入商家信息页面查看公司全称。 条款首段：商品名称填写与本次上架的商品名称不一致，或是复制其他商品的协议后未修改。 “数据保护”部分，未补充《商家隐私声明》的URL链接。

通用商品服务协议发布说明 通用商品服务协议发布说明 商品服务协议为线上协议，该协议为商家与买家之间的双方协议 ，下单时勾选生效，线下合同不适用于该场景，协议中不可有留白待填写、盖章生效、签约地点等内容，请调整或下载参考样例模板进行修改，模板可通过点击填写处下方提示中的《通用商品服务协议模板》进行下载。 根据隐私和安全规定，该协议必须包含保护用户个人信息的条款，请添加用户隐私条款。 通用商品服务协议模板填写说明请参考如下内容：

联营商品发布信息填写规范 发布项 审核标准 接入类型 请选择正确的商品接入类型（商品接入类型即商品的交付方式，包含镜像、人工服务、SaaS、API、License、硬件、AI资产、容器、数据资产等）。各接入类型说明，请参见《商品接入类型》。 商品接入类型选择必须与商品本质相符，接入方式与商品本质不相符的申请将被驳回，如：软件（License、SaaS等）商品发布为人工服务商品，人工服务类商品发布为License商品。 商品名称 商品名称应描述准确，与内容相符，且需与上传的软件著作权证书中的名称相符。 商品名称长度不超过50个字符。 商品名称应与业界命名规范一致，不可以出现拼写错误，如：将wordpress拼成wordpess。 商品名称中请勿以“年”、“月”等计费模式，“套”、“次”等计数单位命名。 商品名称不能扩大宣传，不可以直接借助华为云名义，如：命名为“华为云XXX”。 商品名称仅用于对商品命名，介绍、价格、版本、电话号码、免费等与命名无关内容，请勿出现在商品名称中。 如发布的是SaaS类商品，且商家已有相同的镜像、License商品在架，用作区分，请将商品名称命名为“XXXSaaS版”。 如发布的是License类商品，且商家已有相同的镜像、SaaS商品在架，用作区分，请将商品名称命名为“XXX独立部署”。 如发布的是软件配套的人工服务类商品，需合理优化商品名称，请命名为“XXX配套服务”。 如发布的是HCS版商品，请命名为“XXX（HCS版）”。 商品Logo 建议用正方形结构，且四周要留白约15px（使用偏瘦长的上下或者左右结构可能导致Logo展示过小，如果必须使用，请将Logo顶头顶尾排列，保证icon视觉面积大小统一）； 上传的图片要保证 LOG O的清晰度。任何变形、残缺或者不清晰将无法通过审核。 商品主图与视频 图片分辨率不小于800*600，长宽比为4:3，长宽比将影响商品最终展示效果。 主图内容需与商品相关，请勿使用无意义的插图。 视频第一帧不能为黑白单色，否则将影响商品展示效果。 未经授权请勿发布以下内容：华为商标、第三方商标、合作宣传、个人隐私数据（人脸、姓名）等。如已有授权，请邮件发送《授权函》、公司名称、上架的商品名称至partner@huaweicloud.com报备。 商品简介 请简要介绍您的商品信息，此内容将在商品列表和详情页面展示，需与商品强相关，长度不超过120个字符。 商品亮点 商品亮点请着重描述商品功能亮点等内容。 亮点最多添加5条，每条长度不超过50个字符。 商品说明 填写的商品说明，至少包含商品详细信息、商品的核心功能和服务、各个商品规格的功能和服务等。 商品说明不低于400字符，字体要一致，排版要规范，保持整齐美观，请勿出现大量无故换行。 不允许放入非华为云的外部链接等类似跳转信息。 不应出现通过其他方式获取商务等描述，如：商务申请或详细价格请咨询xxx。 避免使用广告法敏感词，如：国家级、最佳、极致、世界第一等。 上传的信息中，如涉及个人隐私数据，如姓名、身份证号码、详细住址、电话、银行账号、邮箱等，请做假名化或匿名化处理；证件信息中的个人图片信息，需打码处理后上传。 若为图文说明，图片支持JPG、JPEG、PNG格式，图片要求宽度为900~1200px，高度不小于800px，最多可上传5张；在详情页将按宽为1136px百分百缩放展示图片；请参见《商品说明参考样例》。 客户案例 如果附有成功案例，应详细描述案例详情，可从案例背景、提升或完善某些能力等角度描述；不能仅填写一个案例名称，最多添加10个案例 在客户案例中，避免使用广告法敏感词，如：国家级、最佳、极致、世界第一等。 商品分类 请选择正确的商品分类（商品分类是指业务所属一级二级导航），商品分类必须与商品所属导航一致。 商品标签 若选择鲲鹏、混合云、loT商品认证标签，需同步上传与商品名称相符且对应的认证证书，请参见鲲鹏、混合云、IOT商品发布规范。 分成模式 商家与云应用商店分成。 1、成交价分成：商家的最终收入是波动的，且与商品成交价相关。商品成交价升高，商家的最终收入升高；反之商品成交价降低，商家的最终收入也降低。 2、底价分成：商家的最终收入是固定的，与商品成交价无关。 分成规则 如选择标准分成规则或非标分成规则，若是非标分成，需要填写与华为接口人商务洽谈结论一致的分成比例。 使用指南 请提供与商品相符的有效的操作手册和商品手册，而非商品介绍。使用指南须说明用户从云商店购买产品后，如何登录、使用等。 使用指南的商品名称须与发布的商品名称保持一致，公司名称和发布的公司主体保持一致。 SaaS类商品的使用指南中不可出现未部署在华为云基础设施中的使用地址、登录地址等链接。 人工服务类商品的使用指南须说明用户从云商店购买商品后如何使用，如服务内容、服务流程等。 镜像类商品的使用指南须说明镜像购买并部署在华为云主机后，须开放哪些端口、如何登入使用等。 API类商品的使用指南须补充如何使用该商品的API接口等相关内容，用于指导用户操作。 字体要一致，排版要规范，保持整齐美观。 使用指南中请勿出现通过其他方式获取商务等描述，如：商务申请或详细价格请咨询xxx。 支持上传rar、zip、doc、docx、pdf、ppt、pptx格式的文件，文件大小不超过20M。 服务内容 请简要描述商品售后服务内容如支持范围，支持形式，售后支持是否额外收费等。 软件著作权证书 软著名称需与商品名称一致，著作权人需与发布主体一致；如不一致，需将承诺函与软著一起上传。 如软著正在申请中，可提供承诺函。 所有场景承诺函模板，在上传软著处下载。 商品服务协议 请下载模板，按照模板要求填写，请勿使用个人模板。要求填写后粘贴至输入框。协议内容需遵循平台规则，请勿使用线下协议，协议中不可出现留白待填写、盖章生效、签约地点等内容。

通用商品发布信息填写规范 发布项 填写规范 商品接入类型 请选择正确的商品接入类型（商品接入类型即商品的交付方式，包含镜像、人工服务、SaaS、API、License、硬件、AI资产、容器、数据资产等）。各接入类型说明，请参见《商品接入类型》。 商品接入类型选择必须与商品本质相符，接入方式与商品本质不相符的申请将被驳回，如：软件（License、SaaS等）商品发布为人工服务商品，人工服务类商品发布为License商品。 商品名称 商品名称应描述准确，与内容相符，且需与上传的软件著作权证书中的名称相符。 商品名称长度不超过50个字符。 商品名称应与业界命名规范一致，不可以出现拼写错误，如：将wordpress拼成wordpess。 商品名称中请勿以“年”、“月”等计费模式，“套”、“次”等计数单位命名。 商品名称不能扩大宣传，不可以直接借助华为云名义，如：命名为“华为云XXX”。 商品名称仅用于对商品命名，介绍、价格、版本、电话号码、免费等与命名无关内容，请勿出现在商品名称中。 如发布的是SaaS类商品，且商家已有相同的镜像、License商品在架，用作区分，请将商品名称命名为“XXXSaaS版”。 如发布的是License类商品，且商家已有相同的镜像、SaaS商品在架，用作区分，请将商品名称命名为“XXX独立部署”。 如发布的是软件配套的人工服务类商品，需合理优化商品名称，请命名为“XXX配套服务”。 如发布的是HCS版商品，请命名为“XXX（HCS版）”。 商品LOGO 建议用正方形结构，且四周要留白约15px（使用偏瘦长的上下或者左右结构可能导致LOGO展示过小，如果必须使用，请将LOGO顶头顶尾排列，保证icon视觉面积大小统一）； 上传的图片要保证LOGO的清晰度。任何变形、残缺或者不清晰将无法通过审核。 服务流/商品交付流程 服务流用于定义商品的交付履行过程。不同接入类型可选择的服务流模板不同，请参见《8.5-服务监管》。 生产接口地址 SaaS类商品生产接口地址需要部署在华为云上 SaaS和license类商品的生产接口地址必须为域名地址 需求模板 旨在指导用户提交需求信息，需使用excel、word等格式，便于用户下载编辑，如不符合要求需再行调整； 商家自检 请参见《云商店商品安全审核标准3.0》自检商品是否满足安全要求，如未满足，请修复安全问题后发布。 商品主图与视频 请上传商品图片和视频，上架后在商品详情页展示，不超过5个。 图片支持JPG、JPEG、PNG、GIF格式，尺寸：800*600，图片大小不超过5M，商品因尺寸原因无法清晰查看图片内容将无法通过审核。 商品主图须与商品内容相关，如商品使用页面、介绍等，不可只上传logo、名称等无介绍作用的图片。 上传的商品图片或视频中，如出现人像照片，请打码处理后上传。 视频支持mp4（视频编码H264）、mov格式，分辨率1280*720px，视频大小不超过200MB。 说明： 视频在商品页展示时，会缺省展示视频第一帧作为预览图片，请根据实际需要设置视频第一帧内容，不可是单色页面，如：全黑或全白。 商品简介 请简要介绍您的商品信息，此内容将在商品列表和详情页面展示，需与商品强相关，长度不超过120个字符。 商品说明 填写的商品说明，至少包含商品详细信息、商品的核心功能和服务、各个商品规格的功能和服务等。 商品说明不低于400字符，字体要一致，排版要规范，保持整齐美观，请勿出现大量无故换行。 不允许放入非华为云的外部链接等类似跳转信息。 不应出现通过其他方式获取商务等描述，如：商务申请或详细价格请咨询xxx。 避免使用广告法敏感词，如：国家级、最佳、极致、世界第一等。 上传的信息中，如涉及个人隐私数据，如姓名、身份证号码、详细住址、电话、银行账号、邮箱等，请做假名化或匿名化处理；证件信息中的个人图片信息，需打码处理后上传。 若为图文说明，图片支持JPG、JPEG、PNG格式，图片要求宽度为900~1200px，高度不小于800px，最多可上传5张；在详情页将按宽为1136px百分百缩放展示图片；请参见《商品说明参考样例》。 商品亮点 商品亮点请着重描述商品功能亮点等内容。 亮点最多添加5条，每条长度不超过50个字符。 客户案例 如果附有成功案例，应详细描述案例详情，可从案例背景、提升或完善某些能力等角度描述；不能仅填写一个案例名称，最多添加10个案例。 在客户案例中，避免使用广告法敏感词，如：国家级、最佳、极致、世界第一等。 服务支持条款 请上传完整的协议附件，该协议为商家与买家之间的双方协议，下单时勾选生效。 协议中商品名称、商品定义、商品计费等各项协议，必须与该商品实际情况一致。 协议为下单时勾选生效的线上协议，协议中不可有留白待填写、盖章生效等内容。 协议必须在有效期范围内。 删除协议中的无关注释内容。 联营商品服务支持条款请参见《联营商品服务支持条款发布说明》。 售后服务信息 参照样例按照实际服务内容表述，至少包含服务内容、服务时间、服务电话、服务邮箱4项内容。 说明： 如售后服务时间超过5*8小时，请确保服务时间内及时响应各联系方式收到的各类售后问题，如超过2次出现未及时答复情况，云商店将对商品进行下架处理。 售后服务邮箱，请确保邮件24小时内能得到答复，如超过2次出现未及时答复情况，云商店将对商品进行下架处理。 如按模板修改，请注意删除示例内容。 使用指南 请提供与商品相符的有效的操作手册和商品手册，而非商品介绍。 使用指南须说明用户从云商店购买产品后，如何登录、使用等。 镜像商品须说明镜像购买并部署在华为云主机后，须开放哪些端口、如何登入使用等。 使用指南中不可出现未部署在华为云基础设施中的使用地址、登录地址等链接。 字体要一致，排版要规范，保持整齐美观。 使用指南中请勿出现通过其他方式获取商务等描述，如：商务申请或详细价格请咨询xxx。 支持上传rar、zip、doc、docx、pdf、ppt、pptx格式的文件，文件大小不超过20M。 软件著作权证书 软件著作权证书中的软件名称必须上传与商品名称相符的软件著作权证书，且著作权人须与发布商品公司主体一致；如不相符，请出具承诺函，模板可通过点击下方提示中的“参考样例”进行下载。 如发布的是容器类商品，需要上传软件著作权证书和容器镜像测试报告。 一个软件著作权证书对应一个商品；如一个软著对应同一商品的多个功能，请在发布该商品时，添加多个规格做区分。 支持rar、zip、doc、docx、pdf、ppt、pptx格式文件。 文件大小不超过20M。 最多支持上传5个。 开源软件声明 商品如涉及开源部分，请如实提供商品开源声明。 支持rar、zip、doc、docx、pdf、ppt、pptx格式文件。 文件大小不超过20M。 支持上传1个。 商品分类 请选择正确的商品分类（商品分类是指业务所属一级二级导航），商品分类必须与商品所属导航一致 商品标签 若选择鲲鹏、混合云、loT商品认证标签，需同步上传与商品名称相符且对应的认证证书，若无相关证书，请勿选择该认证标签，请参见鲲鹏、混合云、IOT商品发布规范 分成规则 通用商品分成规则需选择“标准分成”，具体比例请参见通用商品平台费规则。 商品规格 商品规格名称是对规格的命名，请勿出现大量描述性词汇，如详情请咨询、电话号码等描述。 商品规格名称长度不超过50个字符。 规格名称不能直接借助华为云名义，如命名为“华为云XXX”。 商品规格名称的命名应有一定规则，请勿以“规格1”、“规格2”等无规格信息的简单文字，“年”、“月”等计费模式，“套”、“次”等计数单位命名。 商品请勿发布“0元”免费试用规格，避免被无限购买的风险。 软件商品的规格请勿涉及人工服务内容，如：运维服务、迁移服务、定制开发等，需要另外发布一个配套的“人工服务”商品，命名为“XXX配套服务”，再添加该规格。 发布人工服务类商品时，若商品规格涉及人天服务内容，请设置SKU规格，发布多SKU定价的商品规格（请参见《发布多SKU定价的商品规格》）。 发布镜像类商品时，请选择正确的云主机型号，推荐选择“系列II通用共享型”或“系列II通用独享型”这两类云主机规格进行镜像发布。 同一商品的不同版本和不同功能，请以规格作区分，按照多规格、多SKU的形式发布，无需以不同的版本、不同场景发布多个商品。例如：某商品有多种功能，其中每种功能都有多个版本，请按多规格、多SKU规格的形式发布一个商品即可。 搜索引擎优化信息 请配置适合商品的优化信息，利于百度等第三方搜索引擎收录。请参见《填写指南》的说明进行填写，如填写信息不符合规范将会被驳回。

前提条件 鲲鹏商品在华为云云商店发布前必须先通过沃土云创认证并获取HUAWEI COMPATIBLE或HUAWEI ENABLED证书，如何认证并获取认证证书请参考《申请沃土云创方案认证》。 混合云商品在华为云云商店发布前须加入 华为云Stack 技术伙伴计划，并认证华为云Stack方案，获取华为云Stack技术认证证书；如何认证并获取认证证书请参考沃土云创计划。提交华为云Stack方案认证，目前在线支持华为云Stack鲲鹏方案认证。 IoT商品在华为云云商店发布前须获取IoT技术认证证书；如何认证并获取认证证书请参考《华为IoTOpenlab华为技术证书测试资料下载汇总（包含测试用例与测试报告模板）》。

鲲鹏商品发布规范 发布鲲鹏商品时，“商品简介”和“商品说明”必须有鲲鹏相关的描述信息。 发布鲲鹏商品时，必须选择“鲲鹏”商品认证标签。 发布鲲鹏商品时，必须通过鲲鹏兼容性认证并同步上传HUAWEI COMPATIBLE或HUAWEI ENABLED证书。 以镜像交付方式发布鲲鹏商品时，支持选择“华北-北京四”、“华南-广州”和“华东-上海一”三个云服务区。 鲲鹏镜像必须在以上3个区域制作并在该云服务区发布，不能选择其他云服务区。

操作步骤 在添加商品规格时，选择“定价模板”为“自定义模板”。 填写商品规格名称，需填写中文与英文两个版本，英文版在用户的消费账单（切英文语言）页面对用户可见。 选择商品属性、生成SKU。 点击“选择商品属性”，勾选要用于商品定价的商品属性。 数量属性类型为非必选，最多选择1个； 枚举属性类型为非必选，最多可选择5个。 如无商品属性可选，则您未创建商品定价属性，请先在弹窗出点击下方“新增属性”按钮，创建用于生成SKU的商品定价属性。具体操作请参考《商品属性管理》。 在选择商品定价属性阶段，也可点击“操作”一栏的图标，进行属性编辑。 点击“下一步”，设置属性。 填写所选的数量类型属性的最大值、最小值与步长。 填写所选的枚举类型属性的枚举值，每个枚举属性的枚举值个数最多添加10个，每个枚举值都需要填写中文取值与英文取值，英文取值在用户的消费账单（切英文语言）页面对用户可见。 默认可支持生成的SKU总数为100个（即每个枚举属性的枚举值个数的乘积不能超过100），如超出上限，请删除一些不必要展示的枚举值。 数量属性的最大值、最小值指规格定价中该数量属性维度买家可进行购买的最大值、最小值，如：用户数售卖范围为5-1000，则设置最大值为1000，最小值为5。 数量属性的步长指规格定价中该数量属性维度，买家每增加一个数量单位的长度，如：用户数售卖范围为5-1000，步长为5，则用户可购买的数量为5，10，15，20……以此类推。 枚举属性的枚举值指规格定价中该枚举属性下的计费项，如：软件分版本销售，则枚举属性“软件版本”下设置枚举值为：基础版、专业版、旗舰版。 点击枚举值右边图标可调整规格展示顺序，此处的顺序即为商品详情页的枚举值展示顺序。 点击“下一步”，生成SKU，确认无误后点击“确认”。SKU名称由每一个枚举属性的枚举值排列组合生成，在商品详情页不会对用户展示，在用户的消费账单页面对用户可见。 选择计费模式，勾选需要向用户售卖的SKU，设置价格。 只有在此处勾选并设置价格的SKU，用户在商品详情页进行订购操作时，才可以选中并获取价格；未勾选的SKU，用户在商品详情页无法选择购买。 选择了数量类型的商品属性，在定价前还需要选择定价模式（线性定价、Tier阶梯定价、Step阶梯定价）。 线性定价即商品售价=用户订购的数量类型属性数值*规格定义单价。 图1 线性定价 Tier阶梯定价即由您自由设置每个SKU的数量区间，每个区间单独定价，单独计费，即商品售价=用户订购数量*数量所属区间的单价。 图2 Tier阶梯定价 Step阶梯定价即由您自由设置每个SKU的数量区间，每个区间单独定价，叠加计费，即商品售价=用户订购区间数量1*区间规格单价1+用户订购区间数量2*区间规格单价2。 图3 Step阶梯定价 勾选需要进行预览的SKU，点击右上角的“预览规格”即可查看商品规格展示页面。 勾选“允许试用”，填写试用天数。当前支持设置的试用时间区间为3-180天，按次模式不支持试用。 人工服务类、License类和硬件类商品不支持试用规格，设置多SKU商品规格时可忽略此步骤。

请求方法：GET 参数 是否必选 参数类型 最大字符长度 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 续费场景取值：refreshLicense orderId M String 64 云商店订单ID。 说明： 续费操作会产生新的订单，与新购时订单ID不一致，请通过instance Id做资源识别。 instanceId M String 64 实例ID。 productId O String 64 产品标识，租户续费或转正产品实例时，如果订购周期类型发生变化，会传入变化后的产品类型对应的productId。 expireTime M String 20 过期时间。 格式：yyyyMMddHHmmss authToken M String 50 安全校验令牌。 取值请参见authToken取值说明。 timeStamp M String 20 请求发起时的时间戳，取UTC时间。 格式：yyyyMMddHHmmssSSS periodType O String 10 周期类型。 说明： 非必传，如需此参数，计费类型需选择包周期chargingMode=1，包周期购买场景请求时传该参数。 年："year" 月："month" periodNumber O integer 2 周期数量。 说明： 非必传，如需此参数，计费类型需选择包周期chargingMode=1，包周期购买场景请求时传该参数。 周期数量：1,2,3…