저장한 계정으로 청구

저장한 계정으로 청구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

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

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

사용자 세부 정보.

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

{"card": {"cvn": "123"
},
"purchase": {"description": {"value": "currency purchase"
},
"virtual_currency": {"quantity": 100
}
},
"settings": {"currency": "USD",
"external_id": "ext123",
"save": true
},
"user": {"id": "user123",
"ip": "111.11.11.11",
"legal": {"address": "17 Crown Street London SW2 0JW United Kingdom",
"country": "GB",
"name": "My Awesome Company",
"vat_id": "GB111111111"
},
"name": "John Smith"
}
}

Response samples

application/json

{"transaction_id": 123458390
}