부분 환불이 이루어지면 엑솔라는 partial_refund
유형이 포함된 웹훅의 취소된 거래에 대한 세부 정보를 웹훅 URL로 전송합니다.
부분 환불 절차에 대한 자세한 내용은 지침을 참조해 주세요.
웹훅에서 자세한 정보를 수신하는 권한을 부여할 수 있습니다. 이렇게 하려면 관리자 페이지의 프로젝트 설정 > 웹훅 > 고급 설정에서 다음 토글을 온으로 설정합니다.
토글 | 설명 |
---|---|
저장된 결제 방식을 사용한 거래에 대한 정보 표시 | 정보는 웹훅의 다음 사용자 정의 매개 변수에서 전달됩니다.
|
환불 코드:
코드 | 환불 이유 | 설명 |
---|---|---|
1 | 사용자 요청/게임 요청에 의한 취소 | 관리자 페이지에서 취소가 요청된 경우 사용됩니다. |
3 | 연동 오류 | 엑솔라와 게임 사이의 연동에 문제가 있을 경우 사용됩니다. 권장 사항: 사용자를 차단 목록에 추가하지 마세요. |
5 | 테스트 결제 | 테스트 트랜잭션인 경우 사용되며 이후 취소로 이어집니다. 권장 사항: 사용자를 차단 목록에 추가하지 마세요. |
7 | PS에서 전송된 사기 알림 | 결제 시스템에서 결제가 거부되었습니다. PS에서 잠재적 사기를 감지했습니다. 권장 사항: 사용자를 차단 목록에 추가하세요. |
9 | 사용자 요청에 의한 취소 | 사용자의 요청에 의한 환불 사유입니다. 어떤 이유로 사용자가 게임 또는 구매에 만족하지 못한 못하였음을 의미합니다. 권장 사항: 사용자를 차단 목록에 추가하지 마세요. |
10 | 게임 요청에 의한 취소 | 게임을 통해 취소를 요청한 경우 사용됩니다. 권장 사항: 사용자를 차단 목록에 추가하지 마세요. |
notification_type required | string 알림 유형. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object 트랜잭션 데이터 관련 값입니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object 결제 내역 관련 값입니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
custom_parameters | object 사용자 정의 매개 변수입니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 구매 데이터 관련 값입니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 환불 세부 정보(오브젝트). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 사용자 정의 프로젝트 설정(개체)입니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 사용자 세부 사항(개체)입니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
성공적인 처리 표시를 반환합니다.
제공된 정보에 오류가 있는 경우 반환합니다(예: 필수 매개변수 누락, 인증 실패 등).
서버에 일시적인 오류가 있음을 표시하려면 돌아가세요.
curl -v 'https://your.hostname/your/uri' \ -X POST \ -d '{ "notification_type": "partial_refund", "settings": { "project_id": 18404, "merchant_id": 2340 }, "purchase": { "checkout": { "currency": "USD", "amount": 50 }, "total":{ "currency": "USD", "amount": 200 } }, "user": { "ip": "127.0.0.1", "phone": "18777976552", "email": "email@example.com", "id": "1234567", "name": "John Smith", "country": "US" }, "transaction": { "id": 1, "external_id": 1, "dry_run": 1, "agreement": 1, "date": "2022-03-01 10:53:15" }, "refund_details": { "author": "email@example.com", "date": "2022-03-01 10:56:48" }, "payment_details": { "sales_tax": { "currency": "USD", "amount": 0 }, "direct_wht": { "currency": "USD", "amount": 0.70 }, "xsolla_fee": { "currency": "USD", "amount": "10" }, "payout": { "currency": "USD", "amount": "200" }, "payment_method_fee": { "currency": "USD", "amount": "20" }, "payment": { "currency": "USD", "amount": "230" }, "repatriation_commission": { "currency": "USD", "amount": 10 } } } }'
{- "error": {
- "code": "INCORRECT_AMOUNT",
- "message": "Incorrect amount"
}
}