💻
Docs
  • Introduction
  • VIRTUAL CARD
    • Page Integration
      • Quick Page Integration
      • Login-free Page Integration
      • About The Sign
      • Explanation of Return Codes
    • API Integration
      • Things Need To Know
      • About The Sign
      • API For Fetching Usable Card Segments
      • API For Retrieve Enumerations Of The States In The United States
      • API For Creating Virtual Card
      • API For Virtual Card Deposit (recharge)
      • API For Obtaining Card Details
      • API For Updating Virtual Card (update cardholder address)
      • API For Card Refund
      • API For Deleting Card
      • API For Querying Order History
      • Successful card opening callback
      • Fail card opening callback (COPY)
      • Risk Control webhook
      • Error Code
  • Physical card
    • Page Integration
      • Page customization
    • API Integration
      • Create Cardholder
      • Modify Cardholder Information
      • Cardholder Document Upload
      • Cardholder Query
      • Bank Card Application
      • Bank Card Application Result Query
      • Bank Card Activation
      • Bank Card Top-up
      • Bank Card Top-up Order Query
      • Bank Card Query
      • Bank Card Transaction Details Query
      • Bank Card Replacement
      • Bank Card Unloss
      • Bank Card Password Retrieval
      • Bank Card Authorized Transaction Details
      • Partner Account Balance Inquiry
      • Partner Top-up Account Information Inquiry
      • Cardholder Audit Result Notification
      • Bank Card Transaction Notification
  • KYC Sharing API
    • Integration Options
    • Signature Description
    • API
      • Submit basic information
      • Upload photo
      • Submit for approval
      • Query Approval Results
      • Approval Results[Webhook]
Powered by GitBook
On this page
  1. Physical card
  2. API Integration

Bank Card Transaction Details Query

POST Bank Card Transaction Details Query

POST /api/mastercard/masterCardTradeList.html

Bank card transaction details query: Maximum 30 records, default 10. Start is the starting line number, starting from 0 by default.

Request Body

{
  "beginDate": "2023-07-01",
  "cardId": "card123456",
  "cardNo": "1234567890",
  "currency": "EUR",
  "endDate": "2023-07-31",
  "maxSize": 10,
  "randomStr": "abcdef1234567890",
  "start": 0,
  "tradeStatus": "ALL",
  "tradeType": 120
}

Request Parameters

Name
Type
Required
Base64 Encoded
Field Name
Description

cardId

string

false

none

card token

cardId or cardNo must be filled in at least

cardNo

string

false

none

card number

cardId or cardNo must be filled in at least

tradeStatus

string

false

none

transaction status

Query all successful transactions, fixed value: ALL (If not passed, it defaults to query the final successful transaction, including successful and returned transactions with tradeStatus = 1 or 10)

currency

string

false

none

transaction currency

Transaction currency, EUR/USDT by default: EUR

beginDate

string

true

none

begin date

Start date of the transaction (yyyy-MM-dd) (The maximum interval between start and end dates is 30 days)

Example Response

200 Response

{
    "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
Constraint
Field Name
Description

total

integer

true

none

Total Transactions

Total Number of Transactions within Date Range

tradeList

array

true

none

Transaction List

Transaction Details List

The parameters contained in the tradeList are as follows:

Name
Type
Required
Constraint
Description

cardNo

string

true

none

Card number

currency

string

true

none

Currency

amount

number

true

none

Transaction amount

fee

number

true

none

Transaction fee

currencyTxn

string

true

none

Actual transaction currency

txnAmount

number

true

none

Actual transaction amount

businessDate

string

true

none

Business date

tradeId

string

true

none

Trade ID

authCode

string

true

none

Authorization code

Last updated 1 year ago