Get Card Transactions

This interface is used to get the transaction details of a card in a specific date range. Date range is up to three months.

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

• 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
username	string	YES	Unique username of the account.
kit_number	string	YES	Show on card
start_date	string	YES	This field is the start date for filtering transactions data.Format: YYYY-MM-DD.
end_date	string	YES	This field is the end date for filtering transactions data.Cannot be 3 months later than start_date.Format: YYYY-MM-DD.
sign	string	YES	sign: MD5(api_key+username+timestamp+secret+request_id)lowercase hex

• Example

  {
    api_key: 'fd01a53d7834b06c080cd1024ae9c60a',
    request_id: '0f817ab66154454fadeea20ae2bfecc2',
    timestamp: '1682075328711',
    username: 'lili111',
    kit_number: '2000001791317913',
    start_date: '2023-01-02',
    end_date: '2023-05-02',
    sign: '90f158bc350412a421891aead6abe553'
  }

  signature example:MD5(fd01a53d7834b06c080cd1024ae9c60alili111168207532871116388ce4331b35e8e0d32777ba57d7d90f817ab66154454fadeea20ae2bfecc2)

• Response

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

details

Key	Type	Comments
list	array[object details]	Transaction list

object details

Key	Type	Comments
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": {
      "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 PURCHASE",
        "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"
      }]
    }
  }