卡片交易列表

返回 單張虛擬卡的交易明細，支援分頁，篩選條件與 交易列表 相同。唯一區別：card_id 為 必填，且結果限定於該單張卡。

• card_id 必須屬於你的賬號且為 虛擬卡，否則返回 404 / 400。
• 採用與 交易列表 相同的嚴格脫敏和相同的響應結構。

端點

項	值
Method	POST
Path	/api/v1/openapi/card/transactions/list
鑑權	HMAC
冪等鍵	不需要

請求欄位

欄位	型別	必填	說明
card_id	string	✅	card_<id> —— 要查詢的卡（必須是你的虛擬卡）
transaction_time_from	string	可選	範圍起點，YYYY-MM-DD HH:MM:SS
transaction_time_to	string	可選	範圍終點，YYYY-MM-DD HH:MM:SS
type	string	可選	型別篩選 —— PURCHASE / AUTHORIZATION / REFUND / REVERSAL / TOPUP / WITHDRAW / FEE
status	string	可選	PENDING / APPROVED / FAILED / REVERSED
amount_from	string	可選	金額下限，如 "10.00"
amount_to	string	可選	金額上限，如 "1000.00"
merchant_name	string	可選	商戶名稱（模糊）
keyword	string	可選	自由文本關鍵詞（模糊）
page	int	可選	頁碼（預設 1）
page_size	int	可選	每頁數量（預設 20，最大 100）

請求示例

{
  "card_id": "card_12345",
  "type": "PURCHASE",
  "page": 1,
  "page_size": 50
}

響應

與 交易列表 完全相同 —— 一個分頁信封，其 list 項為交易物件。完整欄位表、type 取值、分類以及示例負載請見該頁面。返回的每一行都歸屬於所請求的 card_id。

常見錯誤

HTTP	message_key	說明
400	openapi_invalid_card_id	card_id 缺失或非法（此處必填）
400	openapi_card_type_not_supported	card_id 不是虛擬卡
400	invalid_date_format	transaction_time_from/to 不符合 YYYY-MM-DD HH:MM:SS
400	invalid_params	金額格式錯誤
401	openapi_invalid_credentials	鑑權失敗
404	card_not_found	卡不存在 / 不屬於當前賬號
500	openapi_list_transactions_failed	服務端異常

說明

• 本介面是針對常見"檢視某張卡歷史"場景的便捷封裝；功能上等價於設定了 card_id 的 交易列表。選用在你的整合中更清晰的那個即可。
• 資料來自 Coinepay 的本地賬本；不會同步呼叫提供商。