Sign in

v1

latestOpenAPI 3.0.02026-07-26318168886.7 KB
Member Points

Bulk Update Member Points

Bulk update multiple user member points records. <br> 批量更新多個 users 點數

post/member_points/bulk_update

Request body

user_idsstring[] required

List of user IDs to update. <br> user ID 的列表，指定要更新的 user

valuenumber required

The value to set for each user's member points. <br> 要給予每個 user 的點數數量

remarksstring required

Remarks for the member points update. <br> 點數更新的備註

performer_idstring

The User ID of the performer making the update. Optional. <br> 執行者 User ID

email_target1 | 3

Allowed 1 & 3. 1 means not send, 3 means send all. <br> 電子郵件是否發送，1為不發送，3為發送

sms_notification_target1 | 2 | 3

Allowed 1~3. 1 means not send, 2 means send with verified, 3 means send all. <br> 簡訊是否發送通知，1為不發送，2為發送至驗證手機，3為全部發送

expire_datestring nullable

Expiry date in YYYY-MM-DD format. null means never expires. If not provided, the global expiry rule will be applied. Requires feature flag member_points_expiry_enhancement. <br> 點數到期日（YYYY-MM-DD 格式）。傳 null 代表永不過期，不傳則沿用全域到期規則。 需啟用 member_points_expiry_enhancement 功能。

include_blacklistedboolean

Whether to include blacklisted (login/order-banned, status=blacklisted) customers as recipients. Default false. <br> 是否將黑名單（禁止登入下單，status=blacklisted）顧客納入發放對象，預設 false

Example request

{
  "user_ids": [
    "user1",
    "user2",
    "user3"
  ],
  "value": 100,
  "remarks": "Holiday bonus",
  "performer_id": "performer1",
  "email_target": 1,
  "sms_notification_target": 1,
  "expire_date": "2026-12-31"
}

Response

Successfully updated the member points. <br> 成功更新點數記錄

messagestring
job_idstring

Example response

{
  "message": "Success.",
  "job_id": "67596dd037cdd80016e58022"
}