Overview

This API is used to query transaction message records by customer identifier or card identifier. It supports pagination and time-range filtering, enabling merchants to retrieve transaction message records for transaction tracking, troubleshooting, and payment issue analysis.

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

Parameter	Type	Length	Required	Description
cursor	string	1	Optional	Pagination cursor
from_time_at	string	20	Optional	Start time of the query range. ISO 8601 date-time
to_time_at	string	20	Optional	End time of the query range. ISO 8601 date-time
account_id	string	20	Optional	Account ID
card_id	string	20	Optional	Card ID
limit	int	10	Optional	Maximum number of results returned per page. The range is 1–500, with a default value of 100.
ascending	boolean	10	Optional	Whether to return results in ascending order. The default is false (descending order).

Response

{
    "code": "200",
    "msg": "SUCCESS",
    "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
    }
}

Parameter	Type	Description
mcc	string	Merchant Category Code (MCC)
program_value	int	Program enumeration value
card_number	string	Card number
creation_time	string	Creation time
transaction_id	string	Transaction ID
transaction_amount	string	Transaction amount
transaction_currency	string	Transaction currency. ISO 4217 currency code.
billing_amount	string	Cardholder billing amount
billing_currency	string	Cardholder billing currency
whether_reversal	boolean	Indicates whether the transaction has been reversed. TRUE FALSE
response_code	string	Response code
store_name	string	Merchant/store name
store_city	string	Merchant/store city
store_country_code	string	Merchant/store country code. ISO 3166 country code.
transaction_source	string	Transaction source
transaction_type	string	Transaction type
failed_param	string	Risk control parameter that caused the transaction to fail
modified_time	string	Last modified time of the record
replacement_amounts	string	Replacement amount information
account_id	string	Account ID
parent_account_id	string	Parent account ID
card_id	string	Card ID
auth_released_time	string	Authorization release time
relate_trnx_id	string	Related transaction ID
trnx_status	string	Transaction status PROCESSED APPROVED DECLINED