Xsolla-logo
  • 문서화
  • 계정 생성

토큰 생성

post/merchants/{merchant_id}/token

임의의 사용자 매개변수로 토큰을 생성할 수 있습니다. 토큰을 받을 때 이러한 매개변수를 전송하고, 결제가 성공적으로 완료된 후 전송했던 매개변수를 다시 받습니다. 토큰에는 이 문서에 설명되어 있거나 미리 정의한 매개변수만 포함할 수 있습니다.

매개변수가 잘못된 형식으로 전송되거나 잘못된 유형인 경우 토큰이 발급되지 않습니다. JSON 본문으로 오류 설명이 포함된 422 HTTP 코드를 받게 됩니다. extended_message로 정확히 어떤 매개변수가 잘못 전송되었는지에 대한 정보를 받게 됩니다.

기본적으로 토큰의 수명은 24시간입니다. 이 값을 변경하려면 계정 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요. 새 값은 관리자 페이지에서 생성한 회사의 모든 프로젝트에서 활성화됩니다.

주의

이 API 메소드를 호출한 후 획득한 토큰은 다른 요청을 인증하는 용도로만 사용할 수 있습니다. 이 토큰은 정기 결제 제품을 연동한 경우에만 결제 UI를 여는 데 사용할 수 있습니다.

주의

이 API 호출에는 project_id 경로 매개 변수가 포함되어 있지 않으므로 회사의 모든 프로젝트에서 유효한 API 키를 사용하여 인증을 설정해야 합니다.

SecuritybasicAuth
Request
path Parameters
merchant_id
required
integer

판매자 ID입니다.

Request Body schema: application/json
object

이 개체에는 부정 결제 방지 필터를 구성하는 매개 변수가 포함되어 있습니다. 매개 변수 목록은 아래와 같습니다. 사용자 정의 매개 변수를 추가하려면 계정 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내 주세요.

active_date
string

ISO 8601에 따른 마지막 확인 날짜.

additional_verification
boolean

플레이어가 계정 확인 절차를 사용하고 있는지 여부.

character_customized
boolean

플레이어가 자신의 캐릭터를 맞춤 설정했는지 여부.

chat_activity
boolean

플레이어의 채팅 기능 사용 여부.

completed_tasks
integer

완료한 임무/목표의 수.

forum_activity
boolean

플레이어의 포럼 기능 사용 여부.

items_used
boolean

플레이어가 구매한 인게임 아이템을 사용하고 있는지 여부.

karma_points
integer

플레이어의 카르마.

last_change_password_date
string

ISO 8601에 따른 마지막 암호 변경 날짜.

non_premium_currency
number <float>

프리미엄이 아닌 통화의 금액.

notifications_enabled
boolean

플레이어가 알림을 활성화했는지 여부.

profile_completed
boolean

플레이어가 프로필에 추가 정보를 추가했는지 여부.

profile_image_added
boolean

플레이어가 프로필 이미지를 업로드했는지 여부.

pvp_activity
boolean

플레이어가 PvP 전투에 참여하고 있는지 여부.

registration_date
string

ISO 8601에 따른 계정 생성일.

session_time
string

ISO 8601에 따른 평균 세션 시간.

social_networks_added
boolean

플레이어가 소셜 미디어 프로필을 연결했는지 여부.

total_bans
integer

플레이어가 채팅/포럼에서 금지된 횟수.

total_characters
integer

인게임 캐릭터 수.

total_clans
integer

플레이어가 가입한 클랜의 수.

total_friends
integer

친구의 수.

total_game_events
integer

플레이어가 참여했던 인게임 이벤트의 수.

total_gifts
integer

플레이어가 전송/수신한 인게임 선물의 수.

total_hours
integer

총 인게임 시간.

total_inventory_value
number <float>

인벤토리의 총 가치(인게임 통화).

total_sum
number <float>

총 결제 금액.

tutorial_completed
boolean

플레이어가 게임 튜토리얼을 완료했는지 여부.

unlocked_achievements
integer

잠금을 해제한 업적의 수.

user_level
integer

플레이의 레벨, 명성 또는 순위.

win_rate
integer

승률.

object

구매 데이터 관련 값입니다.

object

정기결제 데이터 관련 값입니다.

available_plans
Array of strings

구독권에 대한 데이터가 있는 배열입니다. 오직 이러한 구독권만 결제 UI에 보여집니다.

currency
string

구매 시 플랜의 통화, 이를 바탕으로 모든 계산이 수행됩니다.

operation
string

사용자의 구독 플랜에 적용되는 작업 유형. 구독 플랜을 변경하려면 change_plan 값을 전달합니다. purchase.subscription.plan_id 매개변수에서 새 플랜 ID를 지정해야 합니다.

plan_id
string

구독 플랜 외부 ID. 게시자 계정의 구독 > 구독 플랜 섹션에서 확인할 수 있습니다.

product_id
string

제품 ID.

trial_days
integer

평가 기간(일)입니다.

object

사용자의 결제 프로세스와 결제 UI를 구성하는 설정입니다.

project_id
required
integer

엑솔라 시스템 내의 게임 식별자입니다. 판매자 계정 에서 확인할 수 있습니다.

currency
string

선호하는 결제 통화입니다. 통화의 3자리 정의가 ISO 4217에 따라 사용됩니다.

external_id
string

게임 내 트랜잭션 ID. 각 사용자 결제마다 고유해야 합니다. 자세한 정보는 문서 자료를 참조하세요.

language
string

인터페이스 언어입니다. 2자리 소문자 언어 코드입니다.

mode
string

결제 프로세스를 테스트하기 위한 sandbox 값을 설정합니다. 참고로 결제 UI의 URL은 https://sandbox-secure.xsolla.com 이 됩니다.

payment_method
integer

결제 수단의 ID입니다.

payment_widget
string

결제 위젯. '페이바이캐쉬(paybycash)' 혹은 '기프트카드(giftcard)'일 수 있습니다. 한도가 설정되면, 사용자는 각각 페이바이캐쉬(Pay by Cash) 혹은 기프트 카드(Gift Cards) 위젯으로 다시 보내집니다.

Enum: "paybycash" "giftcard"
object

재지정 정책 설정(객체).

delay
integer

사용자가 복귀 URL로 자동 재지정된 이후 지연 시간(초).

manual_redirection_action
string

페이 스테이션 동작은 닫기 버튼 또는 게임으로 돌아가기 버튼을 사용자가 클릭하면 트리거됩니다. redirect(기본값) 및 postmessage가 될 수 있습니다. redirect로 설정되었다면 사용자는 토큰에서 전달되었거나 게시자 계정에서 지정된 URL로 리디렉션 됩니다. postmessage로 설정되었다면 사용자는 다른 페이지로 리디렉션되지 않습니다. 닫기 아이콘 버튼을 클릭하면 close 이벤트 보내기 및 clicking the 게임으로 돌아가기 버튼 클릭(return 이벤트)이 초기화됩니다.

Enum: "redirect" "postmessage"
redirect_button_caption
string

수동 재지정 버튼 문구.

redirect_conditions
string

복귀 URL로 사용자 재지정 시 지불 상태. 이는 none, successful, successful_or_canсeled, 혹은 any일 수 있습니다.

Enum: "none" "successful" "successful_or_canceled" "any"
status_for_manual_redirection
string

복귀 URL로 사용자 재지정 버튼 지불 상태. 이는 none, successful, successful_or_canсeled, 혹은 any일 수 있습니다.

Enum: "none" "successful" "successful_or_canceled" "any"
return_url
string

결제 후 사용자가 리디렉션되는 페이지의 URL입니다. 리디렉션 구성에 대한 자세한 내용은 이 문서를 참조하세요.

object

인터페이스 설정 데이터와 관련된 값입니다.

object

모듈 메뉴 설정 데이터와 관련된 값입니다.

object

정기 결제 모듈 설정 데이터와 관련된 값입니다.

hidden
boolean

모듈 메뉴에 게임 아이템을 표시하는지 여부를 나타냅니다.

order
integer

모듈 메뉴에서 게임 아이템의 위치입니다.

object

게임머니 모듈 설정 데이터와 관련된 값입니다.

custom_amount
boolean

사용자가 결제 UI에 임의의 가상 통화 수량을 입력할 수 있도록 설정합니다.

hidden
boolean

모듈 메뉴에 게임 아이템을 표시하는지 여부를 나타냅니다.

order
integer

모듈 메뉴에서 게임 아이템의 위치입니다.

object

게임 아이템 모듈 설정 데이터와 관련된 값입니다.

hidden
boolean

모듈 메뉴에 게임 아이템을 표시하는지 여부를 나타냅니다.

order
integer

모듈 메뉴에서 게임 아이템의 위치입니다.

selected_group
string

게임유저가 게임 아이템 탭을 열었을 때 선택되는 그룹입니다.

selected_item
string

게임유저가 게임 아이템 탭을 열었을 때 선택되는 아이템입니다. 아이템 SKU는 이곳에서 보내야 합니다.

currency_format
string

결제 UI에 3자리 ISO 4217 통화 코드를 표시하려면 code로 설정합니다. 기본적으로는 3자리 통화 코드 대신 통화 기호가 표시됩니다.

object

PC 버전의 인터페이스 설정 데이터와 관련된 값입니다.

object

헤더 설정 데이터와 관련된 값입니다.

close_button
boolean

결제 UI에 닫기 버튼을 표시할지 여부입니다. 이 버튼은 결제 UI를 닫고 사용자를 settings.return_url 매개 변수에 지정된 URL로 리디렉션합니다. 기본값은 false입니다.

close_button_icon
string

결제 UI의 닫기 버튼 아이콘.

Enum: Description
arrow

결제 UI 헤더 왼쪽에 있는 아이콘.

cross

결제 UI 헤더 오른쪽에 있는 × 아이콘.

is_visible
boolean

결제 UI에 헤더가 표시되는지 여부를 나타냅니다.

type
string

헤더를 표시하는 설정 방식입니다. compact(프로젝트 이름 및 사용자 ID 표지 안 함) 또는 normal (기본값)을 설정할 수 있습니다.

Enum: "compact" "normal"
visible_logo
boolean

true일 경우, 로고가 헤더에 표시됩니다(먼저 고객 성공 관리자에게 이미지를 제공하세요).

visible_name
boolean

프로젝트 이름이 헤더에 표시되는지 여부를 나타냅니다.

visible_purchase
boolean

구매 설명(purchase.description.value)이 헤더에 표시되는지 여부를 나타냅니다. 기본값은 true입니다.

object

정기 결제 목록 설정 데이터와 관련된 값입니다.

description
string

정기결제에 관한 어떠한 텍스트도 이곳에서 전달할 수 있습니다. 정기 결제 요금제 목록 위에 텍스트가 표시됩니다.

display_local_price
boolean

true인 경우 및 사용자의 현지 통화가 정기결제 플랜의 통화와 다른 경우, 사용자는 현지 통화의 가격 및 기본 통화의 가격과 같이 두 가지 가격을 볼 수 있습니다.

gp_quick_payment_button
boolean

Google Pay 결제 방식을 표시하는 방법. true인 경우, Google Pay를 통한 빠른 결제 버튼이 결제 UI 상단에 표시됩니다. false인 경우, PayRank 알고리즘에 따라 결제 방식 목록에 Google Pay가 표시됩니다. 기본적으로 false입니다.

object
visible_virtual_currency_balance
boolean

결제 UI에서 이 요소를 숨길 수 있는지 여부를 나타냅니다. 기본값은 true입니다.

is_cart_open_by_default
boolean

모바일 버전으로 결제 UI를 열 때 장바구니에 있는 아이템 목록을 표시할지 여부입니다. true이면 목록이 확장된 보기로 표시됩니다. false(기본값)이거나 매개 변수가 전달되지 않으면 목록이 축소된 보기로 표시됩니다.

is_independent_windows
boolean

구매 시 사용자를 임베디드 런처의 브라우저(WebView)에서 기본 브라우저로 리디렉션할지 여부입니다. 기본값은 false입니다.

is_payment_methods_list_mode
boolean

결제 UI를 열 때 사용자의 국가에서 사용할 수 있는 결제 방식목록이 표시되는지 여부입니다. false(기본값)인 경우 settings.payment_method 매개변수에서 전달된 결제 방식이나 PayRank 알고리즘으로 선택한 결제 방식이 표시됩니다.

is_prevent_external_link_open
boolean

외부 리소스로 링크 리디렉션 여부가 비활성화되었습니다.false가 기본값입니다. 외부 링크를 클릭하면external-link-open이벤트가postMessage메커니즘을 통해 전송됩니다. 리디렉션 링크용 주소는url매개 변수에서 전달됩니다.

is_show_close_widget_warning
boolean

결제 페이지를 닫기 전에 × 아이콘 위에 트랜잭션 처리에 대한 경고를 표시할지 여부입니다. false가 전달되거나 매개변수가 전달되지 않으면 경고가 표시되지 않습니다. 기본값은 true입니다.

is_three_ds_independent_windows
boolean

3D 보안 검사를 새 브라우저 창에서 열지 여부를 선택합니다. 기본값은 false입니다. 콘텐츠 보안 정책(CSP)를 사용하는 경우 true를 전달합니다.

layout
string

결제 UI의 주요 요소 위치. 게임 내부에서 결제 UI를 열거나 주문 및 결제 방식에 대한 정보로 열을 바꿀 수 있습니다. 자세한 내용은 사용자 정의 지침을 참조해 주세요.

Enum: "embed" "column_reverse" "embed_column_reverse"
object
object
close_button
boolean

페이 스테이션 모바일에서 닫기 버튼을 표시할지 여부. 이 버튼을 누르면 페이 스테이션이 종료되고settings.return_url 매개 변수에 지정된 URL로 사용자를 리디렉션합니다(기본값: false).

close_button_icon
string

결제 UI의 닫기 버튼 아이콘.

Enum: Description
arrow

결제 UI 헤더 왼쪽에 있는 아이콘.

cross

결제 UI 헤더 오른쪽에 있는 × 아이콘.

mode
string

사용자 계정의 결제 인터페이스입니다. 가능한 값은 user_account입니다. 헤더에는 제품을 선택하거나 결제를 하기 위한 옵션 없이 사용자 계정의 탐색 메뉴만 포함되어 있고, 사용자 계정은 데스크톱 모드에서만 사용 가능합니다.

theme
string

결제 UI 테마. 라이트 테마(기본값)의 경우 63295a9a2e47fab76f7708e1, 다크 테마의 경우 63295aab2e47fab76f7708e3일 수 있습니다. 사용자 정의 테마를 생성하고 이 매개 변수의 해당 ID를 전달할 수도 있습니다.

Enum: "63295a9a2e47fab76f7708e1" "63295aab2e47fab76f7708e3"
object

사용자 계정에 관한 데이터가 담긴 객체.

object

내 계정 페이지입니다.

enable
boolean

섹션을 표시할 지 여부를 설정합니다. 기본값은 false입니다.

order
integer

드롭다운 목록에서 섹션의 위치입니다.

object

저장된 결제 방식 섹션입니다.

enable
boolean

결제 방식 편집 페이지로 이동하는 결제 UI에 연필 아이콘을 표시할지 여부를 지정합니다. 기본값은 true입니다.

object

구독 관리 섹션입니다.

enable
boolean

섹션을 표시할 지 여부를 설정합니다. 기본값은 false입니다.

order
integer

드롭다운 목록에서 섹션의 위치입니다.

object

사용자 세부 정보.

required
object
value
required
string

귀하 측에 저장된 게임 내 고유 사용자 ID입니다. 기존 사용자 ID여야 합니다. 오류가 발생하면 자주 묻는 질문에 대한 답변을 참조해 주세요.

age
integer

사용자 나이.

attributes
object

게임유저 특성 데이터와 관련된 객체로서 아이템 목록을 필터링하는데 사용됩니다. 키값 쌍을 가진 올바른 JSON 해시여야 합니다.

object
allow_modify
boolean

결제 UI에서 사용자의 국가 변경 가능 여부. country.value가 토큰에서 전달되면 기본값은 false입니다.

value
string

ISO 3166-1 alpha-2 standard에 따른 2자로 된 국가 코드를 사용합니다.

object <= 100 characters

user.email 개체는 부정 결제 방지 모델 만들기의 정수 부분이며 수락률을 높여줍니다. 해당 개체는 엑솔라와 결제 시스템 양쪽 모두의 요구 사항입니다. 매개 변수가 전달되지 않으면 이메일 입력용 필수 필드가 결제 페이지에 나타납니다. 사용자는 매개 변수에서 전달되었거나 결제 페이지에 입력된 이메일로 구매 영수증을 받습니다.

value
required
string

사용자 이메일. RFC 822 프로토콜에 따라 유효해야 합니다.

allow_modify
boolean

결제 UI에서 사용자가 자신의 이메일을 입력할 수 있는지 여부. user.email.value 매개변수가 토큰에서 전달되는 경우 기본값은 false입니다.

is_legal
boolean

게임유저가 법인인지 여부를 나타냅니다.

object

법인 세부 정보가 있는 오브젝트. user.is_legaltrue인 경우 오브젝트와 이에 해당하는 모든 매개변수는 필수입니다.

address
string

법인 전체 주소.

country
string

기업이 속한 국가. ISO 3166-1 alpha-2 standard에 따른 2자로 된 대문자 국가 코드를 사용합니다.

name
string

법인 전체 이름.

vat_id
string

개별 납세자 식별자.

object
allow_modify
boolean

결제 UI에서 사용자가 자신의 이름을 입력할 수 있는지 여부. user.name.value 매개변수가 토큰에서 전달되는 경우 기본값은 false입니다.

value
string

게임유저 닉네임입니다.

object
value
string

전화번호.

object
value
string

사용자를 고유하게 식별할 수 있고 사용자 ID(이메일, 애칭 등)와 달리 사용자에 대해 알려진 매개 변수입니다. 이 매개 변수는 게임 스토어 외부(예: 캐시 키오스크의 게임 버튼)에서 구매할 수 있을 때 사용됩니다.

object
value
string

Steam ID입니다.

object
value
string = 32 characters

고유 사용자 ID - 마케팅 캠페인에 사용. 숫자와 라틴 문자를 사용할 수 있습니다.

object

트래픽 성향을 나타내는 데이터를 포함한 오브젝트.

utm_campaign
string

캠페인 제목. 이 항목은 음차한 캠페인 제목이나 영어로 번역한 캠페인 제목을 포함해야 합니다.

utm_content
string

캠페인 구성 요소.

utm_medium
string

트래픽 채널(맥락 이해 광고, 언론 광고, 이메일 목록 메시지).

utm_source
string

트래픽 소스.

utm_term
string

캠페인 키워드. 이 항목을 지정할 경우 광고 캠페인 목표 설정에 사용된 키워드 데이터에 기반하여 통계가 만들어집니다. Google Analytics에서는 utm_term 라벨 콘텐츠가 검색어를 포함한 일반 보고서의 일부가 됩니다.

Responses
200

Created.

422

Unprocessable Entity.

Request samples
application/json
{
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "token": "eop57k1boA7nnYPtewZ6KEXJyJADEwRT"
}