홈 › 기술 사양 & API
시퀀스 다이어그램
📝 본 페이지는 참고용 번역(한국어)입니다. 일본어 원본과 차이가 있는 경우 일본어판을 우선합니다.
이 페이지에서는 앱 외부 결제의 시퀀스를 그림으로 정리했습니다.
게임 내 아이템 구매
다이어그램 소스 (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: 구매 알림 메일