交易流水查询接口

Endpoint
POST {BASE_URL}/api/v2.0/payments/transactions

查询指定日期的全部交易流水，包括当前商户所有接口(含非网关接口)支付通道的付款、退款(不含清算信息)

注意: 一笔支付订单或退款订单均可能对应多条流水记录。

Request Body
datestringREQUIRED

需要查询日期，精确到天，例如：20230516
需符合正则: ((19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01]))

pageintegerREQUIRED

指定的页码 >= 1

pageLimitintegerREQUIRED

指定的每页条数 >= 10且<= 100

transactionTypestringREQUIRED

账务类型：All（汇总）、Credit（付款）、Debit（退款）
允许值：All Credit Debit

交易流水查询Request Body
{
    "date": "string",
    "page": 1,
    "pageLimit": 10,
    "transactionType": "All"
}
Response (200 OK)
transactionsarray [object]

交易明细列表

隐藏子字段
transactions.requestIdstring

商户订单ID

transactions.transactionIdstring

交易流水号（AlphaPay平台订单ID）

transactions.amountstring

订单金额，单位为货币最小单位
需符合正则: ^\d{1,7}$

transactions.currencystring

订单币种，允许值：CAD/USD CNY

transactions.transactionTypestring

账务类型：Credit（付款）、Debit（退款） 允许值：Credit Debit

transactions.settleAmountstring

清算金额，单位为货币最小单位
需符合正则: ^\d{1,7}$

transactions.settleCurrencystring

清算币种，当前平台的币种

transactions.exchangeRatestring

交易汇率

transactions.paymentMethodstring

支付渠道，允许值：Alipay Wechat UnionPay

transactions.createTimestring <date-time>

创建时间
遵循ISO8601标准，例如：2019-05-28T12:12:12+08:00

transactions.transactionTimestring <date-time>

交易完成时间
遵循ISO8601标准，例如：2019-05-28T12:12:12+08:00

paginationobject

分页信息

隐藏子字段
pagination.pageinteger

当前页码

pagination.pageLimitinteger

当前每页条数

pagination.totalPageinteger

总页数

pagination.totalinteger

总条数

resultobject

业务结果

隐藏子字段
result.resultCodestring

业务结果码，详情查看业务结果码 (resultCode)

result.resultMessagestring

业务结果消息

result.resultStatusstring

业务结果状态，详情查看业务结果状态 (resultStatus)

  • S：接口调用成功
  • F：接口调用失败，resultMessage会有详细的错误信息描述，可能是商户也可能是平台的错误。
  • U：业务结果未知或处理中间状态。比如提交支付单后得到 PAYMENT_IN_PROCESS，则需要调用查询接口确认支付结果状态
交易流水查询Response
{
    "transactions": [
        {
            "requestId": "string",
            "transactionId": "string",
            "amount": "string",
            "currency": "CAD",
            "transactionType": "Credit",
            "settleAmount": "string",
            "settleCurrency": "CAD",
            "exchangeRate": "string",
            "paymentMethod": "Alipay",
            "createTime": "2019-08-24T14:15:22Z",
            "transactionTime": "2019-08-24T14:15:22Z"
        }
    ],
    "pagination": {
        "page": 0,
        "pageLimit": 0,
        "totalPage": 0,
        "total": 0
    },
    "result": {
        "resultCode": "string",
        "resultMessage": "string",
        "resultStatus": "S"
    }
}