부정 결제 방지 차단 목록 업데이트

부정 결제 방지 차단 목록 업데이트Webhook POST

부정 결제 방지 시스템 차단 목록이 업데이트되면(매개 변수 추가 또는 제거) 엑솔라는 웹훅 URL로 afs_black_list 유형의 웹훅을 전송합니다. 매개 변수 추가는 엑솔라 측에서 자동으로 또는 요청 시 수행됩니다. 매개 변수 제거는 요청 시에만 가능합니다. 이 웹훅을 수신하려면 고객 성공 매니저에게 문의하거나 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	엑솔라 기술 지원에 보고 후 제거됨(제거)
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"
}
}