Points update

Event Group	Event Identification
app_memberSystem_points	app_memberSystem_points/challenged

When the customer's current points change, inform the monitoring party to update the corresponding customer's points information.

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
points_balance long

Remaining available points
Example: 20
points_expiry_time long

Time when the points updated this time expires. Relevant only when update_type = increase. This field is empty when the reward does not expire.
Example: 1721829526566
store_id string

store ID
Example: 1718263946864
update_type string

Point update type.

DECREASE: Points decrease

INCREASE: Points increase
Example: DECREASE
updated_at long

Update time
Example: 1721829526566
updated_scene string

Points update scenario types.

SUCCESSFUL_REGISTRATION: Customers get points after registration.

LOGIN_SUCCESS: Customers get points after successful login.

CUSTOMERS_BIRTHDAY: Customers get points on their birthdays.

SUCCESSFUL_ORDERS: Customers get points after successfully placing orders.

EMAIL_SUBSCRIPTION: Customers get points by subscribing to their email addresses.

ENTER_PHONE: Customers get points by filling in their phone numbers.

ENTER_BIRTHDAY: Customers get points by filling in their birthdays.

SHARE_FB: Customers get points by sharing on Facebook.

FOLLOW_FB: Customers get points by following Facebook.

FOLLOW_INS: Customers get points by following Instagram.

DAILY_ATTENDANCE: Customers get points by signing in daily.

PRODUCT_REVIEWS: Customers get points by reviewing products.

TOP_REVIEWS: Customers get points by reviewing products selected as high-quality reviews.

LEVEL_MEM_BENEFITS: Level membership benefits get points.

PAID_MEM_BENEFITS: Paid membership benefits get points.

SUCCESSFUL_REFERRAL: Customers get points by successfully completing referrals.

MANUALLY_INCREASE: The merchant manually adds points to the customer.

CUSTOMER_IMPORT_INCREASE: The merchant manually imports customers to issue points to them.

CASHBACK: The customer uses points to get cashback and points are deducted.

REDEEM_COUPON_CODE: The customer uses points to redeem coupon codes and points are deducted.

REDEEM_COUPON: The customer uses points to redeem coupons and points are deducted.

REDEEM_FREE_SHIPPING: The customer uses points to redeem free shipping coupons and points are deducted.

REDEEM_PRODUCTS: The customer uses points to redeem products and points are deducted.

MANUALLY_DECREASE: The merchant manually deducts points for the customer.

CUSTOMER_IMPORT_DECREASE: The merchant manually imports customers to deduct points for them.

POS_DECREASE: POS deducts points.
Example: SUCCESSFUL_REGISTRATION
updated_value long

Number of points for this update
Example: 20

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