Обновление черного списка системы Anti-fraud

Обновление черного списка системы Anti-fraudWebhook POST

При обновлении черного списка системы Anti-fraud (добавление или удаление параметра) Xsolla отправляет вебхук с типом afs_black_list на URL-адрес вебхука. Добавление параметра выполняется автоматически на стороне Xsolla или по запросу. Удаление параметра возможно только по запросу. Чтобы получать вебхук, добавить или удалить параметр, обратитесь к персональному менеджеру проекта или напишите на 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

Время последнего события черного списка AFS в формате ISO 8601.

parameter

string

Название параметра, по которому возникло событие.

Enum:	Description
card_issuer	банк-эмитент кредитной карты пользователя
email	email-адрес пользователя
ip_address	IP-адрес пользователя
nick	никнейм пользователя
phone	номер телефона пользователя
ps_account	платежный аккаунт пользователя

parameter_value

string

Значение параметра, по которому возникло событие.

project_id

integer

ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.

reason

string

Причина события.

Enum:	Description
by_afs_filters	Фильтр AFS (добавление)
chargeback	chargeback (добавление)
fraud_activity	мошенничество (добавление)
friendly_fraud	дружеский фрод (добавление)
linked_chargeback	связь с chargeback (добавление)
linked_parameter	связанный параметр в черном списке (добавление)
other_data_in_blacklist	другие параметры в черном списке (добавление)
other_forgiveness_reason	другая причина удаления (удаление)
partner_request	по запросу (добавление)
ps_reported_fraud	оповещение платежной системы о фроде (добавление)
removed_by_cs_review	удален после обращения в техническую поддержку Xsolla
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"
}
}