查询交易记录-分页

简要描述

用于查询卡片的交易记录，支持分页查询。

第一次查询时不传 pageToken
查询返回后，如果返回了 nextPageToken、prevPageToken，可根据这些 token 翻页再次查询

请求URL

${baseUrl}/op/card/E/transaction/page

请求方式

方法：POST
Content-Type: application/json

请求参数

参数名	必选	类型	说明
cardNumber	是	string	卡号
pageToken	否	string	页码 token，第一次不传，翻页时使用返回的 token
pageSize	是	string	每页条数
dateRangeFrom	否	string	起始时间，格式 yyyy-MM-dd
dateRangeTo	否	string	结束时间，格式 yyyy-MM-dd

返回示例

{
    "data": {
        "nextPageToken": "eyJpZCI6IjZhNTExYmRiLTU0NmItNGM4Mi1iOGI0LWY5Yzc1NGJlMmI4OSIsInBhZ2VTaXplIjozLCJjdXJyZW50IjoyLCJkaXJlY3Rpb24iOiJuZXh0In0=",
        "prevPageToken": "",
        "transactions": [
            {
                "amount": "2",
                "cardAccountId": "938b56b2-3437-4295-8393-b5e407504c39",
                "cardEmbossedName": "",
                "cardId": "",
                "cardLast4": "",
                "createdAt": "2024-04-17 14:23:00",
                "currency": "HKD",
                "description": "增值",
                "entryType": "DEBIT",
                "id": "885d2247-27a8-4405-9db6-e5031d44e6fc",
                "intent": "transfer",
                "merchant": "{\"country\":\"\",\"name\":\"\",\"mcc\":\"\",\"category\":\"\"}",
                "refId": "CT156Z3CV6",
                "status": "posted",
                "xid": "accttrans_1780482111940837376"
            },
            {
                "amount": "22",
                "cardAccountId": "938b56b2-3437-4295-8393-b5e407504c39",
                "cardEmbossedName": "",
                "cardId": "",
                "cardLast4": "",
                "createdAt": "2024-03-19 18:56:38",
                "currency": "HKD",
                "description": "test",
                "entryType": "DEBIT",
                "id": "942a75ad-acf2-4718-b7ce-3b46a71f3804",
                "intent": "transfer",
                "merchant": "{\"country\":\"\",\"name\":\"\",\"mcc\":\"\",\"category\":\"\"}",
                "refId": "CTB7R765KX",
                "status": "posted",
                "xid": "accttranstest_1770039366362087424"
            },
            {
                "amount": "11",
                "cardAccountId": "938b56b2-3437-4295-8393-b5e407504c39",
                "cardEmbossedName": "",
                "cardId": "",
                "cardLast4": "",
                "createdAt": "2024-03-19 16:09:07",
                "currency": "HKD",
                "description": "test20240319",
                "entryType": "DEBIT",
                "id": "6a511bdb-546b-4c82-b8b4-f9c754be2b89",
                "intent": "transfer",
                "merchant": "{\"country\":\"\",\"name\":\"\",\"mcc\":\"\",\"category\":\"\"}",
                "refId": "CTJ4NT62GR",
                "status": "posted",
                "xid": "accttrans_1769997341692542976"
            }
        ]
    },
    "msg": "操作成功",
    "status": 200,
    "success": true
}

返回参数说明

参数名	示例	说明	类型
data	见下表	响应数据	object
msg	操作成功	响应消息	string
status	200	响应码	int
success	true	是否成功，true为成功，false为失败	bool

data - 分页数据

参数名	示例	说明
nextPageToken	dhd2e293jei3hr32he839jdi3nd30-skj	下一页token
prevPageToken	dhd2e293jei3hr32he839jdi3nd30	上一页token
transactions	Array	交易记录列表

transactions - 交易信息

参数名	示例	说明
amount	23434	金额
cardAccountId	17c17176-7bfe-4c1e-8bb4-b51f0524d76a	卡账户ID
cardEmbossedName	HUIB	卡个性名
cardId	17c17176-7bfe-4c1e-8bb4-b51f0	卡ID
cardLast4	8922	卡号后4位
createdAt	2023-02-26T22:23:26.103Z	交易创建日期
currency	HKD	币种
description	TOP UP	描述
entryType	CREDIT	类型，CREDIT入账，DEBIT出账
intent	topup	交易类型：charge收费、refund退款、topup/transfer充值、repay偿还、cashback现金返还、interest利息、fee费用、other其他
status	posted	交易状态：pending待处理，posted已完成，declined已拒绝，void已取消

说明：

如果交易状态为 posted（Cleared），原交易记录状态保持不变，退款会新增一条交易记录。

如果交易状态为 pending（Locked），该记录会变为 void，并退还额度给客户，不会再有一条退款（Refund）记录。

Keyboard shortcuts

api