다이렉트 링크로 판매

참고

다이렉트 링크 판매를 설정하기 전에, 계정에서 게임 키 패키지를 생성하세요.

또한 프로젝트에서 다음을 설정할 수 있습니다.

다이렉트 링크를 사용하면 게임 웹사이트, 소셜 미디어, 런처, 뉴스레터, 블로거 게시물 등 웹 페이지나 인앱 브라우저를 열 수 있는 곳이라면 어디서나 게임 키를 판매할 수 있습니다.

링크를 열면 엑솔라 주문 페이지가 표시됩니다. 이 페이지에서 사용자는 주문을 생성하고 결제하는 등 전체 구매 흐름을 진행합니다. 이를 위해 별도의 UI를 개발할 필요가 없습니다.

이 형식은 다음과 같은 상황에 적합합니다.

  • 여러 채널에서 게임 판매 또는 사전 판매를 빠르게 시작해야 합니다. 웹사이트, 소셜 미디어, 뉴스레터에 링크만 배치하세요.
  • 잘못된 이메일 또는 호환되지 않는 플랫폼으로 인해 발생하는 지원 요청을 줄여야 합니다. 사용자는 주문 페이지에서 누락된 데이터를 입력합니다. 여러 플랫폼용 키를 판매하는 경우, SKU에서 플랫폼을 미리 설정할 수 있습니다( 링크 형식과 매개 변수 참조).

사용자 절차

  1. 사용자가 링크를 엽니다.
  2. 엑솔라가 주문 페이지를 표시합니다.
  3. 사용자가 링크에서 전달되지 않은 데이터를 제공합니다.
    1. 키를 이용하는 플랫폼을 선택합니다.
    2. 프로모션 코드를 입력합니다(선택 사항).
    3. 영수증, 게임 키, 활성화 안내를 받을 이메일 주소를 입력하고 계속 버튼을 클릭합니다.
  1. 페이지에 입력한 주소가 다시 표시됩니다. 사용자가 주소를 확인하거나 변경 버튼을 클릭해 수정합니다.
참고

다음의 경우 주문 진행 단계가 달라질 수 있습니다.

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

게임 키 판매 링크의 형식은 다음과 같습니다.

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}

쿼리 매개 변수 목록

매개 변수설명
type

아이템 유형. 필수.

가능한 값:

project_id

프로젝트 ID. 다음 위치에서 확인할 수 있습니다.

  • 관리자 페이지 헤더에서 프로젝트 이름을 클릭하면 이름 옆에 표시됩니다.
  • 모든 관리자 페이지의 URL. URL 형식은 다음과 같습니다. https://publisher.xsolla.com/<merchant_id>/projects/<project_id>/.

필수.

sku

게임 키 패키지 SKU. 필수.

예시:

  • game456 - 특정 플랫폼이 없는 SKU입니다.
  • game456_steam - 특정 플랫폼이 포함된 SKU입니다. 엑솔라가 지원하는 플랫폼 목록과 접미사 예시는 아래 표를 참조하세요.

링크가 올바르게 동작하는지 확인하려면 게임 목록 가져오기 API 호출로 SKU 값을 확인할 수 있습니다. 아이템 SKU는 items.unit_items.sku 매개 변수로 반환됩니다(일반적으로 이 SKU는 game_key_sku_drm_sku 형태입니다).

xsolla_login_token엑솔라 로그인으로 받은 사용자 인증 토큰(JWT). 자세한 내용은 인증된 사용자에게 판매를 참조하세요.
access_data사용자 데이터와 결제 설정이 담긴 Base64 인코딩 JSON 개체. 자세한 내용은 인증된 사용자에게 판매를 참조하세요.
auth페이 스테이션으로 받은 사용자 인증 토큰. 자세한 내용은 인증된 사용자에게 판매를 참조하세요.
ui_settingsUI 테마 설정이 담긴 Base64 인코딩 JSON 개체. 자세한 내용은 UI 사용자 정의를 참조하세요.
mode테스트 결제를 위해 sandbox 값을 전달하세요. 자세한 내용은 결제 테스트를 참조하세요.
매개 변수설명
type

아이템 유형. 필수.

가능한 값:

project_id

프로젝트 ID. 다음 위치에서 확인할 수 있습니다.

  • 계정 헤더에서 프로젝트 이름을 클릭하면 이름 옆에 표시됩니다.
  • 모든 계정 페이지의 URL. URL 형식은 다음과 같습니다. https://xsolla.com/for/<business-account-type>/account/<merchant_id>/projects/<project_id>/.

필수.

sku

게임 키 패키지 SKU. 필수.

예시:

  • game456 - 특정 플랫폼이 없는 SKU입니다.
  • game456_steam - 특정 플랫폼이 포함된 SKU입니다. 엑솔라가 지원하는 플랫폼 목록과 접미사 예시는 아래 표를 참조하세요.

링크가 올바르게 동작하는지 확인하려면 게임 목록 가져오기 API 호출로 SKU 값을 확인할 수 있습니다. 아이템 SKU는 items.unit_items.sku 매개 변수로 반환됩니다(일반적으로 이 SKU는 game_key_sku_drm_sku 형태입니다).

xsolla_login_token엑솔라 로그인으로 받은 사용자 인증 토큰(JWT). 자세한 내용은 인증된 사용자에게 판매를 참조하세요.
access_data사용자 데이터와 결제 설정이 담긴 Base64 인코딩 JSON 개체. 자세한 내용은 인증된 사용자에게 판매를 참조하세요.
auth페이 스테이션으로 받은 사용자 인증 토큰. 자세한 내용은 인증된 사용자에게 판매를 참조하세요.
ui_settingsUI 테마 설정이 담긴 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

참고
플랫폼이 지정된 게임 키 패키지의 SKU를 링크에 전달하면, 사용자는 주문 페이지에서 플랫폼을 변경할 수 없습니다.

Steam에서 게임을 판매하기 위한 예시 URL

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam

UI 사용자 정의

주문 페이지 인터페이스를 게임 스타일에 맞추려면, 사용자 정의 지침에 따라 테마, 크기 및 기타 매개 변수를 구성하세요. 링크에 ui_settings 매개 변수를 추가하고, 여기에 Base64로 인코딩한 settings.ui JSON 개체를 전달하세요.

사용자 정의 테마로 주문 페이지를 여는 예시 URL

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

인증된 사용자에게 판매

참고

다이렉트 링크로 게임 키를 판매할 때는 인증이 필요하지 않습니다. 키는 사용자가 구매할 때 지정한 이메일 주소로 전송됩니다. 사용자당 키의 개수를 제한하거나, 자격 시스템을 사용하거나, 엑솔라 결제 UI에 사용자 데이터를 저장하려면 사용자 인증이 필요합니다.

추가 인증 단계를 적용하면 구매 전환율이 낮아질 수 있습니다.

인증된 사용자에게 게임 키를 판매하려면, 링크에 다음 매개 변수 중 하나를 추가하세요.

  • xsolla_login_token - 엑솔라 로그인을 통해 받은 JWT. 엑솔라 로그인으로 사용자를 인증하는 경우 이 매개 변수를 사용하세요. 토큰을 받으려면 로그인 API로 사용자를 인증하세요. 예: 사용자 이름 및 암호로 인증 호출.
  • auth - 페이 스테이션을 통해 받은 토큰. 자체 인증 시스템이 있는 경우 이 매개 변수를 사용하세요. 토큰을 받으려면 서버에서 토큰 생성 요청을 보내세요. 자세한 내용은 결제 UI를 열 토큰 가져오기를 참조하세요.
  • access_data - 사용자 데이터와 결제 설정이 담긴 Base64 인코딩 JSON 개체. 자체 인증 시스템이 있거나 이메일 주소와 국가를 전달해야 하는 경우 이 매개 변수를 사용하세요. 개체 구조는 토큰 생성 호출의 요청 본문(user 및 settings 개체)과 동일합니다.

인코딩 전 access_data용 JSON 예시

Copy
Full screen
Small screen
 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

Copy
Full screen
Small screen
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

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
알림
샌드박스 모드에서 구매 시 업로드한 키는 사용되지 않습니다. 시스템은 실제 키를 제공하지 않고 성공적인 구매를 시뮬레이션합니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2026년 11월 19일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!
피드백을 보내는 중 문제가 발생했습니다
잠시 후 다시 시도하거나 [email protected]으로 연락해 주세요.