# 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

```
```

```json
{
  "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

```
```

```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 | 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          |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://prepaidify.gitbook.io/docs/physical-card/api-integration/bank-card-transaction-details-query.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.