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

저장한 계정으로 청구Server-side

post/projects/{project_id}/users/{user_id}/payments/{type}/{account_id}

저장된 결제 계정을 사용하여 청구합니다.

참고

샌드박스 모드에서는 3D 보안 기능이 없는 테스트 카드에서만 이 API 호출이 작동합니다.

주의

API 호출이 올바르게 작동되게 하려면 시간제한을 2분으로 구성하세요.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

프로젝트 ID.

user_id
required
string

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

type
required
string

결제 계정 유형.

Enum: Description
alipayplus_boost

Boost.

alipayplus_cn

Alipay.

alipayplus_dana

DANA.

alipayplus_gcash

GCash.

alipayplus_hk

Alipay(홍콩).

alipayplus_rabbitlinepay

Rabbit LINE 페이.

alipayplus_tng

Touch 'n Go.

alipayplus_truemoney

TrueMoney 지갑.

amazon

Amazon 페이.

card

은행 카드.

klarna

Klarna. 결제 계정 적립은 미국, 영국, 스웨덴, 독일, 오스트리아, 노르웨이, 핀란드, 덴마크, 네덜란드 국가에서만 가능합니다.

paypal

PayPal.

paysafecard_eu

Paysafecard(유럽 연합).

paysafecard_us

Paysafecard(미국).

skrill

Skrill 디지털 지갑.

softbank_paypay

PayPay.

toss

Toss 지갑.

account_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

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

amount
number <float>

구매 금액입니다.

currency
string

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

object <= 4000 characters
value
string
object

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

quantity
number <float>

게임머니 구매량입니다.

object

구매 설정에 대한 데이터가 포함된 개체입니다.

currency
string

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

external_id
string

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

mock_code
integer

샌드박스 모드에서 PayPal로 결제하는 프로세스를 테스트할 때 재현하려는 오류 코드입니다. "mode":"sandbox" 매개변수를 전달하는 경우에만 올바르게 작동합니다.

Enum: 1057 1015 3006 1801 1803 1039 3031 1203 3006 1201 1002 1089 2031 1046 5004
mode
string

결제 프로세스를 테스트하기 위한 sandbox 값을 설정합니다. 실제 결제의 경우 이 매개 변수는 제거되어야 합니다.

object

사용자 세부 정보.

ip
required
string

사용자 IP입니다.

object

법인 세부 정보가 있는 오브젝트.

address
string

법인 전체 주소.

country
string

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

name
string

법인 전체 이름.

vat_id
string

개별 납세자 식별자.

name
string

사용자 이름.

Responses
201

Created.

422

Unprocessable Entity.

Request samples
application/json
{
  • "purchase": {
    },
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "transaction_id": 123458390
}