创建实例-j9九游会登录
接口说明
用户购买商品并付款成功,云商店将调用本接口通知商家创建实例,商家需要结合saas应用的实际情况,给用户开通saas服务,比如:saas网站的账号、密码等。
- 商家需要返回此订单的唯一id(instanceid)。建议此id直接使用该订单首次请求时云商店传入的businessid,以确保instanceid的唯一性。
- 在正常购买场景中,请不要阻塞此接口,如果耗时较长,建议异步创建实例,可以先生成instanceid,然后立即返回。云商店后续会通过查询实例信息接口查询实例开通结果。
- 如涉及按需、按需套餐包商品,需要对接按需使用量推送(新)接口。
- 获取订单信息,请参考查询订单接口。
- 云商店服务有可能重发请求,针对同一订单号(orderid)和订单行(orderlineid),商家的服务器应当返回相同的instanceid,不应该创建新的saas实例,返回之前成功创建的实例信息即可。
- 按需交易场景,需要基于订单号(orderid)和产品标识(productid)构建幂等。
- 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。
- 云商店会对接口异常的情况做监控,如saas商品频繁出现因接口异常的情况,云商店将对该商品做下架处理。
创建实例流程如下图所示:

请求方法:post
body参数
|
参数 |
是否必选 |
参数类型 |
最大字符长度 |
说明 |
|---|---|---|---|---|
|
activity |
m |
string |
20 |
接口请求标识,用于区分接口请求场景。 新购场景取值:newinstance |
|
orderid |
m |
string |
64 |
云商店订单id。 |
|
orderlineid |
m |
string |
64 |
云商店订单行id。 |
|
businessid |
m |
string |
64 |
云商店业务id。 每一次请求,businessid皆不一致。 |
|
testflag |
o |
string |
2 |
是否为调试请求。
|
请求消息示例:
curl -x post 'https://www.isvwebsite.com/saasproduce?signature=11c4cd6279191de931def5c51531dffa9d37969f4e356b8a3a6d8de4fb357a48×tamp=1680508066618&nonce=50d83fdecaed6ccd8ef597f2a577950527928ba287d04e6036e92b2806fd17da' -h 'accept:application/json' -h 'content-type:application/json;charset=utf8' -d'{"activity":"newinstance","businessid":"87b94795-0603-4e24-8ae5-69420d60e3c8","orderid":"cs2211181819b4lvs","orderlineid":"cs2211181819b4lvs-000001","testflag":"1"}'
响应消息
响应参数说明请参见下表:
|
参数 |
是否必选 |
类型 |
取值范围 |
参数说明 |
|---|---|---|---|---|
|
resultcode |
m |
string |
6 |
调用结果码。
具体请参见1.9 调用结果码说明 说明:如果创建实例耗时较长,建议返回000004,云商店后续会通过查询实例信息接口查询实例开通结果 |
|
resultmsg |
o |
string |
255 |
调用结果描述。 |
|
instanceid |
m |
string |
64 |
实例id,商家提供的唯一标识,每个新购订单都需要提供不重复的唯一标识。 建议此id直接使用该订单首次请求时云商店传入的businessid,以确保instanceid的唯一性。
说明:
云商店每次请求时的businessid皆不一致,如取businessid作为instanceid,取订单首次调用时的businessid即可。 |
响应消息示例:
{
"resultcode":"000000",
"resultmsg":"success" ,
"instanceid":"03pf80c2bae96vc49b80b917bea776d7"
}
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨