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

Xsolla Developers

または

パブリッシャーアカウントへ

保存されたアカウントで課金するServer-side

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

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

メモ

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

通知

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 (Hong Kong)（アリペイ香港）。
alipayplus_maya	Maya。
alipayplus_rabbitlinepay	Rabbit LINE Pay（ラビットラインペイ）。
alipayplus_tng	Touch 'n Go。
alipayplus_truemoney	TrueMoney ウォレット。
amazon	アマゾンペイ。
card	銀行カード。
klarna	Klarna。決済アカウントの保存は米国、英国、スウェーデン、ドイツ、オーストリア、ノルウェー、フィンランド、デンマーク、オランダでのみ利用可能です。
mercadopago	Mercado Pago。
paypal	PayPal（ペイパル）。
paysafecard_eu	Paysafecard（欧州連合）。
paysafecard_us	Paysafecard（アメリカ）。
skrill	Skrill Digital Wallet。
softbank_au	auかんたん決済。
softbank_docomo	ドコモ。
softbank_paypay	PayPay。
softbank_softbank2	フトバンク。
softbank_ymobile	Y!mobile。
toss	Toss Wallet。

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 購入通貨。ISO 4217に準拠した3文字の通貨コード。

object <= 4000 characters

value

string

object

仮想通貨の詳細を含むオブジェクト。

quantity

number <float>

仮想通貨での購入金額。

object

購入設定（オブジェクト）。

currency	string 標準の決済通貨。ISO 42173文字通貨コード。
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に従って大文字2文字の国コードを使用します。
name	string 法人のフルネームです。
vat_id	string 納税者個別のID。

name

string

ユーザー名。

Responses

201

作成済み。

422

処理不可能なエンティティー。

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
}