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"
}