反欺诈黑名单更新

Xsolla Developers

或

反欺诈黑名单更新Webhook POST

当反欺诈系统的黑名单发生更新（添加或删除了参数）时，艾克索拉会向Webhook URL发送一个afs_black_list类型的Webhook。参数添加在艾克索拉侧自动执行或根据您的请求执行。删除参数只能根据您的请求才可以进行。要接收此Webhook，请联系您的客户成功经理或发送电子邮件至csm@xsolla.com。

Request

Request Body schema: application/json

notification_type

required

string

通知类型。

required

object

包含AFS拦截列表事件信息的对象。

action

string

事件类型。

Enum: "adding" "removing"

date_of_last_action

string

ISO 8601格式的最近AFS拦截列表事件时间。

parameter

string

发生事件的参数的名称。

Enum:	Description
card_issuer	用户的信用卡发卡银行
email	用户的邮箱地址
ip_address	用户的IP地址
nick	用户的昵称
phone	用户的手机号码
ps_account	用户的账单帐户

parameter_value

string

发生事件的参数的值。

project_id

integer

项目编号。您可以在您的发布商帐户项目名称旁边。

reason

string

事件的原因。

Enum:	Description
by_afs_filters	AFS筛选器（添加）
chargeback	拒付（添加）
fraud_activity	欺诈（添加）
friendly_fraud	友好欺诈（添加）
linked_chargeback	关联拒付（添加）
linked_parameter	AFS拦截列表中的关联参数（添加）
other_data_in_blacklist	AFS拦截列表中的其他参数（添加）
other_forgiveness_reason	移除的其他原因（移除）
partner_request	根据请求（添加）
ps_reported_fraud	关于欺诈的支付系统通知（添加）
removed_by_cs_review	向艾克索拉技术支持报告后移除（移除）
suspicious_activity	可疑活动（添加）
user_reported_fraud	用户报告欺诈（添加）
wrongly_added	误添加（移除）

transaction_id

string

发生事件的参数关联的交易ID。

Responses

204

返回以指示处理成功。

400

提供的信息出错时返回（例如，缺少必需的参数、授权失败等）。

500

返回以指示您的服务器存在的暂时性错误。

Request samples

CURL
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Authorization: Signature 32c64a80d2527dc08906ae1891bac4489509b9f6' \
-d '{
  "event": {
    "action": "adding",
    "date_of_last_action": "2020-11-27T10:09:05+03:00",
    "parameter": "email",
    "parameter_value": "email@example.com",
    "reason": "ps_reported_fraud",
    "transaction_id": "111111111",
    "project_id": "123456"
  },
  "notification_type": "afs_black_list"
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}