Membership level update

Event Group	Event Identification
app_memberSystem_membershipLevels	app_memberSystem_membershipLevels/challenged

When the current category changes in the category , inform the monitor to perform a level information update process corresponding to the customer .

Request Headers

X-Shopline-Topic string required

The unique identifier for the event.

Example: orders/edited
X-Shopline-Hmac-Sha256 string required

The signature of the request. Upon receiving the request, you must verify the signature to confirm the authenticity and integrity of the data.

Example: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
X-Shopline-Shop-Domain string required

The store domain.

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

The store ID.

Example: 1610418123456
X-Shopline-Merchant-Id string required

The merchant ID.

Example: 2000001234
X-Shopline-API-Version string required

The API version.

Example: v20250601
X-Shopline-Webhook-Id string required

The ID of this Webhook event.

Example: b54557e48a5fbf7d70bcd043

Request Body

buyer_id string

Customer id
Example: 2404721679
level_code string

The code of current level membership of the customer.
Example: MLC6568224957444662294
level_code_before string

The code of level membership of the customer before update. If the customer was a non-member, the field will be null.
Example: MLC6568224957444662294
level_expiry_time long

The expiry time of current level membership of the customer. If the field is empty when membershipType = LEVEL, it means the membership is valid permanently.
Example: 1769270399000
level_name string

The name of current level membership of the customer. Up to 25 characters.
Example: LEVEL_2
level_name_before string

The name of level membership of the customer before update. Up to 25 characters. If the customer was a non-member, the field will be null.
Example: LEVEL_1
level_order integer

Relevant only when membershipType = LEVEL. Higher the field indicates a higher level.
Example: 1
level_order_before integer

The order of the level membership of the customer before update. Relevant only when membership_type = level. Higher the field indicates a higher level.
Example: 2
level_updated_time long

The start time of current level membership of the customer.
Example: 1721750465000
remark string

Remarks
Example: remark
store_id string

store ID
Example: 1718263946864
updated_source string

Update source

HISTORY_DATA: Historical data

MANUALLY_UPDATE: Manual adjustment by the merchant

PURCHASE_UPGRADE: Customer upgrade after consumption

ORDER_RETURN: Order refund

LEVEL_EXPIRED: Level expiration

CUSTOMER_REGISTRATION: Customer registration

RULE_ADJUSTED: Rule adjustment

ORDER_EDITED: Order edit
Example: MANUALLY_UPDATE
updated_type string

Update type

INITIATION: Become a customer of your store

DOWNGRADE: Member downgrade

UPGRADE: Member upgrade

LOCKIN: Member level maintenance

UPDATE: Level update
Example: UPDATE

Status Codes

After receiving a webhook notification from SHOPLINE, you must respond with the following format:

HTTP/1.1 200 OK

For more information about how to subscribe to webhooks and webhook response rules, refer to Webhook overview.

Was this article helpful to you?

SHOPLINE

Legal