저장한 계정으로 청구

저장한 계정으로 청구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_maya	Maya.
alipayplus_rabbitlinepay	Rabbit LINE 페이.
alipayplus_tng	Touch 'n Go.
alipayplus_truemoney	TrueMoney 지갑.
amazon	Amazon 페이.
card	은행 카드.
klarna	Klarna. 결제 계정 적립은 미국, 영국, 스웨덴, 독일, 오스트리아, 노르웨이, 핀란드, 덴마크, 네덜란드 국가에서만 가능합니다.
mercadopago	Mercado Pago.
paypal	PayPal.
paysafecard_eu	Paysafecard(유럽 연합).
paysafecard_us	Paysafecard(미국).
skrill	Skrill 디지털 지갑.
softbank_au	au Easy Payment.
softbank_docomo	Docomo.
softbank_paypay	PayPay.
softbank_softbank2	SoftBank.
softbank_ymobile	Y!mobile.
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

사용자 세부 정보.

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": {"description": {"value": "currency purchase"
},
"virtual_currency": {"quantity": 100
}
},
"settings": {"currency": "USD",
"external_id": "ext123",
"mode": "sandbox"
},
"user": {"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
}