钱包交易记录列表

您可以通过 Aptoide Connect 开发者控制台或以编程方式通过此 API 端点访问您的钱包交易历史记录。

端点

方法	URL
GET	https://ws.catappult.io/api/wallet/transactions

身份验证

要访问此 API，您需要使用 API 密钥进行身份验证（请查看此处了解如何生成密钥）。

⚠️

需要帐户订阅

Developer 类型的帐户需要在 Aptoide Connect 上拥有有效的帐户订阅。Distributor 类型的帐户无需有效订阅即可访问此端点。

请求头

请求头	类型	是否必需	说明
Api-Key	string	必需	用于对您的 API 请求进行身份验证。该值是您的 Aptoide Connect API 密钥。

查询参数

参数	类型	是否必需	说明
from	string (YYYY-MM-DD)	必需	检索交易的时间范围的开始日期。示例：2024-01-01。
to	string (YYYY-MM-DD)	必需	检索交易的时间范围的结束日期。示例：2024-01-31。
limit	number	可选（默认：50）	响应中返回的最大记录数。
cursor	string	可选	用于分页的游标，指示从上一个响应继续获取数据的位置。
packageName	string	可选	按应用包名筛选结果。示例：com.example.test。
countryCode	string	可选	使用 ISO 3166-1 alpha-2 格式按国家/地区筛选结果。示例：PT。
type	string	可选	按交易类型筛选结果。可能的值：all、debit、credit。

响应

成功

如果 API 调用返回 HTTP 200 状态代码，则请求成功，并返回一个交易对象数组。

响应字段

字段	说明
date	交易发生的日期。
currency	交易中使用的货币。
fullAmount / grossAmount	最终用户支付的金额。
netAmount	从 grossAmount 中减去所有扣除项（例如税费）后的金额。
amount	您收到的金额。
status	交易的状态（例如 Completed、Failed）。
type	交易类型（例如 IAP、RevertedIAP、RefundedIAP、Subscription、RevertedSubscription、RefundedSubscription、Withdraw、Fee、Sandbox）
extraData.country	交易发生的国家/地区。
extraData.application	交易所在的应用程序。
extraData.sku	所购买商品的 SKU。
extraData.revenueShares	应用于 netAmount 的收入分成。
extraData.taxes	应用于 grossAmount 的税费政策和金额。

响应示例

{
  "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="
}