メインコンテンツまでスキップ

ウォレットトランザクションレポート一覧(CSV)

事前生成された月次ウォレットトランザクションレポートには、Aptoide Connect デベロッパーコンソールを介して、またはこの API エンドポイントを通じてプログラムでアクセスできます。

各エントリは 1 つのレポートを表し、CSV ファイルのダウンロードに使用できる downloadUrl を含みます。

レポートは翌月の最初の数日間に生成されるため、直近の完全な月は、その月の終了後の数日後に利用可能になります。

エンドポイント​

メソッドURL
GEThttps://ws.catappult.io/api/wallet/transactions/csvs

認証​

この API にアクセスするには、API キーで認証する必要があります(生成方法はこちらを確認してください)。

⚠️
アカウントサブスクリプションが必要

Developer タイプのアカウントは、Aptoide Connect でアクティブなアカウントサブスクリプションが必要です。Distributor タイプのアカウントは、アクティブなサブスクリプションがなくてもこのエンドポイントにアクセスできます。

ヘッダー​

ヘッダー型必須説明
Api-Keystring必須API リクエストの認証に使用します。値は Aptoide Connect の API キーです。

レスポンス​

成功​

API 呼び出しが HTTP 200 ステータスコードを返した場合、リクエストは成功であり、利用可能なレポートオブジェクトの JSON 配列(それぞれにダウンロード URL を含む)を返します。

レスポンス例​

[
{
"startDate": "2026-06-01",
"endDate": "2026-06-30",
"downloadUrl": "https://.../wallet-transactions-2026-06.csv?...",
"generatedTimestamp": "2026-07-03 03:16:56"
}
]

CSV ファイル構造​

各レポートは、トランザクションごとに 1 行を持つ CSV ファイルで、以下の列を含みます。

列説明
dateトランザクションの日時(YYYY-MM-DD HH:mm:ss)。
from送信元ウォレットアドレス。
typeトランザクションタイプ(例: IAP、Subscription)。
paymentMethod使用された支払い方法(例: Google Pay、Credit Card)。
paymentChannel支払いチャネル(例: Aptoide Wallet - Android)。
paymentChannelVersion支払いチャネルのバージョン。
currencyトランザクション通貨(ISO 4217)。
grossAmount総額(トランザクション通貨)。
grossAmountUsd総額(USD)。
fullAmount請求された全額(トランザクション通貨、grossAmount に等しい)。
fullAmountUsd請求された全額(USD、grossAmountUsd に等しい)。
taxesPolicy適用された VAT ポリシー(例: Automatic)。
taxesPercentage適用された VAT の割合。
taxesCountryVAT に使用された国(ISO 3166-1 alpha-2)。
taxesAmountVAT 額(トランザクション通貨)。
taxesAmountUsdVAT 額(USD)。
netAmount純額(トランザクション通貨)。
netAmountUsd純額(USD)。
developerRevenueShareUsdデベロッパーのレベニューシェア(USD)。
partnerRevenueShareUsdパートナーのレベニューシェア(USD)。
catappultRevenueShareUsdAptoide(Catappult)のレベニューシェア(USD)。
amountトランザクション額(トランザクション通貨)。
amountUsdトランザクション額(USD)。
feeUsd手数料(USD)。
statusトランザクションステータス(例: Completed)。
transferIdトランザクション識別子(ブロックチェーンの転送ハッシュ)。
transferUid内部トランザクション UID。
packageNameアプリのパッケージ名。
packageTitleアプリの表示タイトル。
packageOperatingSystemオペレーティングシステム(Android / iOS)。
sku購入された商品の SKU。
country購入者の国(ISO 3166-1 alpha-2)。
referenceトランザクションのリファレンス。
comment自由記述のコメント。
linkedTransactionId関連するトランザクションの識別子(例: 返金の元トランザクション)。
partnerOemIdパートナー OEM 識別子。Advertiser アカウントの場合にのみ存在します。