# 保存されたアカウントで課金する

保存された決済アカウントを介してユーザーに請求する。


メモサンドボックスモードでは、このAPIコールは、3-Dセキュア機能を持たないテストカードでのみ機能します。





通知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", "amazon", "skrill", "paypal", "toss", "alipayplus_cn", "alipayplus_hk", "alipayplus_gcash", "alipayplus_dana", "alipayplus_rabbitlinepay", "alipayplus_tng", "alipayplus_boost", "alipayplus_truemoney", "alipayplus_maya", "alipayplus_kplus", "softbank_paypay", "softbank_docomo", "softbank_softbank2", "softbank_au", "softbank_ymobile", "paysafecard_eu", "paysafecard_us", "paidy", "klarna", "mercadopago", "nupay"

  - `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)
    購入通貨。[ISO 4217](https://developers.xsolla.com/ja/doc/pay-station/references/supported-currencies/)に準拠した3文字の通貨コード。

  - `purchase.description` (object)

  - `purchase.description.value` (string)

  - `purchase.virtual_currency` (object)
    仮想通貨の詳細を含むオブジェクト。

  - `purchase.virtual_currency.quantity` (number)
    仮想通貨での購入金額。

  - `settings` (object)
    購入設定（オブジェクト）。

  - `settings.currency` (string)
    標準の決済通貨。[ISO 4217](https://developers.xsolla.com/ja/doc/pay-station/references/supported-currencies/)3文字通貨コード。

  - `settings.external_id` (string)
    ゲーム内のトランザクションID。ユーザーの支払いごとに一意である必要があります。 詳細については、説明文書を参照してください。

  - `settings.mock_code` (integer)
    サンドボックスモードでPayPalによる支払い処理をテストする際に再現したいエラーコードです。パラメータに "mode":"sandbox" を渡した場合のみ、正しく動作します。
    Enum: 1057, 1015, 3006, 1801, 1803, 1039, 3031, 1203, 3006, 1201, 1002, 1089, 2031, 1046, 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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)に従って大文字2文字の国コードを使用します。

  - `user.legal.name` (string)
    法人のフルネームです。

  - `user.legal.vat_id` (string)
    納税者個別のID。

  - `user.name` (string)
    ユーザー名。

## Response 201 fields (application/json):

  - `transaction_id` (integer)


## Response 422 fields