Xsolla-logo

トランザクションを検索する

get/merchants/{merchant_id}/reports/transactions/search.{format}

特定の検索パラメータに基づいてトランザクションのリストを取得します。リクエスト実行後、5～10分程度でJSON、CSV、XLS形式のリストを取得することができます。

SecuritybasicAuth
Request
path Parameters
merchant_id
required
integer

マーチャントID。

format
required
string

データ形式。

Enum: "json" "csv" "xls"
query Parameters
datetime_from
string <datetime>

期間開始日。

datetime_to
string <datetime>

期間終了日。

project_id
integer

プロジェクトID。

transaction_id
integer

トランザクションID。

type
string

検索結果に表示される取引のタイプ：

Enum: Description
all

全ての取引。

canceled

テスト取引を除く、キャンセルされた取引。

test

取引をテストします。

transferred

テスト取引を除く、成功した取引。

phone
string

ユーザーの電話番号（国際形式）。

user_id
string

ユーザーID。

user_name
string

ユーザー名。

user_custom
string

ユーザー識別のためのカスタムパラメータ。

email
string <= 100 characters

ユーザーのEメール。

external_id
string

ゲーム内のトランザクションID。各ユーザーの支払いに対して一意でなければならなりません。

offset
integer

リスト生成元のエレメントの番号です（カウントは0から始まります）。

limit
integer

ページにあるエレメント数の制限。

status
string

トランザクションステータス。

Enum: Description
awaitingRefund

この取引は返金の決定待ちです。ユーザーが返金をリクエストした後、エクソーラカスタマーサポートはリクエストを手動で処理し、返金に関する決定を行います。

canceled

次の2つのシナリオがありれます：

  • 取引は決済システム側でキャンセルされました。例えば、ユーザーアカウントの資金が不足しているとします。
  • 支払いはユーザーに払い戻されました。
created

ユーザーがトランザクションを開始しましたが、まだ処理されていません。

done

トランザクションは正常に処理されました。

error

トランザクションの処理中にエラーが発生しました。このような支払いは、エクソーラカスタマーサポートにお問い合わせいただくことで返金できます。

partiallyRefunded

ユーザーは一部返金を受けました。

processing

トランザクションは処理中です。

refunded

ユーザーのXsolla残高に返金されました。

review

トランザクション処理は不正防止システムによって停止されており、現在追加の検証中です。

Responses
200

OK。

Request samples 
Response samples 
application/json
[
  • {
    }
]