查詢黑名單
查詢你的黑名單,也可以同時查平台的全局黑名單。黑名單裡的客戶下單會被拒絕(40015)。
POST
/api/open/blocked/user/list完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。
請求參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
merchantNo | string | 是 | 商戶號 |
isGlobal | bool | 否 | true 時回傳平台全部黑名單(含其他商戶添加的);預設只回傳你自己的 |
回傳
data 是陣列:
| 欄位 | 類型 | 說明 |
|---|---|---|
blockType | int | 1 按姓名,2 按身份證號前幾位 |
blockedUserName | string | 被拉黑的姓名 |
blockedIdCardPrefix | string | 被拉黑的身份證號前綴 |
isOwn | bool | 是否是你自己添加的 |
remark | string | 備註 |
createdAt | string | 添加時間 |
json
{
"code": 0,
"message": "success",
"data": [
{ "blockType": 1, "blockedUserName": "張三", "blockedIdCardPrefix": "", "isOwn": true, "remark": "", "createdAt": "2026-10-01 10:00:00" }
]
}