환불 관리
뒤끝 콘솔의 환불 관리 메뉴에서는 구글 플레이, 앱스토어, 원스토어에서 발생한 환불 완료 건을 통합 조회하고 처리 상태를 관리할 수 있습니다.
환불 완료 웹훅이 수신된 시점부터 데이터가 기록되며, 회수 알림 발송과 유저 차단 기능을 통해 환불 운영 비용을 절감할 수 있습니다.
환불 관리 기능을 이용하려면 뒤끝 베이스 SDK 연동 및 스토어별 웹훅 등록이 필요합니다.
요금 및 기능 스펙은 환불 관리 요금제를 참고해 주세요.
목록
목록 구성 항목은 아래와 같습니다.
| 항목 | 설명 |
|---|---|
| 환불 일시 | 환불 완료 웹훅 수신일 |
| 스토어 | 환불이 발생한 스토어 (Google Play / App Store / ONE Store) |
| 닉네임 | 해당 유저의 닉네임. 미인증 유저 또는 영수증 검증 이력 없을 경우 미출력 |
| 유저 UUID | 해당 유저의 UUID. 차단된 유저는 UUID 좌측에 차단 아이콘 표기 |
| 주문 ID | 스토어에서 부여한 주문 ID |
| 제품 ID | 영수증 검증 이력 없을 경우 미출력 |
| 금액 | 영수증 검증 이력 없을 경우 미출력 |
| Description | 영수증 검증 시 입력한 설명 값. 영수증 검증 이력 없을 경우 미출력 |
| 처리 상태 | 해당 주문 건의 현재 처리 상태 |
처리 상태
각 처리 상태의 의미는 아래와 같습니다.
| 상태 | 설명 | 변경 방법 |
|---|---|---|
| 환불완료 | 스토어로부터 환불 완료 웹훅이 수신된 상태입니다. 환불 완료 상태부터 관리할 수 있으며, 환불 요청 및 승인은 각 스토어에서 진행됩니다. | 웹훅 수신 시 자동 반영 |
| 차단제외 | 자동 차단 대상에서 제외한 주문입니다. 환불 웹훅 수신 시 '환불완료'로 변경됩니다. 차단제외 이력이 있는 주문은 '차단제외' 탭에서 확인할 수 있습니다. | 콘솔에서 설정 가능 |
| 알림발송 | 유저 클라이언트로 회수 알림을 전송한 상태입니다. 실제 수신 여부를 의미하지 않습니다. | 알림 발송 시 자동 반영 |
| 회수완료 | 재화 회수가 완료된 상태입니다. | 콘솔 또는 SDK에서 변경 가능 |
| 회수제외 | 재화를 이미 소진했거나, 내부 정책에 따라 회수를 진행하지 않기로 한 상태입니다. | 콘솔 또는 SDK에서 변경 가능 |
| 기타 | 별도 관리가 필요한 케이스에 사용하는 상태입니다. | 콘솔 또는 SDK에서 변경 가능 |
※ SDK 환불 조회 및 상태 변경 방법은 환불 상태 조회를 참고해 주세요.
상세 보기
목록에서 항목을 클릭하면 팝업을 통해 상세 정보를 확인할 수 있습니다.
- 유저 UUID, 주문 ID
- 해당 주문의 전체 상태 변경 이력
- 메모 조회 및 작성
환불 목록 선택
목록에서 하나 이상의 항목을 선택하면 아래 액션을 일괄 실행할 수 있습니다.
- 상태 변경하기
- 환불 건의 처리 상태를 변경합니다.
- 변경 가능 상태: 환불완료, 회수완료, 회수제외, 기타
- 이전 상태에 관계없이 자유롭게 변경할 수 있습니다.
- 알림 발송하기
- 선택한 유저의 클라이언트로 재화 회수 알림을 실시간으로 발송합니다.
- 알림 발송 후 처리 상태는 자동으로 '알림발송'으로 변경됩니다.
- 실시간 알림 수신 SDK 문서 확인하기
- 유저 차단하기
- 선택한 유저를 차단합니다.
- 차단 유저는 유저 UUID 좌측에 차단 아이콘이 표기됩니다.
- 유저 UUID 기준으로 차단되며, 차단 해제 필요 시 유저 접근 관리메뉴에서 처리할 수 있습니다.
알림 발송하기, 유저 차단하기는 PRO 요금제 및 베이스 인증 유저에게만 지원됩니다.
차단 제외 등록
환불 발생 시 자동 차단이 적용되지 않도록 특정 주문을 미리 제외 등록할 수 있습니다.
- 주문 ID를 입력하여 등록합니다. 등록된 주문은 차단제외 상태로 목록에 표시됩니다.
- 입력한 주문 ID가 영수증 검증 목록에 추가되어 있지 않으면 등록이 불가합니다.
- 이후 해당 주문의 환불 웹훅이 수신되면 상태는 환불완료로 변경됩니다.
- 차단제외 탭에서 차단제외했던 환불 건을 조회할 수 있습니다.
차단 제외 등록은 PRO 요금제 및 베이스 인증 유저에게만 지원됩니다.
검색
상태, 기간, 닉네임, 스토어, 유저 UUID, 주문 ID로 환불 내역을 검색할 수 있습니다.
상태 탭
- 목록 상단의 탭을 선택하여 처리 상태별로 조회할 수 있습니다.
- 각 상태의 의미는 목록 > 처리 상태를 참고해 주세요.
기간 및 조건 검색
- 환불 완료일(웹훅 수신일) 기준으로 기간을 조회할 수 있습니다.
- 기간은 최대 3개월까지 조회 가능합니다.
- 닉네임, 스토어, 유저 UUID, 주문 ID를 입력하여 조회할 수 있습니다.
- 검색 시 초기화 및 CSV 다운로드 버튼이 활성화됩니다.
지원 범위 안내
환불 관리는 요금제 및 유저 인증 여부에 따라 지원 기능이 상이합니다.
여기서 인증 유저는 베이스 SDK에서 로그인(유저 인증)이 완료된 유저를 의미합니다.
| 구분 | 기능 | BASIC | PRO | 인증 | 미인증 |
|---|---|---|---|---|---|
| 콘솔 | 영수증 검증 > 조회 | O | O | O | O |
| 콘솔 | 환불 > 조회, 상태 변경 | O | O | O | O |
| 콘솔 | 환불 > 실시간 알림 발송 | X | O | O | X |
| 콘솔 | 환불 > 설정 > 알림 자동 발송 | X | O | O | X |
| 콘솔 | 환불 > 유저 차단하기 | X | O | O | X |
| 콘솔 | 환불 > 자동 차단하기 | X | O | O | X |
| 콘솔 | 환불 > 차단 제외하기 | X | O | O | X |
| 콘솔 | 환불 > CSV 다운로드 | X | O | O | O |
| SDK | 영수증 검증 | O | O | O | O |
| SDK | 환불 상태 조회 | O | O | O | O |
| SDK | 환불 상태 업데이트 | O | O | O | O |
미인증 유저 지원
- 베이스 SDK의 유저 인증(로그인)을 사용하지 않는 경우에도 환불 내역 조회 및 상태 변경이 가능합니다.
- 단, 유저 데이터가 없으므로 영수증 검증 시 '유저 UUID' 값을 필수로 전송해야 합니다.
- 미인증 유저의 경우 닉네임 정보가 저장되지 않으며, 회수 알림 발송·유저 차단·차단 제외 등록은 사용할 수 없습니다.
케이스별 저장 데이터
영수증 검증 유무, 유저 인증 여부에 따라 저장 가능한 데이터에 차이가 있으니 참고해주세요.
| 유저 인증 여부 | 영수증 검증 유무 | 일시 | 스토어 | 닉네임 | 유저 UUID | 제품명 | 제품 ID | 금액 | Description | 구분 | 처리 상태 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 인증 | 있음 | O | O | O | O | O | O | O | O | O | O |
| 인증 | 없음 | O | O | X | X | X | X | X | X | X | O |
| 미인증 | 있음 | O | O | X | O | O | O | O | O | O | O |
| 미인증 | 없음 | O | O | X | X | X | X | X | X | X | O |
※ 구분: 주문 유형 (일반 / 구독)
※ 미인증 유저의 유저 UUID는 영수증 검증 시 전송한 값으로 저장됩니다.