查询交易记录

简要描述

查询卡片的交易记录，查询时间跨度最大为3个月。

请求URL

POST ${baseUrl}/op/card/P/transaction
Content-Type: application/json

请求方式

方法：POST
Content-Type: application/json

请求参数

参数名	必选	类型	说明
cardNumber	是	string	卡ID
pageToken	是	string	页码（页数游标，可为空）
pageSize	是	string	每页数量
creationTimeFrom	是	string	起始时间，格式 yyyy-MM-dd
creationTimeTo	是	string	结束时间，格式 yyyy-MM-dd

返回示例

{
    "data": {
        "currentPage": 1,
        "pageSize": 2,
        "totalRecords": 1,
        "transactions": [
            {
                "amount": "10",
                "cardNumber": "5592922156696856",
                "currency": "USD",
                "debitOrCreditFlag": "D",
                "id": "ac4cef2d-8d1b-4ee9-a15e-b751ebaefad0",
                "status": "Closed",
                "transactionTime": "2024-11-29T02:24:14.578Z",
                "type": "TopUp"
            }
        ]
    },
    "msg": "操作成功",
    "status": 200,
    "success": true
}

返回参数说明

参数名称	示例	参数说明	类型
data	-	响应数据，见下表	object
msg	操作成功	响应消息	string
status	200	响应码	int
success	true	是否成功（true为成功）	boolean

data 字段说明（交易记录信息）

参数名称	示例	参数说明
id	ac4cef2d-8d1b-4ee9-a15e-b751ebaefad0	交易号
cardNumber	4383570038788189	卡ID
debitOrCreditFlag	D	D：扣账(减少)，C：记账(增加)
transactionTime	2024-11-29T02:24:14.578Z	交易发生时间
currency	CNY	交易币种
amount	38.48	交易币种金额
type	TopUp	交易类型
status	APPROVED	状态
detail	WEIXIN*huidi 5210747029 CN	交易详情

type 字段枚举值说明

值	描述
Consumption	消费
TopUp	增值
Fee	消费手续费
Credit	退款
Reversal	冲正
DeleteCard	注销卡

status 字段枚举值说明

值	描述
Approve	审批完成
Pending	待处理
Fail	失败

Keyboard shortcuts

api