ウォレットトランザクションレポート一覧(CSV)
事前生成された月次ウォレットトランザクションレポートには、Aptoide Connect デベロッパーコンソールを介して、またはこの API エンドポイントを通じてプログラムでアクセスできます。
各エントリは 1 つのレポートを表し、CSV ファイルのダウンロードに使用できる downloadUrl を含みます。
レポートは翌月の最初の数日間に生成されるため、直近の完全な月は、その月の終了後の数日後に利用可能になります。
エンドポイント
| メソッド | URL |
|---|---|
| GET | https://ws.catappult.io/api/wallet/transactions/csvs |
認証
この API にアクセスするには、API キーで認証する必要があります(生成方法はこちらを確認してください)。
⚠️
アカウントサブスクリプションが必要
Developer タイプのアカウントは、Aptoide Connect でアクティブなアカウントサブスクリプションが必要です。Distributor タイプのアカウントは、アクティブなサブスクリプションがなくてもこのエンドポイントにアクセスできます。
ヘッダー
| ヘッダー | 型 | 必須 | 説明 |
|---|---|---|---|
Api-Key | string | 必須 | 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 の割合。 |
taxesCountry | VAT に使用された国(ISO 3166-1 alpha-2)。 |
taxesAmount | VAT 額(トランザクション通貨)。 |
taxesAmountUsd | VAT 額(USD)。 |
netAmount | 純額(トランザクション通貨)。 |
netAmountUsd | 純額(USD)。 |
developerRevenueShareUsd | デベロッパーのレベニューシェア(USD)。 |
partnerRevenueShareUsd | パートナーのレベニューシェア(USD)。 |
catappultRevenueShareUsd | Aptoide(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 アカウントの場合にのみ存在します。 |