본문으로 건너뛰기

PSN(PlayStation Network) 소모성 상품 구매

개요​

  • PSN(PlayStation Network) 콘솔(PlayStation®5) 인게임 소모성 상품 구매에 대한 빌링 서버측의 상세 가이드 문서입니다.
  • 소모성 상품만 지원합니다.
  • 구매 흐름은 다른 스토어와 동일하게 구매 예약(reserve) → 구매 검증(verify) → 완료 처리(complete) 3단계로 진행됩니다.
경고

PSN 규정 주의(다른 스토어와 순서가 다릅니다)

  • 구글/애플은 아이템 지급 후 소모(consume) 처리가 가능하지만, PSN은 complete(빌링 완료 + entitlement consume)가 성공한 후에 아이템을 지급해야 합니다.
  • consume 성공 전 아이템 지급 금지.
정보
  • PSN 스토어는 상품명·가격 등 전시 정보를 내려주지 않으므로, 상품 전시 정보는 빌링 시스템에 등록된 상품 정보를 SDK API(상품 상세 조회)로 조회하여 사용합니다.

시퀀스 다이어그램​

시퀀스 관련 추가 설명​

  • 0-1의 유저 토큰은 빌링 시스템이 보관하며, 만료 시 게임서버가 auth/token으로 재발급해야 합니다.(클라이언트가 새 인가코드를 게임서버에 전달) 토큰이 없으면 3의 verify가 실패합니다.
  • 3의 verify는 PSN Entitlement API를 실조회하여 검증합니다. 유저가 실제 PSN 스토어에서 구매를 완료한 뒤 호출해야 합니다.
  • 4의 complete는 빌링 완료 처리와 PSN entitlement consume(소모 처리)을 함께 수행합니다.
  • 2의 reserve 이후 클라이언트 이탈 등으로 verify에 진입하지 못해 RESERVED 상태로 남은 구매건은, 클라이언트 SDK가 최근 예약 미소모 건 조회 API(getLatestReservedNotConsumed, payment-gateway)로 boid를 조회하여 verify부터 재개(복구)할 수 있습니다.