Skip to main content
擷取一張或多張虛擬卡的交易，支援篩選與分頁。 使用 getVirtualCardTransactions 依卡片 ID、交易類型、日期區間或分頁選項查詢虛擬卡活動。
  • 提供 virtualCardIds 以擷取特定卡片的交易。
  • 省略 virtualCardIds 以擷取已驗證帳戶下所有卡片的交易。
必要範圍（scopes）： 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

  • 外匯（FX）欄位會一併回傳：要嘛全部有值，要嘛全部為 null。
  • originalCurrencyAmount 以最小計價單位回傳：
    • HKD 6300 = HK$63.00
    • JPY 100 = ¥100
    • KWD 1000 = 1.000 KD

​
Code Example: