Bank Card Authorized Transaction Details

POST Bank Card Authorized Transaction Details

POST /api/mastercard/masterCardAuthTradeList.html

Retrieve authorized transaction details for a bank card.

Request Body

JSON

{
  "beginDate": "2023-07-01",
  "cardId": "card123",
  "cardNo": "**** **** **** 1234",
  "currency": "EUR",
  "endDate": "2023-07-31",
  "maxSize": 10,
  "randomStr": "abcdef1234567890",
  "start": 0
}

Request Parameters

Name	Type	Required	Base64 Encoding	Field Name	Description
cardId	string	false	none	Card token	At least one of card token and card number is required.
cardNo	string	false	none	Card number	At least one of card token and card number is required.
currency	string	false	none	Transaction currency	Transaction currency EUR/USDT
beginDate	string	true	none	Start date	Transaction start date (yyyy-MM-dd) (maximum interval between start and end date is 30 days)
endDate	string	true	none	End date	Transaction end date (yyyy-MM-dd)
start	integer	true	none	Start index for pagination	Start index for pagination, starts from 0 by default.
maxSize	integer	false	none	Maximum number of records per page	Maximum number of records per page, default is 10, maximum is 30.
randomStr	string	true	none	Random string	32-character random string.

Example Response

200 Response

JSON

{
    "total": 0,
    "tradeList": [
      {
        "cardNo": "string",
        "currency": "string",
        "amount": 0,
        "fee": 0,
        "currencyTxn": "string",
        "txnAmount": 0,
        "businessDate": "string",
        "tradeId": "string",
        "authCode": "string",
        "tradeType": 0,
        "tradeStatus": 0,
        "remark": "string"
      }
    ]
}

Response Fields

Name	Type	Required	Constraints	Field Name	Description
total	integer	true	none	Total transactions	Total number of transactions within the specified date range.
tradeList	array	true	none	Transaction list
cardNo	string	true	none	Card number	Abbreviated card number (first 6 digits and last 4 digits).
currency	string	true	none	Currency	none
amount	number	true	none	Transaction amount	none
fee	number	true	none	Transaction fee	none
currencyTxn	string	true	none	Actual transaction currency	none
txnAmount	number	true	none	Actual transaction amount	none
businessDate	string	true	none	Business date	none
tradeId	string	true	none	Transaction ID	none
authCode	string	true	none	Authorization code	none
tradeType	integer	true	none	Transaction type	150: Authorization, 151: Payment, 100: Top-up, 110: Withdrawal, 120: Transfer In, 121: Transfer Out, 200: Settlement Adjustment, 300: Balance Inquiry, 500: Fee
tradeStatus	integer	true	none	Transaction status	Returns only successful and refund transactions by default (1 and 10). 1: Success, 2: Reversal, 3: Reversed, 6: Voided, 7: Void, 10: Refund
remark	string	true	none	Transaction merchant description	none