客户更新

Webhookcustomers/update

C 端客户更新时触发。

需要 customer 访问权限。最低支持版本：202007。

请求头

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，同一事件重发时保持不变，用于幂等去重

请求体

数据结构
示例

customer object
idstring
顾客的唯一标识
namestring
顾客的名字
first_namestring
顾客的名
last_namestring
顾客的姓
emailstring
顾客的电子邮件地址
phonestring
顾客的电话号码
phone_area_codestring
顾客电话号码的区号
contact_typestring
联系方式类型，邮箱或电话
accepts_marketingboolean
顾客是否订阅了营销邮件
accepts_sms_marketingboolean
顾客是否订阅了短信营销活动
subscribed_flaginteger
顾客的营销订阅状态
sms_subscribed_flaginteger
顾客的短信订阅状态标志
registeredboolean
顾客是否已注册
free_taxboolean
顾客是否享有税收豁免
tagsstring
顾客标签
sourcestring
顾客数据来源
orders_countinteger
顾客的累计下单数量
total_spentstring
顾客的累计消费金额
first_order_atstring
顾客首次下单时间
last_order_atstring
顾客最后一次下单时间
created_atstring
顾客创建时间，ISO-8601 格式
updated_atstring
顾客最后更新时间，ISO-8601 格式
default_address object
顾客设置的默认地址
idstring
地址记录的 ID
customer_idstring
所属顾客的 ID
first_namestring
收件人的名
last_namestring
收件人的姓
namestring
收件人的全名（first_name + last_name 拼接）
companystring
公司名称
address1string
主街道地址
address2string
第二行地址
citystring
城市
areastring
区域（区/县）
provincestring
省/州
province_codestring
省/州代码
countrystring
国家
country_codestring
ISO 国家代码
country_namestring
国家全称
zipstring
邮政编码
phonestring
联系电话
phone_area_codestring
电话区号
emailstring
与地址关联的联系邮箱
genderstring
收件人的性别
defaultboolean
是否为默认地址
addresses object[]
顾客的所有地址列表
Array [
idstring
地址记录的 ID
customer_idstring
所属顾客的 ID
first_namestring
收件人的名
last_namestring
收件人的姓
namestring
收件人的全名（first_name + last_name 拼接）
companystring
公司名称
address1string
主街道地址
address2string
第二行地址
citystring
城市
areastring
区域（区/县）
provincestring
省/州
province_codestring
省/州代码
countrystring
国家
country_codestring
ISO 国家代码
country_namestring
国家全称
zipstring
邮政编码
phonestring
联系电话
phone_area_codestring
电话区号
emailstring
与地址关联的联系邮箱
genderstring
收件人的性别
defaultboolean
是否为默认地址
]

{
  "customer": {
    "id": "string",
    "name": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "phone": "string",
    "phone_area_code": "string",
    "contact_type": "string",
    "accepts_marketing": true,
    "accepts_sms_marketing": true,
    "subscribed_flag": 0,
    "sms_subscribed_flag": 0,
    "registered": true,
    "free_tax": true,
    "tags": "string",
    "source": "string",
    "orders_count": 0,
    "total_spent": "string",
    "first_order_at": "string",
    "last_order_at": "string",
    "created_at": "string",
    "updated_at": "string",
    "default_address": {
      "id": "string",
      "customer_id": "string",
      "first_name": "string",
      "last_name": "string",
      "name": "string",
      "company": "string",
      "address1": "string",
      "address2": "string",
      "city": "string",
      "area": "string",
      "province": "string",
      "province_code": "string",
      "country": "string",
      "country_code": "string",
      "country_name": "string",
      "zip": "string",
      "phone": "string",
      "phone_area_code": "string",
      "email": "string",
      "gender": "string",
      "default": true
    },
    "addresses": [
      {
        "id": "string",
        "customer_id": "string",
        "first_name": "string",
        "last_name": "string",
        "name": "string",
        "company": "string",
        "address1": "string",
        "address2": "string",
        "city": "string",
        "area": "string",
        "province": "string",
        "province_code": "string",
        "country": "string",
        "country_code": "string",
        "country_name": "string",
        "zip": "string",
        "phone": "string",
        "phone_area_code": "string",
        "email": "string",
        "gender": "string",
        "default": true
      }
    ]
  }
}

请求头​

请求体​

请求头

请求体