부분 환불

부분 환불Webhook POST

지불이 취소될 때마다 전송됩니다. 지불 세부 내역을 포함합니다. 지침에서 환불 절차에 대해 자세히 알아보세요.

환불 코드:

코드	환불 이유	설명
1	Cancellation by the user request / the game request	판매자 계정에서 취소가 요청된 경우 사용됩니다.
3	Integration error	엑솔라와 게임 사이의 연동에 문제가 있을 경우 사용됩니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요.
5	Test payment	테스트 트랜잭션인 경우 사용되며 이후 취소로 이어집니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요.
7	Fraud notification from PS	결제 시스템에서 결제가 거부되었습니다. PS에서 잠재적 사기를 감지했습니다. 권장사항: 사용자를 차단 목록에 추가하세요.
9	Cancellation by the user request	게임유저의 요청에 의한 환불 사유입니다. 어떤 이유로 게임유저가 게임 또는 구매에 만족하지 못한 못하였음을 의미합니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요.
10	Cancellation by the game request	게임이 취소를 요청한 경우 사용됩니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요.

Request

Request Body schema: application/json

notification_type

required

string

알림 유형입니다.

required

object

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

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

required

object

결제 내역 관련 값입니다.

object

직접 원천징수세.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.
percent	integer <float> 직접 원천징수세율

object

게임유저 결제 데이터 관련 값입니다.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

결제 방식 수수료율입니다.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

결제 방법에서 청구된 금액에 대한 데이터가 포함된 값입니다.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

지급 내역 관련 값입니다.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

payout_currency_rate

integer <float>

결제 통화를 지급 통화로 환전할 때의 환율입니다.

object

본국 송금 비용에 대한 데이터가 있는 오브젝트. 타사가 엑솔라에 부과.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

판매세(대상; 미국과 캐나다만).

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.
percent	integer <float> 판매세율.

object

VAT 세율입니다(유럽연합만 해당).

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.
percent	integer <float> 부가가치세율.

object

엑솔라 잔액에서 청구된 금액에 대한 데이터가 포함된 값입니다.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

엑솔라 수수료 요율입니다.

amount	integer <float> 총계.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

custom_parameters

object

사용자 지정 파라미터입니다.

object

구매 데이터 관련 값입니다.

required

object

구매 총 가격 데이터와 관련된 값입니다.

amount	integer <float> 부분 환불 결제 금액입니다.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

결제 파라미터 데이터와 관련된 값입니다.

amount	integer <float> 구매 금액입니다.
currency	string 통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

Deprecated

게임 키에 대한 데이터가 포함된 배열입니다.

object

업그레이드 데이터가 있는 객체입니다.

amount

integer <float>

Deprecated

구매 금액입니다.

currency

string

Deprecated

통화. ISO 4217에 따른 3자리 통화 코드입니다.

object

Deprecated

사용자가 업그레이드 한 패키지의 데이터가 있는 객체입니다.

DRM	string Deprecated 게임 DRM플랫폼.
digital_content	string Deprecated 판매자 계정으로 설정된 게임의 SKU입니다.

object

Deprecated

사용자가 업그레이드를 적용한 패키지의 데이터가 있는 객체입니다.

DRM	string Deprecated 게임 DRM플랫폼.
digital_content	string Deprecated 판매자 계정으로 설정된 게임의 SKU입니다.

object

Deprecated

구매 게임머니 데이터와 관련된 값입니다.

amount	integer <float> Deprecated 구매 금액입니다.
currency	string Deprecated 통화. ISO 4217에 따른 3자리 통화 코드입니다.
name	string Deprecated 게임머니 이름.
quantity	integer <float> Deprecated 가상 항목의 수량입니다.

object

Deprecated

게임 아이템 구매 데이터와 관련된 값입니다.

amount

integer <float>

Deprecated

구매 금액입니다.

currency

string

Deprecated

통화. ISO 4217에 따른 3자리 통화 코드입니다.

Array of objects

Deprecated

Array

amount	integer <float> Deprecated 아이템 수량입니다.
sku	string Deprecated 아이템 ID입니다.

object

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

author

string

환불 시작자. 필드 값이 다음 표에 따라 전달됩니다.

환불 시작자	필드 값
게임(API를 통해).	API
게시자 계정 사용자(자동 환불).	사용자 이메일
게시자 계정 사용자(엑솔라 고객 지원의 도움을 받아).	support@xsolla.com
엑솔라(엑솔라 고객 지원의 도움을 받아).	support@xsolla.com

code

integer

코드 ID.

date

string

환불 날짜입니다.

reason

string

환불 이유입니다.

object

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

merchant_id	integer 판매자 ID입니다.
project_id	integer 엑솔라 시스템 내의 게임 식별자입니다. 판매자 계정 에서 확인할 수 있습니다.

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

Payload
CURL
PHP
HTTP

application/json

{"custom_parameters": { },
"notification_type": "string",
"payment_details": {"direct_wht": {"amount": 0,
"currency": "string",
"percent": 0
},
"payment": {"amount": 0,
"currency": "string"
},
"payment_method_fee": {"amount": 0,
"currency": "string"
},
"payment_method_sum": {"amount": 0,
"currency": "string"
},
"payout": {"amount": 0,
"currency": "string"
},
"payout_currency_rate": 0,
"repatriation_commission": {"amount": 0,
"currency": "string"
},
"sales_tax": {"amount": 0,
"currency": "string",
"percent": 0
},
"vat": {"amount": 0,
"currency": "string",
"percent": 0
},
"xsolla_balance_sum": {"amount": 0,
"currency": "string"
},
"xsolla_fee": {"amount": 0,
"currency": "string"
}
},
"purchase": {"checkout": {"amount": 0,
"currency": "string"
},
"pin_codes": {"upgrade": {"amount": 0,
"currency": "string",
"digital_content_from": {"DRM": "string",
"digital_content": "string"
},
"digital_content_to": {"DRM": "string",
"digital_content": "string"
}
}
},
"total": {"amount": 0,
"currency": "string"
},
"virtual_currency": {"amount": 0,
"currency": "string",
"name": "string",
"quantity": 0
},
"virtual_items": {"amount": 0,
"currency": "string",
"items": [{"amount": 0,
"sku": "string"
}
]
}
},
"refund_details": {"author": "string",
"code": 0,
"date": "string",
"reason": "string"
},
"settings": {"merchant_id": 0,
"project_id": 0
},
"transaction": {"agreement": 0,
"date": "string",
"dry_run": 0,
"external_id": "string",
"id": 0
},
"user": {"country": "string",
"email": "string",
"id": "string",
"ip": "string",
"name": "string",
"phone": "string",
"zip": "string"
}
}

Response samples

application/json

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