사용자 유효성 검사

사용자 유효성 검사Webhook POST

Xsolla sends a webhook with the user_validation type to the webhook URL to verify that a user is registered in the game. The request is sent multiple times as part of the payment process:

when a user chooses a payment method in the payment UI
when a user enters data in the payment form, e.g., bank card data or the ZIP code when paying via PayPal
when a user clicks Pay now to proceed with payment
when payment process is completed and the transaction status changes to done

The request is sent when paying with any payment methods.

You can give permissions to receive detailed information in webhooks. To do that, you can set the following toggles to On in Publisher Account in the Project settings > Webhooks > Advanced settings section:

Toggle	Description
Send only necessary user parameters without sensitive data	Only the following information about the user is passed in the webhook: ID country
Send custom parameters	Information about custom token parameters is passed in the webhook.

Toggle

Description

Send only necessary user parameters without sensitive data

Only the following information about the user is passed in the webhook:

ID
country

Send custom parameters

Information about custom token parameters is passed in the webhook.

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
PHP
HTTP

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": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}