---
# System prepended metadata

title: 分鐘卡優化 API 文件

---

# 分鐘卡優化 API 文件
###### tags: `分鐘卡優化`, `gundamSEED-DOM`

## 後台 / WEB
### 分鐘卡欠款進出場設定

- API
    - POST v3/admin/brands/{brandId}/stores/{storeId}/counting-passcard/charging
- payload 新增
    - isArrearsAccess
- 描述
    - 分為新增欠款設定與費率設定，兩者不會同時新增
    - 範例
        - 欠款
            - `{
    "chargingType" : "time",
    "isArrearsAccess" : false}`
        - 費率
            - `{
    "chargingType" : "time",
    "chargingAmount" : 0.3,
    "chargingUnit" : "point",
    "bufferTime" : 10}`
    
### 分鐘卡現場儲值
- API
    - POST /v3/admin/brands/{brandId}/users/{userId}/counting-passcard/purchase
- payload 新增
    - isCustomProject : boolean : 是否為自訂點數
    - customPoint : int : 儲值的自訂點數
    - useValue : int : 自訂點數時長
    - useUnit : String : 自訂點數時長單位 ("H", "D", "W", "M", "Y")

### 取得分鐘卡設定

- API
    - POST v3/admin/brands/{brandId}/stores
- response 新增
    - countingChargingStoreSettingList
        - isArrearsAccess
- 描述
    - 是否有開啟欠款不可進出場的設定


### 會員分鐘卡列表
- API
    - 後台會員分鐘卡列表
        - GET /v3/admin/brands/{brandId}/users/{userId}/counting-passcard/deposits/list
    - 後台訂單明細
        - GET /v3/admin/brands/{brandId}/users/{userId}/counting-passcard/shopOrder/{countingPasscardId}
    - 後台點數使用紀錄
        - GET /v3/admin/brands/{brandId}/users/{userId}/counting-passcard/history
    - 後台出場前取得使用者的通行卡列表
        - GET /v3/admin/brands/{brandId}/stores/{storeId}/users/{userId}/exit/passcards
    - Web 會員通行卡使用紀錄
        - GET /v3/webUser/brands/{brandId}/users/{userId}/counting-passcard/history
    - Web 會員通行卡清單
        - GET /v3/webUser/brands/{brandId}/users/{userId}/counting-passcard/list
- 上面 API 的Response 新增
    - isCustomProject : boolean : 是否為自訂點數
 
## APP

### 會員分鐘卡列表
- API
    - app 出場前取得使用者的通行卡列表
        - GET /v3/app/brands/{brandId}/users/{userId}/exit/passcard
    - app 會員購買紀錄
        - GET /v3/app/brands/{brandId}/users/{userId}/passcards/{passcardId}/deposit/log
    - app 會員方案明細
        - GET /v3/app/brands/{brandId}/users/{userId}/passcards/{passcardId}/project/detail
    - app 會員通行卡使用紀錄
        - GET /v3/app/brands/{brandId}/users/{userId}/passcards/{passcardId}/use/logs
- 上面 API 的Response 新增
    - isCustomProject : boolean : 是否為自訂點數
- 