不正決済防止ブロックリストの更新

不正決済防止ブロックリストの更新Webhook POST

不不正決済防止システムのブロックリストが更新（パラメータを追加または削除）される場合、エクソーラはafs_black_listタイプのウェブフックをウェブフックURLに送信します。引数の追加はエクソーラ側で、または要求に応じて自動的に行われます。パラメータは要求時にのみ削除できます。このウェブフックを受信するには、カスタマーサクセスマネージャーにご連絡いただくか、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

ゲームのエクソラ ID。パブリッシャ―アカウントにあります。

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	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"
}
}