下单前锁定库存

接口说明

商户下单前调用该接口锁定库存。库存不足时会返回错误码,库存充足时即可继续创建订单。

接口路径: /vmcloud/api/external/lockGoodStock
请求类型: POST
内容类型: application/json

请求头

名称 必填 说明
x-ak 是 访问密钥 ID
x-timestamp 是 请求时间戳
x-sign 是 请求签名
x-merchant 是 商户名称
x-nonce 是 随机串

请求参数

参数 类型 必填 说明
orderId string 是 订单 ID
configId number 是 SKU ID
goodNum number 是 商品数量
goodTimeId number 是 计费时长 ID
openId string 是 商户端用户唯一 ID
payPrice number 是 商品价格

响应参数

参数 类型 说明
code number 错误码
msg string 错误内容描述
data object 锁定结果
timeName object 商品时长名称信息
goodTime string 商品时长
goodTimeId string 商品时长 ID
goodPrice string 商品价格

请求示例

{
  "orderId": "OD-1231xxx577",
  "configId": 10,
  "goodNum": 1,
  "goodTimeId": 1,
  "openId": "ltxxxxxxxx",
  "payPrice": 9900
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "timeName": {
      "goodTime": "30m",
      "goodTimeId": "1",
      "goodPrice": "9900"
    }
  }
}