交易历史查询

GET
/openapi/v1/payments/transaction/history

查询账户的交易历史记录,支持分页查询。适用于对账和财务报表生成。

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。

查询参数

accountNumber*string

账户号码。长度 16

currency*string

ISO 4217 货币代码。长度 3

startDate*string

开始日期。格式 yyyyMMdd,长度 8

endDate*string

结束日期。格式 yyyyMMdd,长度 8

pageToken?string

分页令牌,翻页使用。长度 50

currentPage*integer

当前页码,起始页为 1

pageSize*integer

每页记录数,最大 100

Header 参数

X-Channel-Provider*string

渠道提供商标识,如 GLDB

响应体

返回交易记录。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?

业务数据基类字段。所有业务响应的 data 对象中都包含这些字段(手续费预估除外)。

请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/payments/transaction/history?accountNumber=10000000001&currency=SGD&startDate=20240213&endDate=20240426&currentPage=1&pageSize=20' \  -H 'X-Channel-Provider: GLDB'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "a1b2c3d4-e5f6-7890",  "data": {    "providerStatusCode": "000000",    "providerMessage": "ok",    "providerRequestSerialNo": "795883203712778240",    "providerResponseSerialNo": "785957885476737024",    "providerTimestamp": "2023-05-17 21:03:48",    "totalRecords": 12,    "pageToken": "202411153825756049.01,6",    "records": [      {        "transactionReference": "FT24320XW3NC",        "transactionDate": "2024-11-15",        "transactionTime": "09:33",        "currency": "SGD",        "balance": "31900312.79",        "amount": "-31",        "remarks": "To Acc.No.- 10000000002",        "valueDate": "2024-11-15",        "transactionDescription": "Transfer Out",        "transactionType": "213",        "direction": "OUTGOING"      }    ]  }}