概述

该接口用于根据客户标识或卡片标识查询交易报文记录，支持分页查询及按时间范围筛选，方便商户进行交易追踪、问题排查、对账及交易分析。

查看Network Messages

Request

cURL -X POST /card-api/v1/network-messages
-H 'Content-Type: application/json'
-H 'Authorization: {token}'
-d '{
	  "cursor": "2090383903844655104",
	  "from_time_at": "",
	  "to_time_at": "",
	  "account_id": "",
	  "limit": "10",
	  "ascending": false,
	  "card_id": ""
    }

参数名	类型	长度	是否必填	描述
cursor	string	1	否	分页游标
from_time_at	string	20	否	起始时间 ISO 8601格式的日期时间
to_time_at	string	20	否	结束时间 ISO 8601格式的日期时间
account_id	string	20	否	账户ID
card_id	string	20	否	卡片ID
limit	int	20	否	每页返回的最大结果数，范围 1–500，默认100
ascending	boolean	10	否	是否按升序返回结果，默认 false（降序）

Response

{
    "code": "200",
    "msg": "操作成功",
    "trace_id": "13589f115bd54f4fb14db78c6d623a9d",
    "data": {
        "data": [
            {
                "mcc": "6060",
                "program_value": 6,
                "card_number": "6420738445328832472",
                "creation_time": "2025-01-20T18:30:56+08:00",
                "transaction_id": null,
                "transaction_amount": 0.20,
                "transaction_currency": "USD",
                "billing_amount": 0.20,
                "billing_currency": "USD",
                "whether_reversal": "FALSE",
                "response_code": "57",
                "store_name": "401 Congress",
                "store_city": "Tokyo",
                "store_country_code": "JP",
                "transaction_source": "5",
                "transaction_type": "3",
                "failed_param": "blocked_countries",
                "modified_time": "2025-01-20T18:30:56+08:00",
                "replacement_amounts": null,
                "account_id": "1016X10007749180967",
                "parent_account_id": null,
                "card_id": null,
                "auth_released_time": null,
                "relate_trnx_id": null,
                "trnx_status": "DECLINED"
            },
            {
                "mcc": "6060",
                "program_value": 6,
                "card_number": "6420738445328832472",
                "creation_time": "2025-01-20T18:19:15+08:00",
                "transaction_id": null,
                "transaction_amount": 0.10,
                "transaction_currency": "USD",
                "billing_amount": 0.10,
                "billing_currency": "USD",
                "whether_reversal": "FALSE",
                "response_code": "57",
                "store_name": "401 Congress",
                "store_city": "Tokyo",
                "store_country_code": "JP",
                "transaction_source": "5",
                "transaction_type": "3",
                "failed_param": "blocked_countries",
                "modified_time": "2025-01-20T18:19:15+08:00",
                "replacement_amounts": null,
                "account_id": "1016X10007749180967",
                "parent_account_id": null,
                "card_id": null,
                "auth_released_time": null,
                "relate_trnx_id": null,
                "trnx_status": "DECLINED"
            },
        ],
        "next_cursor": null,
        "has_more": false
    }
}

参数名	类型	描述
mcc	string	MCC商户类别码
program_value	int	Program枚举值
card_number	string	卡号
creation_time	string	创建时间
transaction_id	string	交易ID
transaction_amount	string	交易金额
transaction_currency	string	交易币种，ISO 4217货币代码
billing_amount	string	持卡人记账金额
billing_currency	string	持卡人记账币种
whether_reversal	boolean	是否撤销 TRUE FALSE
response_code	string	响应代码
store_name	string	店铺名称
store_city	string	店铺城市
store_country_code	string	店铺国家代码，ISO 3166国家代码
transaction_source	string	交易来源名称
transaction_type	string	交易类型名称
failed_param	string	交易错误风控参数
modified_time	string	记录更新时间
replacement_amounts	string	替换金额信息
account_id	string	账户ID
parent_account_id	string	父级账户ID
card_id	string	卡片ID
auth_released_time	string	授权释放时间
relate_trnx_id	string	关联交易ID
trnx_status	string	交易状态 PROCESSED APPROVED DECLINED