웹숍 연동
국내·외 웹숍과의 연동을 통해 게임 외부 결제 환경을 구성할 수 있습니다.
웹숍에서 결제가 완료되면, 뒤끝 서버를 통해 해당 아이템 정보가 우편으로 전송됩니다.
웹숍 연동
뒤끝은 뉴플레이(Newplay), 엑솔라(Xsolla) 웹숍의 연동을 지원합니다.
웹숍별로 연동 방식과 설정 항목이 다르므로, 사용 중인 웹숍의 안내를 참고하여 설정해 주세요.
뉴플레이
뉴플레이 웹숍을 연동하려면 아래 단계를 순서대로 진행합니다.
- 연동 활성화
연동 활성화토글을 ON으로 설정합니다.- 활성화 시, 게임 ID 및 API Secret 입력 항목이 표시됩니다.
- 연동 정보 입력
- 게임 ID와 API Secret을 입력합니다.
- 해당 값은 뉴플레이 콘솔에서 확인할 수 있습니다.
- 저장 시 유효성 검사가 진행되며, 정확한 값을 입력해야 정상 연동됩니다.
- 웹훅 URL 설정
- 연동 정보 저장 후, 뒤끝 콘솔에 제공되는 5개의 웹훅 URL을 확인합니다.
- 해당 URL들을 뉴플레이 콘솔의 웹훅 설정 메뉴에 모두 등록해야 합니다.
- 웹훅이 정상적으로 등록되지 않은 경우, 유저 인증이나 아이템 지급이 정상 동작하지 않을 수 있습니다.
엑솔라
엑솔라 웹숍은 연동 전에 입점 확인 절차가 필요합니다.
입점 확인이 완료된 이후에만 연동을 진행할 수 있습니다.
1. 입점 확인
- 엑솔라 탭에서는 현재 입점 상태를 확인할 수 있습니다.
| 상태 | 설명 |
|---|---|
| 입점 확인 필요 | 입점 확인 요청 전 상태. 입점 확인 요청하기 버튼을 통해 요청할 수 있습니다. |
| 입점 확인 진행중 | 요청이 접수되어 뒤끝 운영팀이 입점 여부를 확인 중인 상태입니다. |
| 입점 확인 완료 | 입점 확인이 완료되었으니 연동 작업을 진행해주세요. |
2. 연동 정보 입력
- 입점 확인 완료 후, Project ID, Secret Key 항목을 입력합니다.
- 엑솔라 콘솔 > 프로젝트 설정 > Webhook에서 확인할 수 있습니다.
Secret Key는 엑솔라 콘솔에서 최초 발급 시에만 확인할 수 있으며, 이후에는 다시 조회할 수 없습니다.
발급 즉시 정확하게 복사하여 입력해 주세요.
3. 엑솔라 Webhook URL
- 연동 정보 저장 후 Webhook URL을 엑솔라 콘솔 > 프로젝트 설정 > Webhook 메뉴에 등록합니다.
4. 참고사항
- 현재 뒤끝 웹숍 연동은 엑솔라의 정기결제(Subscription) 상품을 지원하지 않습니다.
- 단, 관련 Webhook 이벤트가 수신될 경우 로그에는 저장됩니다.
공통 지원
우편 문구 설정
웹숍 결제로 아이템이 지급될 때 발송되는 우편의 제목과 발송인을 설정할 수 있습니다.
뉴플레이, 엑솔라 각 탭의 연동 설정 화면에서 웹숍별로 개별 설정할 수 있습니다.
게이머 식별자
웹숍 연동 시 게이머 식별값으로 UID 또는 UUID 를 모두 사용할 수 있습니다. 단, 동일 프로젝트 내에서는 하나의 기준으로 통일하는 것을 권장합니다.
우편 지급 정책
웹숍 상품은 우편으로 지급됩니다. 웹숍 우편에 적용되는 정책은 다음과 같습니다.
| 항목 | 내용 |
|---|---|
| 우편 타입 | webshop |
| 수령 가능 기간 | 발송일로부터 최대 30일 |
| 만료 처리 | 30일 경과 시 자동 만료. 만료된 우편은 수령할 수 없습니다. |
| 회수 가능 조건 | 미수령 우편만 회수 가능. 이미 수령한 우편은 회수되지 않습니다. |
- 우편 수령 후 게임 클라이언트에서 아이템 정보를 기준으로 실제 지급 처리가 진행됩니다.
- 관련 SDK 문서: 우편 종류 (웹숍 상품 우편)
웹숍 연동 및 운영 프로세스
웹숍 기능은 연동 프로세스와 운영 프로세스로 나누어 볼 수 있습니다.
연동 프로세스
웹숍 연동을 위해 아래 과정을 먼저 완료해야 합니다.
- 운영하려는 웹숍의 가입 또는 입점을 진행합니다. 뒤끝 웹숍 연동 페이지에서 각 스토어에 진입할 수 있습니다.
- 연동할 웹숍을 활성화한 후 웹숍에서 발급받은 키 정보를 저장합니다. (입력 항목은 웹숍별로 다를 수 있습니다.)
- 웹숍 관리자 페이지에 뒤끝 서버에서 제공하는 웹훅 URL을 등록합니다. (웹숍별로 필요한 웹훅과 용도가 다를 수 있습니다.)
- 모든 설정을 마치면 웹숍 연동이 완료됩니다.
엑솔라는 위 1단계 이전에 입점 확인 절차가 필요합니다. 콘솔에서 입점 확인 요청하기를 먼저 진행하세요.
운영 프로세스
연동이 완료된 이후의 운영 흐름은 다음과 같습니다.
- 웹숍 로그인 시 유저 확인
- 웹숍 로그인 과정에서 뒤끝 서버를 통해 유저 존재 여부 확인이 진행됩니다.
- 뉴플레이의 경우 추가 인증 절차를 제공합니다(SDK 문서).
- 유저는 웹숍 로그인 후 [게임 ID]란에 자신의 UID값을 입력합니다.
- 해당 UID를 기준으로 인증번호 우편이 발송됩니다.
- 클라이언트에서 우편 정보를 확인한 후 웹숍 페이지에 인증번호를 입력하여 인증을 완료합니다.
- 아이템 구매 및 지급
- 유저가 웹숍에서 아이템을 구매하면, 결제 완료 웹훅이 뒤끝 서버로 전달됩니다.
- 뒤끝 서버는 결제 정보를 검증한 후, 해당 정보를 웹숍 우편(SDK 문서)으로 발송합니다.
- 게임 클라이언트 처리
- 클라이언트에서는 우편 수령 시 전달된 아이템 정보를 기준으로 게임 정보, 데이터베이스 또는 펑션 로직을 통해 실제 아이템 지급 처리를 진행합니다.
- 지급 내역 관리
- 뒤끝 콘솔의 지급 내역 메뉴에서 웹숍을 통해 지급된 아이템 내역을 조회할 수 있으며, 필요 시 미수령 우편에 대한 회수 처리도 가능합니다.
- 결제 및 정산 정보 확인
- 결제 금액, 정산 내역 등은 각 웹숍의 관리자 콘솔에서 확인하실 수 있습니다.