下单前锁定库存

接口说明

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

接口路径: /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"
    }
  }
}