게임유저 잔액: 쿠폰 사용

Xsolla Developers

또는

관리자 페이지로

게임유저 잔액: 쿠폰 사용Webhook POST

게임유저가 쿠폰을 사용하여 아이템이나 게임머니를 구매할 경우, 이에 관한 특별 알림 메시지를 보냅니다.

Request

Request Body schema: application/json

object

쿠폰 데이터 관련 값입니다.

campaign_code	string 쿠폰 캠페인 코드입니다.
coupon_code	string 쿠폰 코드.

id_operation

integer

엑솔라 시스템 내 작업 ID입니다.

items

Array of objects

구매 항목 내의 가상 아이템입니다.

items_operation_type

string

인게임 구매의 작업 유형입니다.

notification_type

string

알림 유형.

operation_type

string

작업 유형입니다.

object

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

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

object

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

id required	string 사용자 ID.
email	string 사용자 이메일.
name	string 사용자 이름.

object

시스템 내 게임유저 잔액 데이터와 관련된 값입니다.

diff	string 구매에 사용된 게임 머니 금액입니다.
new_value	string 현재 작업이 처리된 후 게임유저의 새잔액입니다.
old_value	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 '{
        "settings": {
            "project_id": 18404,
            "merchant_id": 2340
        },
        "virtual_currency_balance": {
            "old_value": "0",
            "new_value": "0",
            "diff": "0"
        },
        "user": {
            "name": "Xsolla User",
            "id": "1234567",
            "email": "email@example.com"
        },
        "operation_type": "coupon",
        "notification_type": "user_balance_operation",
        "items_operation_type": "add",
            "items": [{
                "sku": "com.xsolla.item_1468",
                "amount": "2"
            }],
        "id_operation": "66989",
        "coupon": {
            "coupon_code": "test123",
            "campaign_code": "Xsolla Campaign"
        }
    }'

Response samples

application/json

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