跳到主要内容

购物车创建

Webhookcart/create

购物车新增商品时触发。

需要 order 访问权限。最低支持版本:202201

请求头

    X-Shoplazza-Topicstring

    触发本次推送的事件,例如 orders/create

    示例: orders/create
    X-Shoplazza-Hmac-Sha256string

    请求体的 HMAC-SHA256 签名(base64 编码),使用应用的 Client Secret 生成,用于验证请求来自 Shoplazza

    X-Shoplazza-Shop-Domainstring

    产生该事件的店铺域名

    示例: example.myshoplaza.com
    X-Shoplazza-Api-Versionstring

    序列化 payload 使用的 API 版本

    示例: 2025-06
    X-Shoplazza-Deduplication-IDstring

    本次推送的去重 ID,同一事件重发时保持不变,用于幂等去重

请求体

  • cart object
    created_atstring

    购物车创建时间

    currency_codestring

    货币代码

    discount_applications object[]

    购物车优惠明细

  • Array [
  • apply_methodstring

    自动活动行的应用方式

    codestring

    优惠码 code(仅优惠码活动有)

    discount_amountnumber

    优惠金额

    discount_idstring

    优惠 ID

    discount_messagestring

    优惠提示文案

    discount_textstring

    优惠文案(可能是 title 或 label)

    discount_typestring

    优惠码折扣类型:折扣 / 固定减价(仅优惠码有)

    entitled_product_listundefined[]

    优惠作用商品列表

    extentsobject

    扩展字段(string→string 键值对,键不固定)

    extents.application_timestring

    应用时间

    extents.business_custom_datastring

    业务自定义数据

    extents.discount_apply_typestring

    折扣应用类型

    extents.discount_codestring

    折扣码

    extents.discount_rule_infostring

    折扣规则信息

    extents.old_discount_idstring

    旧优惠 ID

    extents.use_with_otherstring

    是否可与其他折扣叠加

    iconstring

    图标

    is_free_giftboolean

    活动优惠商品列表是否为免费赠品

    messagestring

    输入框提示文案

    propertiesstring

    优惠码附加字段

    statusstring

    优惠码应用状态:success(应用成功)、undetermined(待定)、fail(应用失败)

    subtypestring

    营销活动子类型:discount_rebate(满减)、discount_code(优惠码)、discount_coupon(优惠券)、discount_flashsale(限时促销)、automatic(自动优惠)、buy_x_get_y(买 X 送 Y)

    target_selectionstring

    优惠目标选择方式

    target_typestring

    优惠作用目标:shipping_line(运费)、line_item(商品行)、payment_line(支付方式)

    titlestring

    优惠名称

    typestring

    营销活动类型:discount_rebate(满减)、discount_code(优惠码)、discount_coupon(优惠券)、discount_flashsale(限时促销)、automatic(自动优惠)

    value_typestring

    优惠值类型

  • ]
  • extra object

    购物车变更附加信息

    client_idstring

    客户端 ID

    item_countinteger

    商品数量

    line_items object[]

    购物车商品列表

  • Array [
  • add_quantitystring

    添加数量

    availableboolean

    商品是否可售

    available_quantityinteger

    可用数量

    can_buyboolean

    是否可购买

    compare_at_pricestring

    商品原价(划线价)-单价

    cost_pricestring

    成本价

    customboolean

    是否为自定义商品项

    discount_applications object[]

    该商品项的优惠明细

  • Array [
  • allocation_methodstring

    分配方式

    codestring

    优惠码 code

    discount_amountstring

    折扣金额

    discount_idstring

    优惠 ID

    discount_quantityinteger

    优惠数量

    discount_textstring

    优惠文案(可能是 title 或 label)

    discount_typestring

    优惠码折扣类型

    extentsobject

    扩展字段(键值对,键不固定)

    extents.business_custom_datastring

    业务自定义数据

    extents.old_discount_idstring

    旧优惠 ID

    extents.raw_input_line_item_pricestring

    原始输入的行项目价格

    groupsundefined[]

    折扣应用组

    iconstring

    图标

    is_free_giftboolean

    该商品列表是否为免费赠品

    is_need_splitboolean

    是否允许拆分

    subtypestring

    营销活动子类型(取值见 discount_applications 表)

    target_selectionstring

    优惠目标选择方式

    target_typestring

    优惠作用目标(取值见 discount_applications 表)

    titlestring

    优惠名称

    total_discount_amountstring

    总折扣金额

    typestring

    营销活动类型(取值见 discount_applications 表)

    valuestring

    优惠值

    value_typestring

    优惠值类型

  • ]
  • discount_totalstring

    折扣总额

    final_line_pricestring

    最终行价格

    final_pricestring

    最终单价

    fixed_discount_totalstring

    固定折扣总额

    idstring

    购物车商品项 ID

    imageobject

    商品图片链接

    image.heightinteger

    图片高度

    image.pathstring

    图片路径

    image.srcstring

    图片 URL

    image.widthinteger

    图片宽度

    inventory_policystring

    库存策略(continue 缺货继续销售 / deny 缺货停止销售 / auto_unpublished 缺货自动下架)

    inventory_quantityinteger

    库存数量

    inventory_trackingboolean

    是否启用库存追踪

    item_idstring

    商品项 ID

    line_pricestring

    行价格

    mixed_wholesaleboolean

    是否支持混批

    options object[]

    商品款式属性列表

  • Array [
  • namestring

    款式选项名称

    valuestring

    选项值

  • ]
  • origin_pricestring

    原价

    original_line_pricenumber

    原始行价格

    parts_pricestring

    部件价格

    pricestring

    商品售价-单价

    product_handlestring

    商品 Handle

    product_idstring

    商品 ID

    product_tagsundefined[]

    商品标签

    product_titlestring

    商品标题

    product_typestring

    商品类型

    product_urlstring

    商品链接

    propertiesstring

    商品款式属性(键值对)

    publishedboolean

    商品是否已发布(上架)

    published_atstring

    商品发布时间

    quantitystring

    购买数量

    requires_shippingboolean

    是否需要物流

    retail_pricestring

    零售价

    saved_priceinteger

    节省金额

    skustring

    子款式 SKU

    taxableboolean

    是否需要纳税

    trunk_pricestring

    主干价格

    variant_idstring

    子款式 ID

    variant_titlestring

    子款式标题

    vendorstring

    供应商

    weightstring

    商品重量

    weight_unitstring

    重量单位

    wholesale_price object[]

    批发价(列表)

  • Array [
  • min_quantityinteger

    最小数量

    pricestring

    价格

  • ]
  • ]
  • total_discountstring

    购物车优惠总价

    total_pricestring

    购物车商品总金额

    updated_atstring

    购物车更新时间

    user_idstring

    用户 ID

    user_signstring

    用户签名(游客标识)