Game8 Store – Developer Center
› 기술 사양 & API

시퀀스 다이어그램

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

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

게임 내 아이템 구매

👤 사용자Game8 Store게임(퍼블리셔API)👤 사용자Game8 Store게임(퍼블리셔API)구매 상품 선택결제 정보 등록1. 신용카드 정보 전송신용카드 정보2. e-Scott Transaction ID발급Transaction ID상품 구매3. 게임 내 과금 아이템 구매 (신용카드 정보 전송과동시)Transaction ID, 게임 내 사용자 ID, 아이템ID, 사용 포인트 수4. 게임 내 과금 아이템 구매 가능 여부 체크(GET /checkTransaction ID, 게임 내 사용자 ID,아이템ID5. 아이템 확보Transaction ID, 게임 내 사용자 ID,아이템ID6. 확인 결과 반환구매 가능 여부7. 결제 금액 재계산opt[포인트 사용액이 지정되어 있는 경우]8. 결제 실행Transaction ID, 결제 금액, 상품 정보9. 결제 결과 반환Transaction ID, 결제 상태opt[포인트로 정산한 후 청구 잔액이 있는 경우]결제 성공 후 즉시 통지10. 게임 내 과금 아이템 판매 실적 등록(POST /registerTransaction ID, 게임 내 사용자 ID,아이템ID11. 아이템 가산12. 아이템 등록 결과 반환등록 결과13. 구매 결과 등록Transaction ID, 사용자 ID, 게임 내 사용자ID, 아이템 ID, 결제 금액, etc사용자에게 즉시 반영 확인14. 구매 완료 화면 표시구매 화면에서 아이템 등록 결과15. 구매 알림 메일 발송구매 알림 메일
다이어그램 소스 (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: 구매 알림 메일