---
title: "시퀀스 다이어그램"
site: "Game8 Store – Developer Center"
lang: "ko"
category: "기술 사양 & API"
canonical: "https://developers.store.game8.jp/ko/sequence/"
---

# 시퀀스 다이어그램

📝 본 페이지는 참고용 번역(한국어)입니다. 일본어 원본과 차이가 있는 경우 일본어판을 우선합니다.

이 페이지에서는 **앱 외부 결제**의 시퀀스를 그림으로 정리했습니다.

## 게임 내 아이템 구매

**다이어그램 소스 (mermaid)**

```mermaid
sequenceDiagram
	autonumber
	actor user as 사용자
	participant S8 as Game8 Store
	participant pub as 게임(퍼블리셔API）

	## 구매 상품 선택

	# 결제 정보 등록
	user->>+S8: 신용카드 정보 전송
	note right of user: 신용카드 정보
	S8->>-user: e-Scott Transaction ID발급
	note left of S8: Transaction ID

	# 상품 구매
	user->>S8: 게임 내 과금 아이템 구매 (신용카드 정보 전송과 동시)
	note right of user: Transaction ID, 게임 내 사용자 ID, 아이템 ID, 사용 포인트 수
	S8->>+pub: 게임 내 과금 아이템 구매 가능 여부 체크(GET /check）
	note right of S8: Transaction ID, 게임 내 사용자 ID, 아이템ID
	pub->>pub: 아이템 확보
	note right of pub: Transaction ID, 게임 내 사용자 ID, 아이템ID
	pub->>-S8: 확인 결과 반환
	note left of pub: 구매 가능 여부

	opt 포인트 사용액이 지정되어 있는 경우
	S8->>S8: 결제 금액 재계산
	end
	opt 포인트로 정산한 후 청구 잔액이 있는 경우
	S8->>+S8: 결제 실행
	note right of S8: Transaction ID, 결제 금액, 상품 정보
	S8->>-S8: 결제 결과 반환
	note left of S8: Transaction ID, 결제 상태
	end

	# 결제 성공 후 즉시 통지
	S8->>+pub: 게임 내 과금 아이템 판매 실적 등록(POST /register）
	note right of S8: Transaction ID, 게임 내 사용자 ID, 아이템ID
	pub->>pub: 아이템 가산
	pub->>-S8: 아이템 등록 결과 반환
	note left of pub: 등록 결과
	S8->>S8: 구매 결과 등록
	note over S8: Transaction ID, 사용자 ID, 게임 내 사용자 ID, 아이템 ID, 결제 금액, etc

	# 사용자에게 즉시 반영 확인
	S8->>user: 구매 완료 화면 표시
	note left of S8: 구매 화면에서 아이템 등록 결과
	S8->>user: 구매 알림 메일 발송
	note left of S8: 구매 알림 메일
```