Xsolla-logoXsolla Developers
또는
관리자 페이지로

토큰 생성(레거시)

post/merchants/{merchant_id}/token

임의 사용자 매개 변수를 이용해 토큰을 생성할 수 있습니다. 토큰을 얻을 때 이러한 매개 변수를 전송하시면 성공적인 결제 후 저희는 해당 매개 변수를 받습니다. 토큰은 이 문서에 설명되었거나 귀하가 사전 정의한 매개 변수만 포함할 수 있습니다.

매개 변수가 잘못된 형식으로 전송되었거나 잘못된 유형을 하고 있다면 토큰은 발급되지 않습니다. 귀하께서는 JSON 본문에 오류 설명이 있는 422 HTTP 코드를 받게 됩니다. extended_message에서 귀하는 전송된 매개 변수의 어떤 점이 잘못되었는지에 관한 정보를 받게 됩니다.

SecuritybasicAuth
Request
path Parameters
merchant_id
required
integer

판매자 ID입니다.

Request Body schema: application/json
object

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

object
Deprecated

결제 파라미터 데이터와 관련된 값입니다.

amount
number <float>

구매 금액입니다.

currency
string

구매 통화입니다. 통화의 3자리 정의가 ISO 4217에 따라 사용됩니다.

object
Deprecated

할인 프로모션 모드 또는 구매에 따른 보너스 정보(오브젝트).

hidden
boolean

결제 UI에 입력한 필드 프로모션 코드를 숨깁니다. 기본값은 false입니다.

value
string

프로모션 코드값.

object
Deprecated

구매 설명.

Array of objects
Array
description
string

구매 안의 아이템 묘사입니다.

image_url
string

아이템 코인용 링크입니다.

is_bonus
boolean

아이템이 무료이거나 보너스로 제공되는지 여부입니다. 기본값은 false입니다.

name
string

아이템 이름입니다.

object

물체에 아이템 가격이 있습니다.

amount
string

아이템 가격입니다.

amount_before_discount
string

할인 전 상품 가격.

quantity
integer

구매 안의 아이템의 양입니다.

value
string

지불 UI 및 이메일 영수증을 포함한 일반 구매 묘사입니다. 각 아이템을 개별적으로 넘기려면, purchase.description.items 배열의 파라미터를 사용하세요.

object
Deprecated

기프트에 대한 데이터를 포함하고 있는 객체입니다.

Array of objects

친구에 대한 데이터를 포함하고 있는 어레이.

Array
email
string

기프트 수령인 이메일.

id
string

기프트 수령인 ID.

name
string

기프트 수령인 별칭.

giver_id
string

제공자 ID.

hide_giver_from_receiver
string

수신자에서 제공자 ID를 숨길지 여부(기본값은 true).

message
string

제공자로부터 전송된 메시지.

object
Deprecated

게임 키.

Array of objects

게임 키.

Array
digital_content
string

판매자 계정으로 설정된 게임의 SKU입니다.

drm
string

게임을 배포하는데 사용되는 DRM 플랫폼으로서 steam, playstation, xbox, uplay, origin, drmfree, gog, epicgames, nintendo_eshop, discord_game_store 혹은 oculus가 될 수 있습니다. 게시자 계정에서 필요한 DRM을 구성했는지 확인하십시오. 이 매개변수가 토큰으로 전달되지 않는 경우 사용자가 결제 인터페이스에서 DRM을 선택할 수 있습니다.

Enum: "steam" "playstation" "xbox" "uplay" "origin" "drmfree" "gog" "epicgames" "nintendo_eshop" "discord_game_store" "oculus"
currency
string

모든 계산이 이루어지는 사항에 기반한, 구매에서 게임 키의 통화입니다.

object

업그레이드 데이터가 있는 객체입니다.

id
integer

업그레이드 ID.

id_user_history
integer

사용자 및 해당 패키지 데이터가 들어있는 입력 항목의 ID입니다.

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
Deprecated

게임머니 데이터와 관련된 값입니다.

currency
string

모든 계산이 이루어지는 사항에 기반한, 게임머니 통화 패키지의 통화입니다.

quantity
number <float>

게임머니 구매량입니다.

object
Deprecated

게임 아이템 구매 데이터와 관련된 값입니다.

currency
string

모든 계산이 이루어지는 사항에 기반한, 구매에서 가상 항목의 통화입니다.

Array of objects
Array
amount
integer

아이템 수량입니다.

available_groups
Array of strings

아이템 그룹 ID 관련 배열입니다. 지정된 그룹의 아이템만 결제 UI에 표시됩니다.

sku
string

아이템 ID입니다.

object

사용자 지정 프로젝트 설정와 관련된 객체입니다.

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

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인 경우, 로고가 헤더에 표시됩니다. 이미지를 업로드하려면 관리자 페이지에서 프로젝트를 열고 Pay Station > 설정 섹션으로 이동하십시오.

visible_name
boolean

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

visible_purchase
boolean

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

object
visible_virtual_currency_balance
boolean

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

is_independent_windows
boolean

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

is_prevent_external_link_open
boolean

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

license_url
string

EULA의 링크입니다.

object
object
is_visible
boolean

모바일 버전의 결제 UI에서 바닥글을 표시하거나 숨길지 여부입니다.

object
close_button
boolean

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

mode
string

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

size
string

결제 UI의 크기입니다. 이 매개 변수는 결제 UI의 필요한 크기에 따라 값이 다음과 같을 수 있습니다.

  • small: 결제 UI의 가능한 최소 크기입니다. 창 크기가 엄격히 제한되는 경우 이 값을 사용합니다. (크기: 620 x 630)
  • medium: 결제 UI의 권장 크기입니다. 이 값을 사용하여 라이트박스에 결제 UI를 표시합니다. (크기: 740 x 760)
  • large: 새 창 또는 탭에 결제 UI 표시를 위한 최적의 크기입니다. (크기: 820 x 840)
Enum: "small" "medium" "large"
theme
string

결제 UI의 모양 테마입니다. default (기본값) 또는 default_dark가 가능합니다.

Enum: "default" "default_dark"
object

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

object

내 계정 페이지입니다.

enable
boolean

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

order
integer

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

object

내 결제 계정 섹션입니다.

enable
boolean

결제 UI의 드롭다운 목록에 섹션을 표시할지 여부를 지정합니다. 기본값은 true입니다. 이 매개변수를 전달하지 않으면 섹션이 표시됩니다.

order
integer

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

object

구독 관리 섹션입니다.

enable
boolean

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

order
integer

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

version
string

장치 유형입니다. desktop (기본값) 또는 mobile이 가능합니다.

Enum: "desktop" "mobile"
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_legal가 true인 경우 오브젝트와 이에 해당하는 모든 매개변수는 필수입니다.

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 or null
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
{
  • "purchase": {
    },
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "token": "eop57k1boA7nnYPtewZ6KEXJyJADEwRT"
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.