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

ウォレットトランザクション一覧

ウォレットのトランザクション履歴には、Aptoide Connect 開発者コンソールを介して、またはこの API エンドポイントを通じてプログラムでアクセスできます。

エンドポイント​

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

認証​

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

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

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

ヘッダー​

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

クエリパラメータ​

パラメータ型必須説明
fromstring (YYYY-MM-DD)必須トランザクションを取得する期間の開始日。例: 2024-01-01。
tostring (YYYY-MM-DD)必須トランザクションを取得する期間の終了日。例: 2024-01-31。
limitnumber任意 (デフォルト: 50)レスポンスで返すレコードの最大数。
cursorstring任意ページネーション用のカーソル。前のレスポンスからデータの取得を続行する位置を示します。
packageNamestring任意アプリパッケージ名で結果をフィルタリングします。例: com.example.test。
countryCodestring任意ISO 3166-1 alpha-2 形式を使用して、国で結果をフィルタリングします。例: PT。
typestring任意トランザクションの種類で結果をフィルタリングします。可能な値: all、debit、credit。

レスポンス​

成功​

API 呼び出しが HTTP 200 ステータスコードを返した場合、リクエストは成功であり、トランザクションオブジェクトの配列が返されます。

レスポンスフィールド​

フィールド説明
dateトランザクションが行われた日付。
currencyトランザクションで使用された通貨。
fullAmount / grossAmountエンドユーザーが支払った金額。
netAmountgrossAmount からすべての控除 (税金など) を差し引いた後の金額。
amountお客様が受け取った金額。
statusトランザクションのステータス (例: Completed、Failed)。
typeトランザクションの種類 (例: IAP、RevertedIAP、RefundedIAP、Subscription、RevertedSubscription、RefundedSubscription、Withdraw、Fee、Sandbox)
extraData.countryトランザクションが発生した国。
extraData.applicationトランザクションが行われたアプリケーション。
extraData.sku購入されたアイテムの SKU。
extraData.revenueSharesnetAmount に適用された収益分配。
extraData.taxesgrossAmount に適用された税金ポリシーと金額。

レスポンス例​

{
  "count": 1557,
  "data": [
            {
            "amount": {
                "usd": 3.7425
            },
            "comment": "",
            "currency": "USD",
            "date": "2025-01-13 15:52:49",
            "destinationWalletAddress": "***",
            "extraData": {
                "country": {
                    "code": "IN"
                },
                "package": {
                    "iconUrl": "***",
                    "name": "***",
                    "title": "***"
                },
                "revenueShares": {
                    "percentages": {
                        "catappult": 0.1,
                        "developer": 0.75,
                        "partner": 0.15
                    },
                    "usd": {
                        "catappult": 0.499,
                        "developer": 3.7425,
                        "partner": 0.7485
                    }
                },
                "sku": "com.sword",
                "storeAccountUid": "***",
                "taxes": {
                    "vat": {
                        "policy": "None"
                    }
                }
            },
            "fee": {
                "usd": 0
            },
            "fullAmount": {
                "usd": 4.99
            },
            "grossAmount": {
                "usd": 4.99
            },
            "id": "***",
            "linkedTransactions": [],
            "netAmount": {
                "usd": "4.99"
            },
            "originalDate": "2025-01-13T15:52:49.084235",
            "paymentChannel": "Aptoide Wallet - Android",
            "paymentChannelVersion": "3.33.2",
            "paymentMethod": "Credit Card",
            "reference": "***d",
            "sourceWalletAddress": "***",
            "status": "Completed",
            "type": "IAP",
            "uid": "***"
        }
  ],
  "nextCursor": "MjAyNC0xMC0xMCAxNjowNDo0NC4xMzUxMjY="
}