부정 결제 방지 시스템에서 거부한 트랜잭션

Xsolla Developers

또는

부정 결제 방지 시스템에서 거부한 트랜잭션Webhook POST

부정 결제 방지 시스템 검사 중에 트랜잭션이 거부되면 엑솔라는 afs_reject 유형이 포함된 웹훅의 트랜잭션 세부 정보를 웹훅 URL로 보냅니다. 이 웹훅을 수신하려면 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내십시오.

관리자 페이지에 웹훅 URL을 저장하면 웹훅에서 자세한 정보를 수신할 수 있는 권한을 부여할 수 있습니다. 이렇게 하려면 프로젝트 설정 >웹훅> 고급 설정 섹션의 관리자 페이지에서 다음 토글을 활성화로 설정하십시오.

참고

2025년 1월 22일 또는 그 이전에 관리자 페이지에 등록한 경우, 프로젝트 설정 >웹훅 > 테스트 > 결제 > 고급 설정 섹션에서 토글을 찾을 수 있습니다.

토글 설명

저장된 결제 방식을 사용한 트랜잭션에 대한 정보 표시

토글	설명
저장된 결제 방식을 사용한 트랜잭션에 대한 정보 표시	정보는 웹훅의 다음 사용자 정의 매개 변수에서 전달됩니다. `saved_payment_method`: `0` - 저장된 결제 방식이 사용되지 않음 `1` - 현재 결제를 진행할 때 결제 방식이 저장됨 `2` - 이전에 저장한 결제 방식이 사용됨 `payment_type`: `1` - 일회성 결제 `2` - 반복 결제

정보는 웹훅의 다음 사용자 정의 매개 변수에서 전달됩니다.

saved_payment_method:
- 0 - 저장된 결제 방식이 사용되지 않음
- 1 - 현재 결제를 진행할 때 결제 방식이 저장됨
- 2 - 이전에 저장한 결제 방식이 사용됨
payment_type:
- 1 - 일회성 결제
- 2 - 반복 결제

Request

Request Body schema: application/json

notification_type

required

string

알림 유형.

required

object

트랜잭션 데이터 관련 값입니다.

agreement	integer 계약 ID입니다.
dry_run	integer 테스트 트랜잭션(거래). 테스트 트랜잭션의 경우 매개변수는 1개 값을 갖습니다. 또는, 트랜잭션(거래)이 실제로 이루어지는 경우 매개변수가 전송되지 않습니다.
external_id	string 트랜잭션 외부 ID 입니다.
id	integer 트랜잭션 ID.

object

환불 세부 정보(오브젝트).

author	string 환불 개시 프로그램.
code	integer 코드 ID.
reason	string 환불 이유입니다.

object

사용자 정의 프로젝트 설정(개체)입니다.

merchant_id	integer 판매자 ID입니다.
project_id	integer 프로젝트 ID. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

object

사용자 세부 사항(개체)입니다.

id required	string 사용자 ID.
country	string 사용자의 국가. ISO 3166-1 alpha-2 standard에 따른 2자로 된 국가 코드를 사용합니다.
email	string 사용자 이메일.
ip	string 유저 IP 주소입니다.
name	string 사용자 이름.
phone	string 유저 전화 번호입니다(국제 형식).
zip	string 우편번호.

Responses

204

성공적인 처리 표시를 반환합니다.

400

제공된 정보에 오류가 있는 경우 반환합니다(예: 필수 매개변수 누락, 인증 실패 등).

500

서버에 일시적인 오류가 있음을 표시하려면 돌아가세요.

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-d '{
  "notification_type": "afs_reject",
  "settings": {
    "project_id": 18404,
    "merchant_id": 2340
  },
  "user": {
    "ip": "127.0.0.1",
    "phone": "18777976552",
    "email": "email@example.com",
    "id": "1234567",
    "name": "John Smith",
    "country": "US"
  },
  "transaction": {
    "id": 1,
    "external_id": 1,
    "dry_run": 1,
    "agreement": 1
  },
  "refund_details": {
    "code": 4,
    "reason": "Potential fraud"
  }
}'

Response samples

application/json

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