환불Webhook POST
지불이 취소될 때마다 전송됩니다. 지불 세부 내역을 포함합니다. 지침에서 환불 절차에 대해 자세히 알아보세요.
환불 코드:
| 코드 | 환불 이유 | 설명 |
|---|---|---|
| 1 | Cancellation by the user request / the game request | 판매자 계정에서 취소가 요청된 경우 사용됩니다. |
| 2 | Chargeback | 거래 지불 거절 요청되었습니다. |
| 3 | Integration error | 엑솔라와 게임 사이의 연동에 문제가 있을 경우 사용됩니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요. |
| 4 | Potential fraud | 부정 결제가 의심됩니다. 권장사항: 사용자를 차단 목록에 추가하세요. |
| 5 | Test payment | 테스트 트랜잭션인 경우 사용되며 이후 취소로 이어집니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요. |
| 6 | User invoice expired | 후불 결제 방식에 의해 트랜잭션이 이뤄진 경우 사용됩니다. |
| 7 | Fraud notification from PS | 결제 시스템에서 결제가 거부되었습니다. PS에서 잠재적 사기를 감지했습니다. 권장사항: 사용자를 차단 목록에 추가하세요. |
| 8 | Cancellation by the PS request | 결제시스템이 취소를 요청한 경우 사용됩니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요. |
| 9 | Cancellation by the user request | 게임유저의 요청에 의한 환불 사유입니다. 어떤 이유로 게임유저가 게임 또는 구매에 만족하지 못한 못하였음을 의미합니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요. |
| 10 | Cancellation by the game request | 게임이 취소를 요청한 경우 사용됩니다. 권장사항: 사용자를 차단 목록에 추가하지 마세요. |
| 11 | Account holder called to report fraud | 계정 소유자가 본인 미사용 결제로 신고한 경우입니다. |
| 12 | Friendly fraud | 우호적인 부정결제에 대한 메시지를 수신했을 때 사용됩니다. |
| 13 | Duplicate | 동일 인보이스에 대하여 거래 복제. |
Request Body schema: application/json
| notification_type required | string 알림 유형입니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object 트랜잭션 데이터 관련 값입니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object 결제 내역 관련 값입니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| custom_parameters | object 사용자 지정 파라미터입니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 구매 데이터 관련 값입니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 환불 세부 정보(오브젝트). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 사용자 정의 프로젝트 설정(개체)입니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 사용자 세부 사항(개체)입니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
성공적인 처리 표시를 반환합니다.
제공된 정보에 오류가 있는 경우 반환합니다(예: 필수 매개변수 누락, 인증 실패 등).
서버에 일시적인 오류가 있음을 표시하려면 돌아가세요.
- Payload
- CURL
- PHP
- HTTP
{- "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"
}
}
}, - "subscription": {
- "amount": 0,
- "currency": "string",
- "date_create": "string",
- "plan_id": "string",
- "subscription_id": 0,
- "tags": [
- "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,
- "reason": "string"
}, - "settings": {
- "merchant_id": 0,
- "project_id": 0
}, - "transaction": {
- "agreement": 0,
- "dry_run": 0,
- "external_id": "string",
- "id": 0,
- "payment_method_order_id": "string"
}, - "user": {
- "country": "string",
- "email": "string",
- "id": "string",
- "ip": "string",
- "name": "string",
- "phone": "string",
- "zip": "string"
}
}- 400
{- "error": {
- "code": "INCORRECT_AMOUNT",
- "message": "Incorrect amount"
}
}