查询交易记录

简要描述

用于查询交易记录。
在每日24点前的充值记录，会在次日7点生成账单。

更新记录

更新日期	更新内容
2024-10-16	增加返回 `debitOrCreditFlag` 字段
2024-10-16	`transactionSource` 字典值更新
2025-03-26	查询条件增加 `isAuthorization`：如果 `isAuthorization=false`，展示未结算流水；如为 `true`，展示已结算流水。客户消费的订单初始会在 `false` 列表，结算后进入 `true` 列表。

请求URL

${baseUrl}/op/card/H/transactions

请求方式

方法：POST
Content-Type：application/json

请求参数

参数名	必选	类型	说明
cardNumber	是	string	卡号
offset	是	string	偏移量，从0开始，例如0/10/20
pageSize	是	string	数量
isAuthorization	否	int	0：未结算订单，1：已结算订单
creationTimeFrom	是	string	起始时间，格式 yyyy-MM-dd
creationTimeTo	是	string	结束时间，格式 yyyy-MM-dd

返回示例

{
  "data": [
    {
      "amount": 10,
      "creationTime": "2024-07-17T23:00:20.609Z",
      "currency": "HKD",
      "isATM": false,
      "isAuthorization": false,
      "isInCountry": true,
      "isOnline": false,
      "isPos": false,
      "memo": "Repayment for order r-2342342422342343 (501)",
      "reversal": false,
      "settlementDate": "2024-07-18T00:00:00Z",
      "transactionId": 1000001081427,
      "transactionSource": "6",
      "transactionType": "5",
      "txCompleted": true,
      "acquirerCurrency": "",
      "acquirerAmount": 0,
      "cardAcceptorName": ""
    },
    {
      "amount": 11,
      "creationTime": "2024-07-18T23:00:43.07Z",
      "currency": "HKD",
      "isATM": false,
      "isAuthorization": false,
      "isInCountry": true,
      "isOnline": false,
      "isPos": false,
      "memo": "Repayment for order r-240718180106121536 (501)",
      "reversal": false,
      "settlementDate": "2024-07-19T00:00:00Z",
      "transactionId": 1000001081883,
      "transactionSource": "6",
      "transactionType": "5",
      "txCompleted": true,
      "acquirerCurrency": "HKD",
      "acquirerAmount": 235,
      "cardAcceptorName": "AlipayHK*ALIPAY"
    }
  ],
  "msg": "操作成功",
  "status": 200,
  "success": true
}

返回参数说明

参数名称	示例	参数说明	schema
data	jsonArray	响应数据，见下表	交易记录
msg	操作成功	响应消息	string
status	200	响应码	int
success	true	是否成功：成功true，失败false	boolean

data - 交易记录字段说明

参数名称	示例	参数说明
amount	23434	金额
creationTime	2024-07-17T23:00:20.609Z	交易创建时间
settlementDate	2024-07-17T23:00:20.609Z	结算时间
currency	HKD	币种
acquirerCurrency	USD	请求币种
acquirerAmount	23.1	请求金额
cardAcceptorName	order r-2342342422342343	授权商户信息
isATM	false	是否ATM取现
isAuthorization	false	是否授权：true时amount金额为0，acquirerAmount为实际授权金额，结算后amount才会有值
isInCountry	false	是否本地国家
isOnline	false	是否线上
isPos	false	是否POS
memo	Repayment for order r-2342342422342343 (501)	交易信息
transactionId	1000001081427	交易单号
debitOrCreditFlag	D	D -> 扣账(减少) C -> 记账（增加）
transactionSource	6	交易来源，见下方字典
transactionType	5	交易类型，见下方字典
txCompleted	true	是否完成，完成后，amount一开始为0的记录会生成实际结算金额

字典说明

transactionType - 交易类型字典

值	说明	描述
0	unknown
1	newAccount	新建账户。
2	cardSale	新卡开卡。
3	purchase	POS消费或线上消费，或移动端消费。
4	refund	退款至卡或钱包。
5	account funding	TopUp 通过POS向钱包充值，币种支持与否均可。
6	withdraw	通过POS或ATM取款，或无需卡的银行转账操作等。
7	balanceInquiry	余额查询。
8	p2p	点对点转账。
9	walletTransfer	钱包之间转账。
10	exchange	货币兑换（买/卖方）。
11	exchangeMargin	不同币种间兑换差额。
12	secondPresentment	提交信息（如汇票等）。
13	chargeback	拒付处理。
14	adjustment	资金调整。
15	exchangeAdjustment	汇率调整。
16	maintenance	账户维护。
17	chargeoff	坏账核销。
18	withholding	优惠金/扣款保留。
19	closeAccount	账户关闭。
20	reward	奖励发放。
21	shipping	卡片发货（标准快递）。
22	expeditedShipping	卡片加急快递。
23	addressing	注册FPS快速支付ID。
24	settlement	结算。
25	consolidated	账户合并。
26	interest	利息发放。
27	cashback	返现。
28	fee	扣费。
29	monthly fee	月费。
30	annual fee	年费。
31	fastFund	Visa即时到账。
32	loadReversal	充值撤销。
33	expiry	过期资金返还至最初出资方。
34	moneyReceive	Mastercard快速到账。
35	latePaymentFee	逾期付款手续费。

transactionSource - 交易来源字典

值	说明
0	Unknown
1	InWalletPOS
2	OutOfWalletPOS
3	InWalletATM
4	OutOfWalletATM
5	Online
6	Partner = TopUp
7	Customer
8	Internal
9	Static
10	MobileCommerce
11	OnUs
12	OutOfWalletOnline

Keyboard shortcuts

api