礼品卡更新

事件分组	事件标识
app_memberSystem_giftCard	app_memberSystem_giftCard/challenged

当客户当前礼品卡变更时，告知监听方进行对应客户的礼品卡信息更新处理。

请求头

X-Shopline-Topic string required

事件的唯一标识。

例子: orders/edited
X-Shopline-Hmac-Sha256 string required

该请求的签名。收到请求后，你需要对该签名进行验签以验证数据的真实性和完整性。

例子: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
X-Shopline-Shop-Domain string required

店铺的域名。

例子: example.myshopline.com
X-Shopline-Shop-Id string required

店铺 ID。

例子: 1610418123456
X-Shopline-Merchant-Id string required

商家 ID。

例子: 2000001234
X-Shopline-API-Version string required

API 版本号。

例子: v20250601
X-Shopline-Webhook-Id string required

该 Webhook 事件的 ID。

例子: b54557e48a5fbf7d70bcd043

请求体

buyer_id string

客户id
例子: 2404721679
current_balance long

变更后礼品卡余额。精确到小数点后两位，比如$10.00会返回1000。
例子: 1000
gift_card_code string

礼品卡卡号
例子: 240acd
gift_card_expiry_date long

礼品卡到期时间，毫秒级时间戳
例子: 1721829526566
gift_card_original_value long

礼品卡面额，精确到小数点后两位，比如$10.00会返回1000。
例子: 10000
scene_type string

场景类型：SELF_PURCHASE：为自己购买，OTHERS_SEND：他人赠送， PURCHASE_PAYMENT：结算时使用礼品卡， RETURN_INCREASE：退款时原路退回，CARD_DIABLED：礼品卡被禁用
例子: SELF_PURCHASE
store_id string

店铺id
例子: 1718263946864
update_type string

礼品卡更新类型。 DECREASE: 礼品卡减少 INCREASE: 礼品卡增加
例子: DECREASE
update_value long

本次更新的礼品卡金额的绝对值。精确到小数点后两位，比如$10.00会返回1000。
例子: 1000
updated_at long

更新时间
例子: 1721829526566

状态码

收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。

HTTP/1.1 200 OK

关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 Webhook 概述。

这篇文章对你有帮助吗？

SHOPLINE

SHOPLINE

条款协议

隐私