다이렉트 링크로 판매
다이렉트 링크를 사용하면 게임 웹사이트, 소셜 미디어, 런처, 뉴스레터, 블로거 게시물 등 웹 페이지나 인앱 브라우저를 열 수 있는 곳이라면 어디서나 게임 키를 판매할 수 있습니다.
링크를 열면 엑솔라 주문 페이지가 표시됩니다. 이 페이지에서 사용자는 주문을 생성하고 결제하는 등 전체 구매 흐름을 진행합니다. 이를 위해 별도의 UI를 개발할 필요가 없습니다.
이 형식은 다음과 같은 상황에 적합합니다.
- 여러 채널에서 게임 판매 또는 사전 판매를 빠르게 시작해야 합니다. 웹사이트, 소셜 미디어, 뉴스레터에 링크만 배치하세요.
- 잘못된 이메일 또는 호환되지 않는 플랫폼으로 인해 발생하는 지원 요청을 줄여야 합니다. 사용자는 주문 페이지에서 누락된 데이터를 입력합니다. 여러 플랫폼용 키를 판매하는 경우, SKU에서 플랫폼을 미리 설정할 수 있습니다( 링크 형식과 매개 변수 참조).
사용자 절차
- 사용자가 링크를 엽니다.
- 엑솔라가 주문 페이지를 표시합니다.
- 사용자가 링크에서 전달되지 않은 데이터를 제공합니다.
- 키를 이용하는 플랫폼을 선택합니다.
- 프로모션 코드를 입력합니다(선택 사항).
- 영수증, 게임 키, 활성화 안내를 받을 이메일 주소를 입력하고 계속 버튼을 클릭합니다.
- 페이지에 입력한 주소가 다시 표시됩니다. 사용자가 주소를 확인하거나 변경 버튼을 클릭해 수정합니다.

다음의 경우 주문 진행 단계가 달라질 수 있습니다.
- 플랫폼 선택은 게임 키 패키지의 SKU가 플랫폼 없이 전달된 경우에만 가능합니다.
- 프로모션 코드 입력은 게임 키 패키지 또는 번들에 활성 프로모션 코드가 있는 경우에만 가능합니다.
- 인증된 사용자는 사용자 데이터에 있는 주문 양식에 이메일 주소가 자동으로 채워집니다.
- 엑솔라가 선택한 플랫폼의 키를 예약하고 결제 UI를 엽니다.
- 사용자가 결제를 완료합니다.
- 결제가 완료되면 엑솔라가 확인된 이메일 주소로 영수증, 게임 키, 활성화 안내를 발송합니다.

링크 형식과 매개 변수
게임 키 판매 링크의 형식은 다음과 같습니다.
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}
쿼리 매개 변수 목록
| 매개 변수 | 설명 |
|---|---|
type | 아이템 유형. 필수. 가능한 값:
|
project_id | 프로젝트 ID. 다음 위치에서 확인할 수 있습니다.
필수. |
sku | 게임 키 패키지 SKU. 필수. 예시:
링크가 올바르게 동작하는지 확인하려면 게임 목록 가져오기 API 호출로 SKU 값을 확인할 수 있습니다. 아이템 SKU는 |
xsolla_login_token | 엑솔라 로그인으로 받은 사용자 인증 토큰(JWT). 자세한 내용은 인증된 사용자에게 판매를 참조하세요. |
access_data | 사용자 데이터와 결제 설정이 담긴 Base64 인코딩 JSON 개체. 자세한 내용은 인증된 사용자에게 판매를 참조하세요. |
auth | 페이 스테이션으로 받은 사용자 인증 토큰. 자세한 내용은 인증된 사용자에게 판매를 참조하세요. |
ui_settings | UI 테마 설정이 담긴 Base64 인코딩 JSON 개체. 자세한 내용은 UI 사용자 정의를 참조하세요. |
mode | 테스트 결제를 위해 sandbox 값을 전달하세요. 자세한 내용은 결제 테스트를 참조하세요. |
| 매개 변수 | 설명 |
|---|---|
type | 아이템 유형. 필수. 가능한 값:
|
project_id | 프로젝트 ID. 다음 위치에서 확인할 수 있습니다.
필수. |
sku | 게임 키 패키지 SKU. 필수. 예시:
링크가 올바르게 동작하는지 확인하려면 게임 목록 가져오기 API 호출로 SKU 값을 확인할 수 있습니다. 아이템 SKU는 |
xsolla_login_token | 엑솔라 로그인으로 받은 사용자 인증 토큰(JWT). 자세한 내용은 인증된 사용자에게 판매를 참조하세요. |
access_data | 사용자 데이터와 결제 설정이 담긴 Base64 인코딩 JSON 개체. 자세한 내용은 인증된 사용자에게 판매를 참조하세요. |
auth | 페이 스테이션으로 받은 사용자 인증 토큰. 자세한 내용은 인증된 사용자에게 판매를 참조하세요. |
ui_settings | UI 테마 설정이 담긴 Base64 인코딩 JSON 개체. 자세한 내용은 UI 사용자 정의를 참조하세요. |
mode | 테스트 결제를 위해 sandbox 값을 전달하세요. 자세한 내용은 결제 테스트를 참조하세요. |
특정 플랫폼용 게임 키 패키지를 판매하려면, sku 쿼리 매개 변수에서 플랫폼 접미사가 포함된 게임 키 패키지 SKU를 전달하세요. 접미사는 패키지를 어디에서 생성하느냐에 따라 자동으로 추가되거나 수동으로 지정합니다.
- 계정에서 게임 키 패키지를 생성하면, 수동으로 입력한 SKU에
_steam또는_playstation처럼 특정 플랫폼 접미사가 밑줄(_)로 구분되어 자동으로 추가됩니다. - API 호출로 플랫폼별 게임 키 패키지를 생성하면, 소문자/대문자 라틴 문자, 숫자, 마침표(.), 대시(-), 밑줄(_)만 사용해 임의의 형식으로 접미사를 지정할 수 있습니다.
| 이름 | SKU 접미사 예시 |
|---|---|
| Steam | _steam |
| PlayStation | _playstation |
| Xbox | _xbox |
| Uplay | _uplay |
| Origin | _origin |
| DRM Free | _drmfree |
| GOG | _gog |
| Epic Games | _epicgames |
| Nintendo Switch eShop | _nintendo_eshop |
| Discord Game Store | _discord_game_store |
| Oculus | _oculus |
| Viveport | _viveport |
| Google Stadia | _stadia |
| MY.GAMES Store | _my_game |
Steam에서 게임을 판매하기 위한 예시 URL
- http
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam
UI 사용자 정의
주문 페이지 인터페이스를 게임 스타일에 맞추려면, 사용자 정의 지침에 따라 테마, 크기 및 기타 매개 변수를 구성하세요. 링크에 ui_settings 매개 변수를 추가하고, 여기에 Base64로 인코딩한 settings.ui JSON 개체를 전달하세요.
사용자 정의 테마로 주문 페이지를 여는 예시 URL
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=
인증된 사용자에게 판매
인증된 사용자에게 게임 키를 판매하려면, 링크에 다음 매개 변수 중 하나를 추가하세요.
xsolla_login_token- 엑솔라 로그인을 통해 받은 JWT. 엑솔라 로그인으로 사용자를 인증하는 경우 이 매개 변수를 사용하세요. 토큰을 받으려면 로그인 API로 사용자를 인증하세요. 예: 사용자 이름 및 암호로 인증 호출.auth- 페이 스테이션을 통해 받은 토큰. 자체 인증 시스템이 있는 경우 이 매개 변수를 사용하세요. 토큰을 받으려면 서버에서 토큰 생성 요청을 보내세요. 자세한 내용은 결제 UI를 열 토큰 가져오기를 참조하세요.access_data- 사용자 데이터와 결제 설정이 담긴 Base64 인코딩 JSON 개체. 자체 인증 시스템이 있거나 이메일 주소와 국가를 전달해야 하는 경우 이 매개 변수를 사용하세요. 개체 구조는 토큰 생성 호출의 요청 본문(user및settings개체)과 동일합니다.
인코딩 전
- json
1{
2 "user": {
3 "id": {
4 "value": "USER_ID"
5 },
6 "email": {
7 "value": "[email protected]"
8 },
9 "country": {
10 "value": "US"
11 }
12 },
13 "settings": {
14 "language": "en",
15 "currency": "USD"
16 }
17}
JSON 개체를 Base64로 인코딩하고, 결과를 링크의 access_data 매개 변수에 전달하세요.
인증 방식과 인증 토큰 생성에 대한 자세한 내용은 게임 키 판매를 위한 인증 설정 방법을 참조하세요.
인증 토큰으로 주문 페이지를 여는 예시 URL
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}
결제 테스트
샌드박스 모드에서 결제를 테스트하려면 링크에 mode=sandbox 매개 변수를 추가하세요. 테스트 은행 카드로 거래를 완료할 수 있습니다.
샌드박스 모드에서 주문 페이지를 여는 예시 URL
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.