Skip to main content
检索一个或多个虚拟卡的交易，支持筛选和分页。 使用 getVirtualCardTransactions 按卡片 ID、交易类型、日期范围或分页选项查询虚拟卡活动。
  • 提供 virtualCardIds 以获取特定卡片的交易。
  • 省略 virtualCardIds 以获取已认证账户下所有卡片的交易。
必需的权限范围： REVEAL_VIRTUALCARD

​
Arguments

​
input — GetVirtualCardTransactionsInput

​
Filters

​
Pagination

默认值：
  • 当省略 virtualCardIds 且未指定 limit 时，默认 limit 为 100。
  • 当提供 virtualCardIds 且未指定 limit 时，可能会返回每张卡片的所有匹配交易。我们建议指定 limit 以控制响应大小。
行为：
  • 当提供 virtualCardIds 时，limit 和 offset 按“每张卡片”生效。
  • 当省略 virtualCardIds 时，limit 和 offset 按“已认证账户（所有卡片汇总）”生效。
注意： 对多个卡片请求且设置较高 limit 可能导致响应体很大。

​
Validation Errors

以下输入会在执行前被拒绝：
  • dateRangeStart 和 dateRangeEnd 必须一起提供。
  • dateRangeEnd 必须大于或等于 dateRangeStart。
  • 二者都必须是有效的 ISO 8601 时间戳。
  • paginate.limit 不得超过 500。
  • 提供 virtualCardIds 时，其内容必须是 1 到 10 个有效的 UUID。

​
Example: Specific cards

​
Example: All cards (date range)

当你不确定在某个时间段内哪些卡片有活动时使用此示例。

​
cURL Example

​
Response Fields

  • virtualCardId (UUID) — 与返回交易关联的虚拟卡。
  • transactions ([VirtualCardTransaction!]) — 该虚拟卡的交易列表。
  • transactionDate (String) — 交易发生的日期和时间，ISO 8601 格式。
  • transactionType (String) — 交易类型，如 PURCHASE、REFUND 或 DECLINE。
  • transactionAmount (Float) — 以 USD 计价的交易金额。可能为 null。
  • transactionStatus (String) — 生命周期状态，如 CLEARED 或 PROCESSING。
  • transactionApproval (String) — 交易的审批状态。
  • transactionResponseCode (String) — 卡组织响应码。
  • merchantName (String) — 商户名称（如可用）。可能为 null。
  • paymentMethod (String) — 交易所用的支付方式。
  • mcc (Int) — 商户类别码。可能为 null。
  • merchantCountryCode (String) — 商户国家代码。可能为 null。
  • originalCurrencyCode (String) — 原始交易的 ISO 4217 货币代码（例如 USD、HKD、EUR）。当原始货币未知或不适用时可能为 null。
  • originalCurrencyAmount (Float) — 按该货币最小单位计的原始金额。例如，HKD 的 6300 表示 HK$63.00。
  • currencyConversionRate (Float) — 用于将原始货币兑换为 USD 的外汇汇率。USD 交易为 1.0。

​
Notes

  • 外汇相关字段同时返回，要么全部有值，要么全部为 null。
  • originalCurrencyAmount 以最小单位返回：
    • HKD 6300 = HK$63.00
    • JPY 100 = ¥100
    • KWD 1000 = 1.000 KD

​
Code Example: