Skip to content

결제 ​

경로인증설명
POST/v1/iap/verify유저영수증 검증 → 결제 기록
POST/v1/iap/consume유저지급 완료 보고
GET/v1/iap/unconsumed유저검증됐지만 지급 보고가 없는 결제 — 로그인 직후 호출
GET/v1/iap/history유저결제 내역 ?limit=50&before_id=

흐름과 상태는 결제 검증 가이드를 먼저 보세요.

영수증 검증 ​

POST /v1/iap/verify
json
{ "store": "googleplay", "product_id": "gem_100", "purchase_token": "…",
  "price_micros": 1200000000, "currency": "KRW" }
json
{ "store": "appstore", "product_id": "gem_100", "transaction_id": "2000000812345678" }
json
{ "store": "samsung", "product_id": "gem_100", "signed_receipt": "PurchaseItem.signedPurchaseReceipt" }

Google Play는 스토어 응답에 가격이 없어서 앱의 표시 가격(price_micros = 가격 × 1,000,000, currency)을 매출 지표용으로 함께 보내요.

json
{
  "purchase_id": "5012", "store": "googleplay", "product_id": "gem_100", "quantity": 1,
  "status": "verified", "is_sandbox": false, "order_id": "GPA.3312-…",
  "platform_purchase_id": null,
  "purchased_at": 1795055000, "verified_at": 1795055003, "consumed_at": null, "refunded_at": null,
  "already_processed": false
}
status할 일
verified지급 → /v1/iap/consume
consumed이미 지급 완료 — 스토어 완료 처리만
pendingGoogle 보류 결제 — 지급하지 말고 나중에 다시 verify
  • 같은 영수증을 다시 보내면 같은 purchase_id와 already_processed: true가 와요.
  • platform_purchase_id: 플랫폼 결제(삼성)에서 지급 후 플랫폼 소진에 쓰는 ID.

지급 완료 보고 ​

POST /v1/iap/consume — { "purchase_ids": ["5012"] } (최대 50건, 다시 보내도 안전)
json
{ "items": [ { "purchase_id": "5012", "status": "consumed" } ] }

미지급 결제 ​

GET /v1/iap/unconsumed → { "items": [ 결제 기록 … ] } — verified인 건을 지급하고 consume 하세요.

오류 ​

오류뜻대응
409 PURCHASE_OWNED_BY_OTHER다른 유저가 등록한 영수증지급하지 않음
422 RECEIPT_INVALID위조·취소·상품 불일치지급하지 않음
422 RECEIPT_REVOKED환불·취소된 결제지급하지 않음
503 STORE_UNAVAILABLE스토어 장애스토어 완료 처리 없이 나중에 재시도
400 PROVIDER_NOT_CONFIGURED이 게임에 스토어 연동 없음운영 담당자 문의
403 WEB_NOT_SUPPORTED웹에서 Google Play·App Store 검증앱에서만

© WEBZEN K. All rights reserved.