Member Coupon List
Function
用戶券列表
Endpoint
- /v1/coupon-member/list
HTTP Method
- POST
Request Body
- type = all
type is an optional parameter. If the type parameter is not passed, it defaults to all.
{
"vip_accountno": "04xxxxxx"
}
{
"vip_accountno": "04xxxxxx",
"type": "all"
}
- type = pending
{
"vip_accountno": "04xxxxxx",
"type": "pending"
}
- type = history
{
"vip_accountno": "04xxxxxx",
"type": "history"
}
Request Parameters
| Field | Required | Type | Remark | Sample |
|---|---|---|---|---|
| vip_accountno | Yes | string | vip_accountno | 04xxxxxx |
| type | No | string | 類型: all(默認值，即pending + history)、pending、history | all |
| page | No | string | 頁數 | 1 |
| limit | No | string | 每頁數據, 默認值: 20 | 20 |
Response Body - Success
{
"code": 0,
"msg": "success",
"data": {
"total": 1,
"list": [
{
"coupon_id": "DP003149",
"mall_id": "DP01",
"name_sc": "D·PARK 平日免费泊车电子优惠券(P1)",
"name_tc": "D·PARK 平日免費泊車電子優惠券(P1)",
"name_en": "D·PARK Weekday Free Parking Coupon(P1)",
"logo_url": "http://dpclub.dpark.com.hk/site/uat/photo/DP01DP003149_1.jpg",
"effective_date":"2021-01-07",
"expiry_date":"2021-02-28",
"point": 0,
"coupon_certno":"xxxx",
"verify_state":"NOT_VERIFIED"
}
]
}
}
Response Parameters
| Field | Type | Remark | Sample |
|---|---|---|---|
| total | int | 總數 | 1 |
| list | array | 券列表 | |
| list . coupon_id | string | 券ID | DP003149 |
| list . mall_id | string | Mall ID | DP01 |
| list . name_sc | string | 券名稱-中文簡體 | D·PARK 平日免费泊车电子优惠券(P1) |
| list . name_tc | string | 券名稱-中文繁體 | D·PARK 平日免費泊車電子優惠券(P1) |
| list . name_en | string | 券名稱-英文 | D·PARK Weekday Free Parking Coupon(P1) |
| list . logo_url | string | logo url | |
| list . effective_date | string | 生效日期 | 2021-01-07 |
| list . expiry_date | string | 失效日期 | 2021-02-28 |
| list . point | string | 積分 | 0 |
| list . coupon_certno | string | 券碼 | xxxx |
| list . verify_state | string | 核銷狀態: NOT_VERIFIED(未核销)、 VERIFIED(已核銷)、DISABLED(已失效)、EXPIRED(已过期)、 OTHER(其它) | NOT_VERIFIED |
Diff FZ API
FZ API : GetMemberGiftRedeemList
| FZ | New | Remark |
|---|---|---|
| TotalList | total | |
| SalesRecord . ROWNUM | / | |
| SalesRecord . VIPCODE | / | |
| SalesRecord . SURNAME | / | |
| SalesRecord . TXDATE | / | |
| SalesRecord . QOH | / | |
| SalesRecord . REDEMPTIONQTY | / | |
| SalesRecord . BONUS | / | |
| SalesRecord . BONUSUSE | list . point | |
| SalesRecord . ITEMNO | coupon_id | |
| SalesRecord . GIFTNAME_SC | list . name_sc | |
| SalesRecord . GIFTNAME_TC | list . name_tc | |
| SalesRecord . GIFTNAME_EN | list . name_en | |
| SalesRecord . SC_DESCRIPTION | / | |
| SalesRecord . TC_DESCRIPTION | / | |
| SalesRecord . EN_DESCRIPTION | / | |
| SalesRecord . GIFTCERTNO | list . coupon_certno | |
| SalesRecord . ISRECEIVE | / | |
| SalesRecord . ISUSE | / | |
| SalesRecord . REMARKS1 | / | |
| SalesRecord . REMARKS2 | / | |
| SalesRecord . ECOUPONS_QRCODE_REMARK_SC | / | |
| SalesRecord . ECOUPONS_QRCODE_REMARK_TC | / | |
| SalesRecord . ECOUPONS_QRCODE_REMARK_EN | / | |
| SalesRecord . STATUS | list . verify_state | 核銷狀態: NOT_VERIFIED(未核销)、 VERIFIED(已核銷)、DISABLED(已失效)、EXPIRED(已过期)、 OTHER(其它) |
| SalesRecord . INPUTSTORECODE | / | |
| SalesRecord . INPUTSTORENAME | / | |
| SalesRecord . EXPIRYDATE | list . expiry_date | |
| SalesRecord . EFFECTTIME | list . effective_date | |
| SalesRecord . CUTOFFTIME | / | |
| SalesRecord . GIFTCUTOFFDATE | / | |
| SalesRecord . VOIDDOCNO | / | |
| SalesRecord . REDEMPTIONDATE | / | |
| SalesRecord . USEDATE | / | |
| SalesRecord . PHOTOPATH | list . logo_url | |
| SalesRecord . GIFTTYPE | / | |
| SalesRecord . GIFTGROUP | / | |
| SalesRecord . REDEMPTION_ADDR | / | |
| SalesRecord . REQUIREDVERIFYCODE | / | |
| SalesRecord . SHOPNAME_EN | / | |
| SalesRecord . SHOPNAME_SC | / | |
| SalesRecord . SHOPNAME_TC | / | |
| SalesRecord . SHOPADDR_EN | / | |
| SalesRecord . SHOPADDR_SC | / | |
| SalesRecord . SHOPADDR_TC | / | |
| SalesRecord . SHOPTEL | / | |
| SalesRecord . SHOPADDR_TC | / | |
| SalesRecord . OPENING_HOURS_EN | / | |
| SalesRecord . OPENING_HOURS_SC | / | |
| SalesRecord . OPENING_HOURS_TC | / | |
| / | list . mall_id |