Xsolla-logo

保存されたアカウントで課金する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_rabbitlinepay

Rabbit LINE Pay(ラビットラインペイ)。

alipayplus_tng

Touch 'n Go。

alipayplus_truemoney

TrueMoney ウォレット。

amazon

アマゾンペイ。

card

銀行カード。

klarna

Klarna。決済アカウントの保存は米国、英国、スウェーデン、ドイツ、オーストリア、ノルウェー、フィンランド、デンマーク、オランダでのみ利用可能です。

paypal

PayPal(ペイパル)。

paysafecard_eu

Paysafecard(欧州連合)。

paysafecard_us

Paysafecard(アメリカ)。

skrill

Skrill Digital Wallet。

softbank_paypay

PayPay。

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

プレイヤーが対人戦に参加するかどうかを示します。

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

ユーザー詳細。

ip
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": {
    },
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "transaction_id": 123458390
}