检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
公共错误码 表1 错误码 http状态码 error_code error_msg 描述 200 CBC.0000 Success 成功 403 CBC.0150 Illegal operation 鉴权失败 400 CBC.0101 Invalid parameter 请求参数不合法
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例。 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如
组织部门信息同步(增量) 接口说明 管理员被授权管理某企业后,在买家中心登录,对管理的企业执行新建、编辑、删除部门操作时,云商店调用该接口,请求商家同步该企业的组织增量变更;商家接口需要执行增量组织信息同步,保存信息,并返回通知云商店。 商家的服务器在处理接口请求时,需要做好幂等性处理。
部门增量同步 接口说明 管理员被授权管理某企业后,在华为云买家中心控制台登录,对管理的企业执行新建、编辑、删除部门操作时,云商店调用该接口,请求商家同步该企业的组织增量变更;商家接口需要执行增量组织信息同步,保存信息,并返回通知云商店。 商家的服务器在处理接口请求时,需要做好幂等性处理。
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 用户进行商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调
商品logo、商品主图与视频、商品简介、商品说明发布说明 商品logo 1. 商品logo应该保证清晰完整,任何残缺、变形、模糊、内容无法清晰查看等情况都无法通过审核。 2. 如无商品logo,建议使用公司logo,白底,尺寸为120*120。 具体参见如下商品logo规范上传规范:
租户信息同步接口 接口说明 买家购买联营SaaS商品后,在买家中心登录,将应用与企业绑定时,云商店调用该接口请求商家同步该企业的租户信息,商家接口需要执行租户同步,保存租户信息,并返回通知云商店。 针对租户同步场景接口调用失败的情况,由买家选择是否重试,并用短信或邮件的形式通知商家接口调用失败。
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 客户商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调用失败,将可能导致用户的业务被释放的风险。
按需使用量推送(旧) 接口说明 用户在云商店开通按需资源并产生使用量后,商家需通过此接口返回用户的实际使用量话单,云商店获取话单后根据使用量计费并对用户扣费。 SDK请参考《获取SDK》。 如何获取AK/SK请参考《AK/SK认证说明》。 URI POST https://mkt
按需使用量推送(旧) 接口说明 用户在云商店开通按需资源并产生使用量后,商家需通过此接口返回用户的实际使用量话单,云商店获取话单后根据使用量计费并对用户扣费。 SDK请参考《获取SDK》。 如何获取AK/SK请参考《AK/SK认证说明》。 URI POST https://mkt
接口调试 为了保证商家接口的可用性,云商店为商家在卖家中心搭建了应用接入调试界面。商家可以在此页面调试接口在各个调用场景的正确性。 下面以“订单通知”接口为例进行说明。 操作步骤 在“卖家中心 > 应用工具 > 生产地址管理”中,添加生产地址并认证通过。 请将认证通过的生产接口地
商品续费 接口说明 按周期售卖的商品,商家必须实现续费接口生产开发。 客户续费下单或试用商品转正后,云商店将调用该接口请求商家执行业务延期,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障续费接口通畅,将业务进行延期,如续费失败,将可能导致用户的业务被释放的风险。
商品升级 接口说明 用户对已购买的商品进行升级,升级订单付款成功后,云商店调用该接口请求商家升级用户购买的商品,商家接口需要执行商品升级,并返回通知云商店。 针对升级场景接口调用失败的情况,云商店会持续调用3小时后停止调用,期间商家可在“卖家中心>生产接口消息”页面单击对应订单右
商品续费 接口说明 按周期售卖的商品,商家必须实现续费接口生产开发。 客户续费下单或试用商品转正后,云商店将调用该接口请求商家执行业务延期,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障续费接口通畅,将业务进行延期,如续费失败,将可能导致用户的业务被释放的风险。
商品升级 接口说明 用户对已购买的商品进行升级,升级订单付款成功后,云商店调用该接口请求商家升级用户购买的商品,商家接口需要执行商品升级,并返回通知云商店。 针对升级场景接口调用失败的情况,云商店会持续调用3小时后停止调用,期间商家可在“卖家中心>生产接口消息”页面单击对应订单右
按需使用量推送(新) 接口说明 用户在云商店开通按需资源并产生使用量后,商家需通过此接口返回用户的实际使用量话单,云商店获取话单后根据使用量计费并对用户扣费。 SDK请参考《获取SDK》。 如何获取AK/SK请参考《AK/SK认证说明》。 URI POST https://mkt
按需使用量推送(新) 接口说明 用户在云商店开通按需资源并产生使用量后,商家需通过此接口返回用户的实际使用量话单,云商店获取话单后根据使用量计费并对用户扣费。 SDK请参考《获取SDK》。 如何获取AK/SK请参考《AK/SK认证说明》。 URI POST https://mkt
按需使用量推送(新) 接口说明 用户在云商店开通按需资源并产生使用量后,商家需通过此接口返回用户的实际使用量话单,云商店获取话单后根据使用量计费并对用户扣费。 URI POST https://mkt.myhuaweicloud.com/api/mkp-openapi-publi
订单通知接口描述 客户购买商品并付款成功后,云商店将调用本接口通知商家。 云商店将调用订单通知接口,将订单号同步至商家生产系统中。 商家系统收到该请求信息,需调用云商店查询订单接口,获取本次订购的相关信息。 订单通知接口调用流程如下图所示: 请求参数说明请参见下表。云商店会结合商
字符串/文件流上传 功能介绍 商家可通过该接口上传字符串或者文件给云商店。 URI POST https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v1/market-event/{event_id}/file 仅支持https协议。