---
title: "Update Customer Member Points"
method: POST
path: "/customers/{id}/member_points"
tags: ["Customers"]
---

# Update Customer Member Points

`POST /customers/{id}/member_points`

Using open API to update customer member points

## Path parameters

- `id` string, required

## Request body

- object
  - `value` integer, required — Points to be added or deducted<br>增加或減除點數<br>-<br>*Number can be -999999~999999
  - `remarks` string, required — Reason for adding or deducting member points<br>增加或減除點數原因<br>-<br>*Limit to max 50 characters
  - `email_target` 1 | 3 — Notification with Email<br>是否發送email通知<br>Only applicable for addition<br>僅適用於增加<br>-<br> 1=NOT_SEND全部不送<br> 3=SEND_TO_ALL全部都送
  - `sms_notification_target` 1 | 2 | 3 — Notification with SMS<br>是否發送簡訊通知<br>Only applicable for addition<br>僅適用於增加<br>-<br> 1=NOT_SEND全部不送<br> 2=SEND_VERIFIED只送手機驗證過的<br> 3=SEND_TO_ALL全部都送
  - `performer_id` string — Performer ID<br>操作者ID
  - `performer_type` 'User' | 'Agent' — Performer Type<br>操作者類型
  - `expire_date` string, date, nullable — Expiry date of points (YYYY-MM-DD format, e.g. 2026-03-19).<br> Only available when feature member_points_expiry_enhancement is enabled.<br> - date string: expires at end of day in merchant timezone (23:59:59.999)<br> - null: never expires<br> - omitted: expiry calculated from global earn_from_order rule

## Response `201`

CREATED

- MemberPoint
  - `customer_id` string — Customer ID
  - `point_balance` integer — Member Point<br>現有點數
  - `remarks` string — Point Change Reason<br>點數更動原因
  - `value` integer — Point<br>點數
  - `order_id` string — Order ID
  - `order_number` string — Order Number
  - `type` 'manual' | 'auto_reward' | 'expired' | 'order_redeemed' | 'redeemed_to_cash' | 'order_split_revert' | 'product_review_reward' | 'member_info_reward' | 'return_order_revert' | 'order_edit_revert' — Member point type<br>點數種類 <br>----<br> manual: 手動增減點數（店家手動發送、取消訂單/退貨訂單回補）<br> auto_reward: 點數回饋<br> expired: 點數過期<br> order_redeemed: 使用點數兌換贈品於訂單<br> redeemed_to_cash: 使用點數折現於訂單<br> order_split_revert: 回補點數（來自拆單）<br> product_review_reward: 商品評價獎賞<br> member_info_reward: 會員資料獎賞<br> return_order_revert: 退貨單回補會員點數<br> order_edit_revert: 訂單編輯回補會員點數
  - `is_redeem` boolean — Redeemed?<br>已兌換?
  - `end_at` string — Expiry date, a null value means never expired<br>到期日期, null 表示不會到期
  - `created_at` string — Created Time<br>點數創建時間

## Other responses

- `401` — Bad authentication
- `403` — Forbidden
- `404` — Product not found error
- `422` — Unprocessable entity error
- `500` — Server error

---

[API](https://skmtc.net/shoplineapp/apis/shopline-open-api.md) · [All operations](https://skmtc.net/shoplineapp/apis/shopline-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shoplineapp/shopline-open-api/revisions/1675ac12cde7/schema)