Skip to content

결제 검증 ​

앱에서 받은 영수증을 서버가 스토어 서버에 직접 조회해서 확인해요. 영수증 위조, 다른 유저 영수증 재사용, 중복 지급을 막아요.

스토어검증 방식
Google PlayGoogle Play Developer API로 구매 조회 + 승인(acknowledge)
App StoreApp Store Server API로 거래 조회 (운영 → 샌드박스 순)
삼성 Instant Plays영수증 서명 검증 + 삼성 receipt API — 삼성 Instant Plays

흐름 ​

  1. 앱에서 스토어 결제창으로 결제해요. 스토어 쪽 완료 처리(consume·finish)는 아직 하지 않아요.
  2. 영수증을 서버로 보내 검증해요.
  3. 상태가 verified면 아이템을 지급해요.
  4. 지급이 끝나면 지급 완료를 보고해요 → consumed
  5. 스토어에 완료 처리해요. 완료 처리하지 않은 결제는 다음 실행 때 스토어가 다시 넘겨줘요.

SDK를 쓰면 2~5단계를 자동으로 해요. 게임은 지급 함수만 만들면 돼요.

결제 상태 ​

상태뜻게임이 할 일
verified검증됨, 지급 보고 전지급 → 지급 완료 보고
consumed지급 완료 보고됨없음 (스토어 완료 처리만)
pendingGoogle 보류 결제 (결제 미완료)지급하지 말고 나중에 다시
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 결제 · 환불 처리

© WEBZEN K. All rights reserved.