查询黑名单
查询你的黑名单,也可以同时查平台的全局黑名单。黑名单里的客户下单会被拒绝(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" }
]
}