# 取引履歴を取得する

指定した期間のトランザクションの成功とキャンセルに関する詳細情報のリストを返します。 
これに応じて、手数料、税金、注文、ユーザーに関するデータなど、支払いに関する情報を取得します。 
JSONまたはCSV形式でリストを取得できます。このAPIコールを使用して、財務照合を実行できます。


通知APIコールにproject_idパスパラメータが含まれていないため、会社の全プロジェクトで有効なAPIキーを使用して認可を設定する必要があります。

Endpoint: GET /merchants/{merchant_id}/reports/transactions/registry.{format}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    マーチャントID。

  - `format` (string, required)
    データ形式。
    Enum: "json", "csv", "xls"

## Query parameters:

  - `datetime_from` (string, required)
    期間の開始は YYYY-MM-DD （年月日）形式で表示されます。次のパラメータの少なくとも1つが渡された場合は必須ではありません：transfer_idreport_id
    Example: "2023-02-08"

  - `datetime_to` (string, required)
    期間の終了は YYYY-MM-DD （年月日）形式で表示されます。次のパラメータの少なくとも1つが渡された場合は必須ではありません：transfer_idreport_id datetime_fromとdatetime_toの差は92日を超えることはできません。
    Example: "2023-03-08"

  - `in_transfer_currency` (integer, required)
    すべての財務データをペイアウト通貨に変換します（デフォルトではペイイン通貨が使用されます）。次のパラメータの少なくとも1つが渡された場合は必須ではありません：transfer_idreport_id

  - `show_total` (boolean)
    トランザクションの合計金額をレポートに含めるかどうか。CSV形式でのみエクスポートできます。デフォルトではtrue。

  - `merchant_of_records` (string,null)
    マーチャントレコード。xsolla、merchantまたは指定しないことも可能です。merchantである場合は、パートナーのゲートウェイを介して行われたトランザクションを返します。xsollaである場合は、パートナーのゲートウェイを経由していないトランザクションを返します。指定されていない場合は、すべてのトランザクションを返します。
    Enum: "xsolla", "merchant"

  - `project_id` (integer)
    プロジェクトID。

  - `show_dry_run` (boolean)
    テストトランザクションを含めるかどうかを示します。

  - `transfer_id` (integer)
    配当ID。

  - `report_id` (integer)
    財務レポートID。

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

  - `limit` (integer)
    ページに表示されるトランザクションの数の制限。このパラメータが渡された場合、datetime_fromおよびdatetime_toパラメータを渡す必要はありません。

  - `status` (string)
    トランザクションステータス。
    Enum: "done", "canceled", "error", "refunded"

## Response 200 fields (application/json):

  - `payment_details` (object)
    支払詳細。

  - `payment_details.chargebackPenalty` (object)

  - `payment_details.chargebackPenalty.amount` (number)

  - `payment_details.commission_agent` (object)

  - `payment_details.commission_agent.percent` (number)

  - `payment_details.commission_agent_fixed` (integer)

  - `payment_details.commission_ps` (object)

  - `payment_details.commission_ps.fixed_amount` (integer)

  - `payment_details.commission_ps_from_vat` (object)

  - `payment_details.commission_user` (object)

  - `payment_details.commission_xsolla` (object)

  - `payment_details.cpa_network_commission` (object)

  - `payment_details.direct_wht` (object)

  - `payment_details.payment` (object)

  - `payment_details.payment.amount_from_ps` (integer)

  - `payment_details.payment.currency` (string)

  - `payment_details.payout` (object)

  - `payment_details.payout.fx_rate` (number)

  - `payment_details.refundPenalty` (object)

  - `payment_details.repatriation_costs` (object)

  - `payment_details.sales_tax` (object)

  - `payment_details.vat` (object)

  - `payment_details.vat.user_amount` (integer)

  - `payment_details.vat.user_percent` (integer)

  - `purchase` (object)
    購入内容。

  - `purchase.friend` (object)

  - `purchase.friend.email` (string,null)

  - `purchase.friend.user_id` (string,null)

  - `purchase.items_amount` (integer)

  - `purchase.pin_codes` (object)

  - `purchase.pin_codes.content` (string,null)

  - `purchase.purchase_amount` (number)

  - `purchase.simple_checkout` (object)

  - `purchase.subscription` (object)

  - `purchase.subscription.name` (string,null)

  - `purchase.subscription.plan_id` (integer,null)

  - `purchase.subscription.product_id` (string,null)

  - `purchase.subscription.product_name` (string,null)

  - `purchase.subscription.subscription_id` (integer,null)

  - `purchase.virtual_currency` (object)

  - `purchase.virtual_currency_amount` (integer)

  - `purchase.virtual_items` (object)

  - `transaction` (object)
    取引データ。

  - `transaction.custom_parameters` (object,null)

  - `transaction.direct_account` (integer)

  - `transaction.dry_run` (integer)

  - `transaction.external_id` (string,null)

  - `transaction.id` (integer)

  - `transaction.payment_method` (object)

  - `transaction.payment_method.class` (string)

  - `transaction.project` (object)

  - `transaction.refund_reason` (string,null)

  - `transaction.refund_reason_comment` (string,null)

  - `transaction.status` (string)
    Enum: "created", "processing", "done", "canceled", "error", "refunded", "partiallyRefunded", "awaitingRefund", "disputeFee"

  - `transaction.transfer_date` (string)

  - `user` (object)
    ユーザー詳細。

  - `user.country` (string)
    ユーザーの国。2文字の国コード（大文字）は、[ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)に従って使用されます。

  - `user.custom` (string,null)

  - `user.email` (string)
    ユーザーのEメール。

  - `user.id` (string)
    ユーザーID。

  - `user.ip` (string)

  - `user.marketplace` (string)

  - `user.name` (string)
    ユーザーのスクリーン名。

  - `user.phone` (string,null)
    ユーザーの電話番号。

  - `user_balance` (object)
    ユーザ残高。

  - `user_balance.payment_currency` (object)
    優先決済通貨。

  - `user_balance.payment_currency.deduction_amount` (number)

  - `user_balance.payment_currency.payout_amount_from_balance` (number)

  - `user_balance.payment_currency.purchase_amount_from_balance` (number)