添加或删除风控名单

• Endpoint: POST /aggregate-pay/api/gateway/addOrDelRiskNameList
• Tags: 风控

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
version	string	Yes		当前值为：1.0
keyVersion	string	Yes		当前值为：1
requestTime	string	Yes		符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
merchantAppId	string	Yes		PayerMax分配给商户应用的唯一标识
merchantNo	string	No		商户与PayerMax业务签约时生成的唯一标识
data	object	Yes
data.nameType	string	Yes		固定 BLACK
data.remark	string	Yes		长度 <=128
data.operateType	string	Yes		ADD：添加 DELETE：删除 （重复添加会覆盖原名单）
data.requestId	string	Yes		长度 <=128 唯一标识商户的一笔请求，不能重复
data.nameList	array[object]	Yes		长度<=2000
data.nameList[].key	string	No		NEG0001：卡号前6后4掩码 NEG0002：用户号黑名单 NEG0003：IP黑名单 NEG0004：卡BIN黑名单 NEG0005：卡BIN国家黑名单
data.nameList[].value	string	No		长度<=128 名单类型为NEG0001时 示例：123456-4321 名单类型为NEG0005时，国家代码，大写字母，参见【交易支持国家/地区与币种】
data.nameList[].expireType	string	No		DAY：1天 WEEK： 7天 MONTH ：30天 HALFYEAR：180天 YEAR： 365天 FOREVER： 永久

Example

{
  "version": "1.0",
  "keyVersion": "1",
  "requestTime": "2022-01-17T09:05:52.194+00:00",
  "merchantAppId": "{{merchantAppId}}",
  "merchantNo": "{{merchantNo}}",
  "data": {
    "nameType": "BLACK",
    "remark": "remark",
    "operateType": "ADD",
    "requestId": "test001",
    "nameList": [
      {
        "value": "user001",
        "key": "NEG0002",
        "expireType": "DAY"
      }
    ]
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
code	string	Yes		返回码，’APPLY_SUCCESS’代表成功
msg	string	Yes		返回描述，’Success.’
data	object	Yes
data.requestId	string	Yes		请求体中的requestId

Response Example

{
  "code": "APPLY_SUCCESS",
  "msg": " Success.",
  "data": {
    "requestId": "test001"
  }
}