Get Card Transaction Of Cards

This API is used to get the transaction details of multiple cards within a specific time range. If no card is specified, get the transaction details of all cards within a specific time range.The API is paginated, and each page can return up to 1,000 transactions.

• Path: /api/v1/mastercardService/virtualCard/getAllTransactionsOfCards

• Method: POST

• Content-Type

  application/json

• Headers

Key	Type	Required	Comments
authorization	string	YES	Authorization Header

• Body

Key	Type	Required	Comments
api_key	string	YES	api key
request_id	string	YES	Unique id; the shortest is 20 characters, the longest is 64 characters
timestamp	string	YES	13-digit; Valid for plus or minus 30 seconds
kit_numbers	Array	Optional	Show on card.The maximum length of the array is 200. If not passed, return all card transactions
page	int	YES	Pagination, starting from 1, default 1. 1000 Transactions per page.
start_time	string	YES	This field is the start timestamp(13-digit) for filtering transactions data.
end_time	string	YES	This field is the start timestamp(13-digit) for filtering transactions data.
sign	string	YES	sign: MD5(api_key+timestamp+secret+request_id)lowercase hex

• Example

  {
    api_key: 'fd01a53d7834b06c080cd1024ae9c60a',
    request_id: '0f817ab66154454fadeea20ae2bfecc2',
    timestamp: '1682075328711',
    kit_numbers: ['2000001791317913'],
    page: 1,
    start_time: '1691076512020',
    end_time: '1691076568626',
    sign: '786b0623ead8c40049265e03497af503'
  }

  signature example:MD5(fd01a53d7834b06c080cd1024ae9c60a168207532871116388ce4331b35e8e0d32777ba57d7d90f817ab66154454fadeea20ae2bfecc2)

• Response

Key	Type	Comments
code	number	Response code
msg	string	Response message
data	object	details

details

Key	Type	Comments
hasMore	bool	Is have more transactions within a specific time range
total	number	The total number of transactions in the specified time range
list	array[object details]	Transaction list

object details

Key	Type	Comments
kit_number	string	The card kit_number
timestamp	number	timestamp
amount	string	Transaction amount. e.g "+10.23" "-102.32"
category	string	Transaction category.CR have positive "+" amounts.DR have negative "-" amounts Appendix I: Transaction Category Example
detail	string	Transaction detail
transaction_id	string	Unique transaction id
transaction_status	number	Transaction status. 1:approved(most transactions are approved) 2:voided(transactions that are stopped by merchants). The transaction status may change from approved to voided.
origin_type	number	Transaction type. 1: Primary transaction made on any terminal or e-commerce; 2: Subsequent transaction made(fees/tax/commission) following a primary transaction
origin_id	string	The primary transaction id that triggered the subsequent transaction
txn_date	string	Transaction date
base_currency	string	Currency Code Appendix III: Currency Code

• Example

  {
    "code": 10200,
    "msg": "ok",
    "data": {
      "hasMore": false,
      "total": 1,
      "list": [{
        "kit_number": "2000001791317913",
        "timestamp": 1667970000000,
        "amount": "-0.39",
        "category": "DR FEE",
        "detail": "FX%( 264056)",
        "transaction_id": "4c26687ec8834a99a4070eed8d6165f3",
        "transaction_status": 1,
        "origin_type": 2,
        "origin_id": "11f3a183b8014053b9255a17e9bf431d",
        "txn_date": "2022-11-09",
        "base_currency": "840"
      },
      {
        "kit_number": "2000001791317913",
        "timestamp": 1667797200000,
        "amount": "-14.19",
        "category": "DR",
        "detail": "Qoo10                    SINGAPORE    SG",
        "transaction_id": "11f3a183b8014053b9255a17e9bf431d",
        "transaction_status": 1,
        "origin_type": 1,
        "origin_id": "",
        "txn_date": "2022-11-07",
        "base_currency": "840"
      },
      {
        "kit_number": "2000001791317913",
        "timestamp": 1667538000000,
        "amount": "-15.8",
        "category": "DR",
        "detail": "Grab* A-45LCLDFGWFKM     Singapore    SG",
        "transaction_id": "bf0909d3251b4dd4b3bedb5b54538149",
        "transaction_status": 1,
        "origin_type": 1,
        "origin_id": "",
        "txn_date": "2022-11-04",
        "base_currency": "840"
      },
      {
        "kit_number": "2000001791317913",
        "timestamp": 1667538000000,
        "amount": "-0.2",
        "category": "DR FEE",
        "detail": "FLAT( /** 262348)",
        "transaction_id": "811647a1b40c44c68f02fe41e2835fd7",
        "transaction_status": 1,
        "origin_type": 2,
        "origin_id": "bf0909d3251b4dd4b3bedb5b54538149",
        "txn_date": "2022-11-04",
        "base_currency": "840"
      },
      {
        "kit_number": "2000001791317913",
        "timestamp": 1667538000000,
        "amount": "-0.01",
        "category": "DR FEE",
        "detail": "TAX",
        "transaction_id": "ae735a3007e1426c9c9ab7f7ccedd0df",
        "transaction_status": 1,
        "origin_type": 2,
        "origin_id": "bf0909d3251b4dd4b3bedb5b54538149",
        "txn_date": "2022-11-04",
        "base_currency": "840"
      },
      {
        "kit_number": "2000001791317913",
        "timestamp": 1667278800000,
        "amount": "+96.03",
        "category": "CR TOP-UP",
        "detail": "",
        "transaction_id": "20fd023cd38d477291cb3b1f9897ed62",
        "transaction_status": 1,
        "origin_type": 1,
        "origin_id": "",
        "txn_date": "2022-11-01",
        "base_currency": "840"
      }]
    }
  }