2.1.23单张卡账单查询-v2

接口地址:/v2/openapi/card/transaction/record

请求方式:POST

请求数据类型:application/json

响应数据类型:application/json

接口描述:

此接口是2.1.9接口的升级版本

接口变动:返回参数中增加卡mc_trade_no字段,posting_date和transaction_date格式改为精确到秒的时间戳

交易有状态,如果查询到的交易数据不是最终状态,商户需要在再次收到此卡片的交易通知后再次查询交易数据,以便更新状态。

请求示例:

{
  "card_id": "00003454323400000028888",
  "end_time": "102022",
  "start_time": "012022"
}

请求参数:

参数名称 数据类型 是否必须 参数说明
card_id string true 卡ID:分配的银行卡ID
end_time string true 结束月份;指定查询的结束月份(格式“MMyyyy”);与开始月份的间隔不超过6个月
start_time string true 开始月份;指定查询的开始月份(格式“MMyyyy”)

响应参数:

参数名称 类型 参数说明
code string 错误码
data array 响应数据
  bank_tx_list array 交易列表
    credit string 存入金额
    debit string 消费金额
    description string 交易描述
    fee string 手续费,只有部分卡有值
    posting_date string 交易提交日期;精确到秒的时间戳
    transaction_date string 交易日期;精确到秒的时间戳
    tx_amount string 实际交易货币的交易金额
    tx_currency string 实际交易货币
    tx_id string 交易ID
    type integer 交易类型
    status integer 交易状态
    mc_trade_no string 交易流水;只有您主动发起的卡片交易才有此值,例如充值
  month_year string 日期,MMyyyy
  statement_cycle_date string 报表生成日期;ddMMyyyy
msg string 错误信息

响应示例:

{
  "code": "00000",
  "data": [
    {
      "bank_tx_list": [
        {
          "credit": 2.5,
          "debit": 2.5,
          "description": "MONTHLY FEE",
          "fee": 0,
          "posting_date": "1595497477",
          "transaction_date": "1595497477",
          "mc_trade_no": "48d2741747a4493223feb22",
          "tx_amount": 2.5,
          "tx_currency": "usd",
          "tx_id": 54675678678,
          "type": 1
        }
      ],
      "month_year": "022020",
      "statement_cycle_date": "28/11/2019"
    }
  ],
  "msg": "ok"
}
Copyright © HyperCard 2023 all right reserved,powered by GitbookUpdate Time: 2025-01-14 15:38:46

results matching ""

    No results matching ""