화면 모드
결제 검증
앱에서 받은 영수증을 서버가 스토어 서버에 직접 조회해서 확인해요. 영수증 위조, 다른 유저 영수증 재사용, 중복 지급을 막아요.
| 스토어 | 검증 방식 |
|---|---|
| Google Play | Google Play Developer API로 구매 조회 + 승인(acknowledge) |
| App Store | App Store Server API로 거래 조회 (운영 → 샌드박스 순) |
| 삼성 Instant Plays | 영수증 서명 검증 + 삼성 receipt API — 삼성 Instant Plays |
흐름
- 앱에서 스토어 결제창으로 결제해요. 스토어 쪽 완료 처리(consume·finish)는 아직 하지 않아요.
- 영수증을 서버로 보내 검증해요.
- 상태가
verified면 아이템을 지급해요. - 지급이 끝나면 지급 완료를 보고해요 →
consumed - 스토어에 완료 처리해요. 완료 처리하지 않은 결제는 다음 실행 때 스토어가 다시 넘겨줘요.
SDK를 쓰면 2~5단계를 자동으로 해요. 게임은 지급 함수만 만들면 돼요.
결제 상태
| 상태 | 뜻 | 게임이 할 일 |
|---|---|---|
verified | 검증됨, 지급 보고 전 | 지급 → 지급 완료 보고 |
consumed | 지급 완료 보고됨 | 없음 (스토어 완료 처리만) |
pending | Google 보류 결제 (결제 미완료) | 지급하지 말고 나중에 다시 |
refunded | 환불됨 | — 환불 처리 |
꼭 알아 둘 것
- 같은 영수증은 한 번만 지급돼요. 다시 보내면 같은 결제 기록과
already_processed: true가 와요. 지급 여부는 상태로 판단하세요. - 지급 도중 앱이 꺼져도 괜찮아요. 로그인 직후
verified로 남은 결제를 다시 지급하면 돼요(SDK는 자동). - 테스트 결제(Google 라이선스 테스터, Apple 샌드박스, 삼성 TEST 모드)도 검증되고
is_sandbox: true로 표시돼요. 매출 지표에서 빠져요. - 다른 유저가 등록한 영수증은
PURCHASE_OWNED_BY_OTHER, 위조·취소된 영수증은RECEIPT_INVALID예요. 지급하지 마세요. - 스토어 장애(
503 STORE_UNAVAILABLE)면 스토어 완료 처리를 하지 말고 나중에 다시 시도하세요. - 정기결제(구독)와 ONE store는 아직 지원하지 않아요.
관련 문서 · 결제 API · Unity IAP 연동 · HTML5 결제 · 환불 처리