# 저장한 계정으로 청구

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


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





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

Endpoint: POST /projects/{project_id}/users/{user_id}/payments/{type}/{account_id}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    프로젝트 ID.

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

  - `type` (string, required)
    결제 계정 유형.
    Enum: "card", "ais", "alipayplus_boost", "alipayplus_cn", "alipayplus_dana", "alipayplus_gcash", "alipayplus_hk", "alipayplus_kplus", "alipayplus_maya", "alipayplus_rabbitlinepay", "alipayplus_tng", "alipayplus_truemoney", "amazon", "klarna", "mercadopago", "nupay", "paidy", "paypal", "paysafecard_eu", "paysafecard_us", "skrill", "softbank_au", "softbank_docomo", "softbank_paypay", "softbank_softbank2", "softbank_ymobile", "toss"

  - `account_id` (integer, required)
    엑솔라 시스템에 저장된 계정의 ID입니다.

## Request fields (application/json):

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

  - `custom_parameters.active_date` (string)
    [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 마지막 확인 날짜.

  - `custom_parameters.additional_verification` (boolean)
    플레이어가 계정 확인 절차를 사용하고 있는지 여부.

  - `custom_parameters.character_customized` (boolean)
    플레이어가 자신의 캐릭터를 맞춤 설정했는지 여부.

  - `custom_parameters.chat_activity` (boolean)
    플레이어의 채팅 기능 사용 여부.

  - `custom_parameters.completed_tasks` (integer)
    완료한 임무/목표의 수.

  - `custom_parameters.forum_activity` (boolean)
    플레이어의 포럼 기능 사용 여부.

  - `custom_parameters.items_used` (boolean)
    플레이어가 구매한 인게임 아이템을 사용하고 있는지 여부.

  - `custom_parameters.karma_points` (integer)
    플레이어의 카르마.

  - `custom_parameters.last_change_password_date` (string)
    [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 마지막 암호 변경 날짜.

  - `custom_parameters.non_premium_currency` (number)
    프리미엄이 아닌 통화의 금액.

  - `custom_parameters.notifications_enabled` (boolean)
    플레이어가 알림을 활성화했는지 여부.

  - `custom_parameters.profile_completed` (boolean)
    플레이어가 프로필에 추가 정보를 추가했는지 여부.

  - `custom_parameters.profile_image_added` (boolean)
    플레이어가 프로필 이미지를 업로드했는지 여부.

  - `custom_parameters.pvp_activity` (boolean)
    플레이어가 PvP(플레이어 대 플레이어) 전투에 참여하고 있는지 여부.

  - `custom_parameters.registration_date` (string)
    [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 계정 생성일.

  - `custom_parameters.session_time` (string)
    [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 평균 세션 시간.

  - `custom_parameters.social_networks_added` (boolean)
    플레이어가 소셜 미디어 프로필을 연결했는지 여부.

  - `custom_parameters.total_bans` (integer)
    플레이어가 채팅/포럼에서 금지된 횟수.

  - `custom_parameters.total_characters` (integer)
    인게임 캐릭터 수.

  - `custom_parameters.total_clans` (integer)
    플레이어가 가입한 클랜의 수.

  - `custom_parameters.total_friends` (integer)
    친구의 수.

  - `custom_parameters.total_game_events` (integer)
    플레이어가 참여했던 인게임 이벤트의 수.

  - `custom_parameters.total_gifts` (integer)
    플레이어가 전송/수신한 인게임 선물의 수.

  - `custom_parameters.total_hours` (integer)
    총 인게임 시간.

  - `custom_parameters.total_inventory_value` (number)
    인벤토리의 총 가치(인게임 통화).

  - `custom_parameters.total_sum` (number)
    총 결제 금액.

  - `custom_parameters.tutorial_completed` (boolean)
    플레이어가 게임 튜토리얼을 완료했는지 여부.

  - `custom_parameters.unlocked_achievements` (integer)
    잠금을 해제한 업적의 수.

  - `custom_parameters.user_level` (integer)
    플레이의 레벨, 명성 또는 순위.

  - `custom_parameters.win_rate` (integer)
    승률.

  - `purchase` (object)
    구매 데이터 관련 값입니다.

  - `purchase.checkout` (object)
    결제 파라미터 데이터와 관련된 값입니다.

  - `purchase.checkout.amount` (number)
    구매 금액입니다.

  - `purchase.checkout.currency` (string)
    구매 통화입니다. 통화의 3자리 정의가 [ISO 4217](https://developers.xsolla.com/ko/doc/pay-station/references/supported-currencies/)에 따라 사용됩니다.

  - `purchase.description` (object)

  - `purchase.description.value` (string)

  - `purchase.virtual_currency` (object)
    게임머니 데이터와 관련된 값입니다.

  - `purchase.virtual_currency.quantity` (number)
    게임머니 구매량입니다.

  - `settings` (object)
    구매 설정에 대한 데이터가 포함된 개체입니다.

  - `settings.currency` (string)
    선호하는 결제 통화입니다. 통화의 3자리 정의가 [ISO 4217](https://developers.xsolla.com/ko/doc/pay-station/references/supported-currencies/)에 따라 사용됩니다.

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

  - `settings.mock_code` (integer)
    샌드박스 모드에서 PayPal로 결제하는 프로세스를 테스트할 때 재현하려는 오류 코드입니다. "mode":"sandbox" 매개변수를 전달하는 경우에만 올바르게 작동합니다.
    Enum: 1002, 1015, 1039, 1046, 1057, 1089, 1201, 1203, 1801, 1803, 2031, 3006, 3031, 5004

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

  - `user` (object)
    사용자 세부 정보.

  - `user.ip` (string, required)
    사용자 IP입니다.

  - `user.legal` (object)
    법인 세부 정보가 있는 오브젝트.

  - `user.legal.address` (string)
    법인 전체 주소.

  - `user.legal.country` (string)
    기업이 속한 국가. [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)에 따른 2자로 된 대문자 국가 코드를 사용합니다.

  - `user.legal.name` (string)
    법인 전체 이름.

  - `user.legal.vat_id` (string)
    개별 납세자 식별자.

  - `user.name` (string)
    사용자 이름.

## Response 201 fields (application/json):

  - `transaction_id` (integer)


## Response 422 fields