Xsolla-logo
  • 문서화
  • 계정 생성

사용자 유효성 검사Webhook POST

엑솔라는 사용자가 게임에 등록되어 있는지 확인하기 위해 user_validation 유형이 포함된 웹훅을 웹훅 URL로 전송합니다. 이 요청은 결제 프로세스의 일부이며 여러 번 전송됩니다.

  • 사용자가 결제 UI에서 결제 방법을 선택한 경우
  • 사용자가 결제 양식에 데이터를 입력한 경우(예: PayPal을 통해 결제할 경우 은행 카드 데이터 또는 우편번호)
  • 사용자가 지금 지불을 클릭하여 결제를 진행하는 경우
  • 결제 프로세스가 완료되고 거래 상태가 done로 변경되는 경우

어떤 결제 방법으로 지불을 진행하여도 요청이 전송됩니다.

웹훅에서 자세한 정보를 수신하는 권한을 부여할 수 있습니다. 이렇게 하려면 관리자 페이지프로젝트 설정 > 웹훅 > 고급 설정에서 다음 토글을 으로 설정합니다.

토글 설명
민감한 데이터 없이 필수 사용자 매개 변수만 전송

사용자에 대한 다음 정보만 웹훅에서 전달됩니다.

  • ID
  • 국가
사용자 정의 매개 변수 전송 사용자 정의 토큰 매개 변수 관련 정보가 웹훅에서 전달됩니다.
Request
Request Body schema: application/json
notification_type
required
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

유저 전화 번호입니다(국제 형식).

Responses
204

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

400

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

500

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

Request samples
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
    "notification_type":"user_validation",
    "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"
    }
}'
Response samples
application/json
{
  • "error": {
    }
}